All systems OKView Status
// STREAMION.BOT DOCS

All about streamion.bot.

Sign-in flow, chat commands, event responses, alerts, music integrations — the full reference for your bot configuration.

Built-in command reference

These 29 commands come built into streamion.bot. The values shown below are the defaults — every property (trigger, aliases, required permission, cooldowns) can be changed per workspace on the Commands page.

General

!ping

Replies with pong to confirm the bot is online.

  • Default trigger: !ping
  • Default aliases: !p
  • Permission: Everyone
  • Cooldowns: none

!uptime

Shows how long the stream has been live, or that the channel is offline.

  • Default trigger: !uptime
  • Permission: Everyone
  • Global cooldown: 15s

!followage

Shows how long the chatter has been following the broadcaster. The broadcaster running it on themselves gets a friendly reply.

  • Default trigger: !followage
  • Default aliases: !fa
  • Permission: Everyone
  • Per-user cooldown: 30s

!viewer

Shows the current viewer count of the stream.

  • Default trigger: !viewer
  • Default aliases: !viewers
  • Permission: Everyone
  • Global cooldown: 15s

!title

Shows the current stream title.

  • Default trigger: !title
  • Permission: Everyone
  • Global cooldown: 15s

!category

Shows the current stream category (game).

  • Default trigger: !category
  • Default aliases: !game
  • Permission: Everyone
  • Global cooldown: 15s

!watchtime

Tells the caller how long they've watched the channel. Watch-time tracking must be turned on first — see Watchtime for setup and the leaderboard.

  • Default trigger: !watchtime
  • Default aliases: !wt
  • Permission: Everyone
  • Per-user cooldown: 15s

!clip

Creates a Twitch clip of the live stream and posts its link. Optionally !clip <label> to tag it. The channel must be live. See Clips for the clip list and full details.

  • Default trigger: !clip
  • Permission: Everyone
  • Global cooldown: 30s · Per-user cooldown: 60s

Channel management (Moderator only)

!settitle <new title>

Updates the stream title to whatever follows the command.

  • Default trigger: !settitle
  • Permission: Moderator
  • Cooldowns: none

!setcategory <category name>

Updates the stream category by name. streamion.bot looks the category up via Twitch.

  • Default trigger: !setcategory
  • Default aliases: !setgame
  • Permission: Moderator
  • Cooldowns: none

!announce <message>

Posts the rest of the message as a Twitch announcement (the highlighted chat box).

  • Default trigger: !announce
  • Permission: Moderator
  • Cooldowns: none

!so <user>

Triggers a native Twitch shoutout for the given user (the same shoutout that mods can do from the Twitch UI). The viewer is highlighted to your audience and may be promoted by Twitch's recommendation surfaces.

  • Default trigger: !so
  • Default aliases: !shoutout
  • Permission: Moderator
  • Cooldowns: none

Quotes

The four quote commands work together with the Quotes page.

!quote

Shows a random quote, one by number (!quote 7), or one by person (!quote Alice).

  • Default trigger: !quote
  • Default aliases: !q
  • Permission: Everyone
  • Per-user cooldown: 10s

!addquote <text>

Adds a new quote. Captures the current category as context.

  • Default trigger: !addquote
  • Default aliases: !aq
  • Permission: Moderator
  • Cooldowns: none

!delquote <number>

Deletes a quote by its number.

  • Default trigger: !delquote
  • Default aliases: !dq
  • Permission: Moderator
  • Cooldowns: none

!searchquote <text>

Searches quotes for a substring and returns matching numbers.

  • Default trigger: !searchquote
  • Default aliases: !sq
  • Permission: Everyone
  • Per-user cooldown: 15s

Music — song requests

These work with whichever music provider is active for your channel — Spotify or YouTube Music (set on Settings → Music). They read your per-channel Song Requests settings (mode, length cap, blacklist, …) — see the Spotify or YouTube Music integration page for the full picture. If no provider is connected, they reply that music requests aren't configured.

!sr <input>

Requests a song. Input can be a track link from the active provider — a Spotify track URL (https://open.spotify.com/track/…) or URI (spotify:track:…), or a YouTube / YouTube Music URL or video ID — or free-text in the form Artist - Title (a structured search first, then a generic fallback).

On Spotify, playlist mode appends the track to the active saved playlist and queue mode adds it to Spotify's player queue. YouTube Music adds to the active playlist.

  • Default trigger: !sr
  • Default aliases: !songrequest
  • Permission: Everyone
  • Per-user cooldown: 15s

!playlist

Shows the currently active request playlist (Spotify or YouTube Music), if any.

  • Default trigger: !playlist
  • Default aliases: !pl
  • Permission: Everyone
  • Global cooldown: 5s · Per-user cooldown: 10s

!nexttracks

Shows the next 3 upcoming tracks from the active playlist or queue.

  • Default trigger: !nexttracks
  • Default aliases: !queue
  • Permission: Everyone
  • Per-user cooldown: 15s

Spotify playback

These work with Spotify only (not YouTube Music) and need Spotify connected with an active Spotify device.

!song

Shows the song currently playing on the streamer's Spotify.

  • Default trigger: !song
  • Default aliases: !s
  • Permission: Everyone
  • Global cooldown: 5s · Per-user cooldown: 10s

!skip

Skips to the next track on Spotify.

  • Default trigger: !skip
  • Default aliases: !next
  • Permission: Moderator
  • Per-user cooldown: 5s

!playsong

Resumes Spotify playback.

  • Default trigger: !playsong
  • Default aliases: !play
  • Permission: Moderator
  • Per-user cooldown: 5s

!stopsong

Pauses Spotify playback.

  • Default trigger: !stopsong
  • Default aliases: !stop, !pause
  • Permission: Moderator
  • Per-user cooldown: 5s

Loyalty points

These work with the Loyalty points system and only respond while it's enabled. The two moderator commands let you adjust balances by hand.

!points

Shows the caller's current balance.

  • Default trigger: !points
  • Default aliases: !balance
  • Permission: Everyone
  • Per-user cooldown: 15s

!top

Lists the viewers with the highest balances.

  • Default trigger: !top
  • Default aliases: !leaderboard
  • Permission: Everyone
  • Global cooldown: 15s · Per-user cooldown: 15s

!shop

Lists the active shop items and their cost.

  • Default trigger: !shop
  • Default aliases: !rewards
  • Permission: Everyone
  • Global cooldown: 15s · Per-user cooldown: 15s

!redeem <item>

Spends points on a shop item. If the caller can't afford it, or names an item that doesn't exist, nothing is spent.

  • Default trigger: !redeem
  • Permission: Everyone
  • Per-user cooldown: 5s

!givepoints <user> <amount>

Grants points to a viewer.

  • Default trigger: !givepoints
  • Default aliases: !addpoints
  • Permission: Moderator
  • Cooldowns: none

!takepoints <user> <amount>

Removes points from a viewer (never below zero).

  • Default trigger: !takepoints
  • Default aliases: !removepoints
  • Permission: Moderator
  • Cooldowns: none