Bot Commands

This page has two parts.

• Watching a stream? Read What can I type in chat?. It lists every command and what happens.
• Streaming? Read For streamers. It shows how to turn commands on, set cooldowns, and make your own.

---

What can I type in chat?Copy Anchor Link

The streamer uses WolfWave to share their Apple Music in Twitch chat. Type a command as the first word of your message. Capitals don't matter.

Not every command is on for every stream. The streamer picks which ones work. If nothing happens, the command is probably off, on cooldown, or you're not allowed to use it.

See what's playingCopy Anchor Link

• A paused song shows as ⏸️ Paused: instead of ▶️ Playing:.
• Some streamers add a song.link URL so you can open the song on any music service.

Request a songCopy Anchor Link

Type !sr followed by a song name or a link.

The bot replies with one of these:

• Added. Added "Howl at the Moon" by Gray Wolf, #3 in queue
• Waiting for the streamer. Sent "…" to the streamer for approval. The streamer screens requests first.
• Not found. No results for "…". Try a different search! Try fewer words, or add the artist.
• Blocked. Sorry, that song/artist is on the blocklist.
• Too many. You already have 2 songs queued. Wait for one to play! (the number is set by the streamer)
• Full. Queue is full (10/10). Try again later!
• Duplicate. That song is already in your queue.
• Not allowed. For example Song requests are subscriber-only right now.

Links that work:

• Apple Music: a song link, or an album link that points at one track.
• Spotify: a track link (open.spotify.com/track/… or spotify.link).
• YouTube: a video link (youtube.com/watch, music.youtube.com, or youtu.be).

Check the queueCopy Anchor Link

Vote to skip a songCopy Anchor Link

If the streamer turned on vote-skip, chat can skip a song together.

1. Someone types !voteskip (or !vs). A vote starts.
2. Others type !voteskip too. Each person counts once.
3. Enough votes in time skips the song. If time runs out, the song stays.

The bot shows the count, like 🗳️ 2/3 votes to skip this song.

Some streamers use Twitch Polls instead. Then only the streamer or a mod can start the vote with !voteskip, and everyone votes in the Twitch poll. The song is skipped when "skip" wins and has at least the minimum number of votes.

After a vote ends, there's a short wait before the next one can start.

Use channel points or BitsCopy Anchor Link

Some channels let you request without typing a command.

• Channel points. Redeem the Request a Song reward and type a song name or link in the box. If the request fails (not found, blocked, queue full), your points are refunded.
• Bits. Cheer at least the streamer's minimum and add a song name in the same message. Example: Cheer100 Howl at the Moon. Bits can't be refunded, so double-check the song name.
• Bits boost. If the streamer turned it on, a cheer moves your oldest queued song to the front instead of adding a new one. If you have nothing queued, your cheer's song name is requested instead.

Channel points and Bits need those tools enabled on the channel and the API access WolfWave uses. Availability depends on Twitch's eligibility and onboarding requirements; basic !sr requests don't need either tool. See the FAQ.

Who can use whatCopy Anchor Link

Why didn't the bot answer?Copy Anchor Link

• Cooldown. Each command has a short wait between uses, for the whole chat and for each person. The bot stays quiet until it's over. Mods and the streamer skip cooldowns.
• The command is off. The streamer chose not to use it.
• The stream is offline. Some streamers set every command to work only while live.
• It wasn't the first word. hey !song won't work. !song will.

---

For streamersCopy Anchor Link

Everything below is set up in WolfWave's Settings window. Commands only work after you connect Twitch.

Turn commands onCopy Anchor Link

!song and !last are ready on a new install. Most other commands start off. Turn on the ones you want.

Song requests have a master switch: Enable Song Requests in Settings → Song Requests. It's off until you turn it on. The first time, Set up Song Requests walks you through it. Details are in Song requests.

Only reply while live. In Settings → Twitch → Chat commands, this one switch keeps every command quiet until your stream goes live. It's off by default, so commands reply anytime.

What the mod commands doCopy Anchor Link

• !skip / !next plays the next request. Chat sees the new song. If the queue is empty, it says Skipped. Queue is now empty. If Music is busy, it says Couldn't skip right now, try again.
• !clearqueue / !cq removes every request and empties the shared WolfWave Requests playlist. Songs stay in your Apple Music library; the !playlist link is empty until new requests arrive.
• !hold pauses request playback. New requests still join the queue but don't play. !resume or !unhold starts them again. This is the same as the Hold Queue switch.

Who can requestCopy Anchor Link

Set this in Settings → Song Requests → Who Can Request. Pick a preset:

