Skip to main content

Built-in command reference

These 21 commands are shipped with AveloBot. Defaults shown below — every property (trigger, aliases, permission, cooldowns) can be overridden 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

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. AveloBot 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

Spotify​

These commands require Spotify to be connected. The song-request commands additionally read the per-channel Song Requests settings (mode, length cap, blacklist, …) — see the integration page for the full picture.

!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

!playlist​

Shows the streamer's currently active Spotify playlist, if any.

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

!sr <input>​

Requests a song. Input can be a Spotify track URL (https://open.spotify.com/track/…), a Spotify URI (spotify:track:…), or free-text in the form Artist - Title. Free-text first tries a structured search, then falls back to a generic one.

In playlist mode the track is appended to the active saved playlist. In queue mode it's added to Spotify's player queue.

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

!nexttracks​

Shows the next 3 upcoming tracks. In playlist mode, reads from the active playlist (skipping past whatever is currently playing if it's in there). In queue mode, reads Spotify's live player queue.

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

!skip​

Skips to the next track on Spotify. Requires an active Spotify device.

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

!playsong​

Resumes Spotify playback. Requires an active Spotify device.

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

!stopsong​

Pauses Spotify playback. Requires an active Spotify device.

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