Skip to main content

Built-in command reference

These 20 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

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