• Mods and you can always request.
• The audience only limits !sr. Channel points and Bits accept anyone who pays.
• A viewer who isn't allowed gets a short "not allowed" reply. That reply is rate-limited, and it never starts the !sr cooldown for everyone else.
• Reply When Off makes !sr say "Song requests are off right now." while requests are off. Off by default, so !sr stays silent.
• Require My Approval holds every request until you approve or decline it.

Channel points and BitsCopy Anchor Link

Turn these on in Settings → Song Requests → Channel Points & Bits.

• Channel Point Requests. WolfWave adds a Request a Song reward to your channel. Pick the cost (default 500). Failed requests are refunded automatically.
• Bit Requests. A cheer with a song name requests it. Pick the minimum (default 100 Bits).
• Boost With Bits. A cheer moves the viewer's queued song to the front instead.

You need:

• Channel Points or Bits enabled on your channel, plus Twitch API access for the feature. If Twitch rejects setup, follow the error shown in WolfWave.
• To sign in with your broadcaster account, not a separate bot account.
• The channel-point and Bits permissions. If they're missing, WolfWave asks you to reconnect once.

Vote-skip settingsCopy Anchor Link

Settings → Song Requests → Chat Vote-Skip. Turn on Enable Vote-Skip first.

A vote skips the request playing now. If no request is playing, it skips the current Apple Music track.

!stats settingsCopy Anchor Link

In Settings → History & Stats → !stats command:

• Window: Today (default), This stream, Last 7 days, or All time. "This stream" uses Today while you're offline.
• What to show: Plays, Listening time, Top track, Top artist. Plays and Top track are on by default. At least one stays on.
• A live preview shows the exact reply.

!wolfwave reply stylesCopy Anchor Link

Pick one in Settings → Twitch → Bot Commands. Each one credits MrDemonWolf and links the WolfWave site.

• Credit + maker (default)
• Viewer how-to. Points viewers at !song, !last, and !sr.
• Open-source pitch
• Short & friendly

CooldownsCopy Anchor Link

A cooldown is how long a command waits before it answers again.

• Everyone: how long the whole chat waits after anyone uses it.
• Per person: how long one viewer waits after they use it.
• Mods and you always skip cooldowns.
• Aliases share their command's cooldown. !song and !np count as one.

Sub / VIP priority (Settings → Song Requests) can let subs and VIPs skip the !sr cooldown, or skip it and jump ahead in the queue. Off by default.

Custom aliasesCopy Anchor Link

Add extra words for a built-in command. Type them comma-separated, without !. Example: add np, track to !song and viewers can also type !np or !track.

• Aliases follow the same on/off, cooldown, audience, and live-only rules as the command.
• !hold and !resume have no aliases.

Custom commandsCopy Anchor Link

Make your own commands in Settings → Twitch → Custom Commands. Click Add command.

Each command has:

• Trigger. One word, no spaces. Like !hug.
• Aliases (optional). Extra words for the same command.
• Reply. Up to 500 characters. A counter shows how many you've used.
• Who can use it. Everyone, Subscribers, VIPs, Moderators, or Broadcaster only. Higher roles always pass a lower bar. A mod can use a Subscribers command.
• How it's sent. See the table below.
• Cooldowns. Default 15s each. Everyone up to 30s, per person up to 60s.

You can make commands before you connect Twitch. They start replying once you connect.

Variables fill in when the command runs:

Example. Trigger !hug, reply $user gives $touser a big hug!. A viewer named Luna types !hug @Fang. Chat sees Luna gives Fang a big hug!

How it's sent:

Announcements need two things:

1. The account WolfWave signed in with must be a mod in your channel. Type /mod <account> in chat if it's a separate bot account.
2. The announcements permission on your Twitch sign-in. Older sign-ins don't have it. WolfWave asks you to reconnect once.

If Twitch refuses an announcement, WolfWave sends a normal reply instead and the Custom Commands card says why.

Rules the editor checks:

• No two custom commands can use the same trigger or alias. The editor names the command that already has it.
• A trigger or alias can't have spaces. Chat only matches the first word.
• A custom command can't use a built-in trigger or alias, like !song, !sr, or an alias you added to one. The editor names the built-in. A custom command saved by an older version that does this is turned off, so the built-in answers again.

Custom commands are included in your settings backup. A backup with a broken command (a duplicate trigger, a space in a trigger, or a cooldown the sliders can't set) is refused instead of half-imported.

LimitsCopy Anchor Link

• Replies are capped at 500 characters, Twitch's limit. Longer text is cut cleanly, never mid-emoji.
• A command must be the first word of the message.

---