Bot Commands
Full !song, !sr, !queue, !skip, and vote-to-skip command reference for WolfWave. With cooldowns, permissions, and channel-point and bits redemptions.
Connect your Twitch account and these commands are ready to go. Song requests are on out of the box; most other commands start off until you enable them in Settings → Twitch → Bot Commands. Replies cap at 500 characters, and an optional global gate keeps all commands quiet unless you're live.
Current Song
Replies with what you're playing right now. Off by default.
| Command | Description |
|---|---|
!song | Now Playing info |
!currentsong | Now Playing info |
!nowplaying | Now Playing info |
Last Song
Replies with the last track you finished. Off by default.
| Command | Description |
|---|---|
!last | Previously Played info |
!lastsong | Previously Played info |
!prevsong | Previously Played info |
Song Requests
Viewers add tracks to your queue; mods get the controls. !sr is on by default and audience-gated, so you pick who can request. Queue behavior — fair-share ordering, approval screening, Sub/VIP priority — is covered in Song Requests.
| Command | Who | What it does |
|---|---|---|
!sr / !request / !songrequest <query> | Everyone (audience-gated) | Request a track by name, or by an Apple Music, Spotify, or YouTube link. On by default |
!queue / !songlist / !requests | Everyone | Show how many tracks are queued. On |
!myqueue / !mysongs | Everyone | Show your own pending requests. On |
!skip / !next | Mods + broadcaster | Skip the current song. On |
!hold / !resume / !unhold | Mods + broadcaster | Pause and resume new requests. Always available |
!clearqueue / !cq | Mods + broadcaster | Wipe the entire queue. On |
!playlist | Everyone | Link your WolfWave Requests playlist. Off by default |
Configure the queue, blocklist, and which commands are enabled in Settings → Song Requests.
!playlist needs one-time setup (Settings → Song Requests → Set Up) because macOS can't share a playlist for you. If you later delete or un-share the playlist, WolfWave turns the command off so chat never gets a dead link. Details in Song Requests.
Vote-Skip
Chat votes a track off together — no mod needed. The whole feature is off by default; turn it on in Settings → Song Requests → Chat Vote-Skip.
| Command | Who | What it does |
|---|---|---|
!voteskip | Everyone (or subs-only) | Cast a vote to skip the current song |
!vs | Everyone (or subs-only) | Short alias for !voteskip |
Enough votes within the time window skips the song — the queued request if one is playing, otherwise the current Apple Music track. If the window runs out first, the song stays.
Two ways to run a vote:
- Chat tally.
!voteskipvotes are counted until the minimum is reached. - Twitch Polls. A mod's
!voteskipopens a native Twitch poll (Affiliate/Partner only).
Minimum votes, vote window, cooldown, and subscriber-only voting all live in the same Settings pane.
Live Stats
Viewers pull your listening stats on demand. Off by default; needs the opt-in Listening History plus the command enabled in Settings → History & Stats.
| Command | Who | What it does |
|---|---|---|
!stats / !musicstats | Everyone | Replies with your listening stats for the window you picked in Settings |
Windows: Today (default), This stream, Last 7 days, or All time. Pick any mix of play count, listening time, top track, and top artist; a live preview in Settings shows the exact reply.
!stats only replies while your stream is online. Offline, it stays quiet — that's by design, not a bug.
About WolfWave
A one-tap shoutout for the app. Off by default; enable it and pick a reply in Settings → Twitch → Bot Commands.
| Command | Who | What it does |
|---|---|---|
!wolfwave | Everyone | Replies with what WolfWave is and where to get it |
Four ready-made replies, each crediting MrDemonWolf and linking to the site:
- Credit + maker (default). Names the app, the maker, and what it does.
- Viewer how-to. Points viewers at
!song,!last, and!sr. - Open-source pitch. Leads with free and open source for other streamers.
- Short & friendly. A one-liner plus the link.
Cooldowns and custom aliases live in the same pane.
Channel Points & Bits
Two more ways for viewers to add a track, no command needed. Both feed the same queue, blocklist, and audience rules as !sr.
- Channel Points. Viewers redeem the WolfWave-managed "Request a Song" reward; it acts like a
!srfrom that viewer. - Bit Boost. A viewer cheers bits and their most-recent queued request jumps to the front.
Enable both from Settings → Song Requests → Channel Points & Bits (Twitch Affiliate or Partner required). Reward management and the fine print are in Channel points and bits.
Custom Commands
Build your own chat commands in Settings → Twitch → Custom Commands. Give each one a trigger, a reply, and pick who can use it. Aliases and cooldowns work just like the built-ins.
Variables fill in when the command runs:
| Variable | Fills in with |
|---|---|
$user, $sender | The name of whoever ran the command |
$touser | The first word they typed (a leading @ is stripped), or their own name if they typed nothing |
$args | Everything they typed after the command |
$1–$9 | A single word by position |
$song | Your current track |
$lastsong | The track you played before it |
Example. Trigger !hug, reply $user gives $touser a big hug!. A viewer types !hug @Luna and chat sees MrDemonWolf gives Luna a big hug!.
Who can use it. Set each command to Everyone, Subscribers, VIPs, Moderators, or Broadcaster only. More privileged viewers always clear a lower bar (a mod passes a Subscribers-only command).
No two commands can answer the same word. The editor rejects a trigger or alias another custom command already uses, so one of the pair can never be left dead. Cooldowns are limited to what the sliders set: up to 30s for Everyone and 60s per person, in 5s steps.
Custom commands travel with your settings backup. A backup holding a command that breaks either rule is refused rather than partly imported.
Custom Aliases
Supported commands take comma-separated aliases. Add np, track to !song and viewers can use !np or !track too.
| Command | Where to set |
|---|---|
!song | Settings → Twitch → Bot Commands |
!last | Settings → Twitch → Bot Commands |
!wolfwave | Settings → Twitch → Bot Commands |
!stats | Settings → History & Stats → !stats Twitch command |
!sr, !queue, !myqueue, !skip, !clearqueue, !voteskip, !playlist | Settings → Song Requests |
Aliases honor the same enable, cooldown, audience, and live-gate rules as the canonical command. The ! prefix is added for you. !hold and !resume are fixed — no custom aliases.
An alias that shadows another custom command's trigger or alias is refused. If you saved one before WolfWave checked for this, it gets dropped the next time your commands load, and the command it was shadowing keeps working.
Cooldowns & Spam
Set Global and Per-User cooldowns in Settings to keep chat clean.
- Global Cooldown (default 15s): how long everyone waits between commands.
- User Cooldown (default 15s): how long one person waits after using a command.
Mods and the broadcaster always bypass cooldowns. The optional Sub/VIP priority perk (cooldown skip, plus an optional queue jump) is song-request behavior — see Song Requests.
Install
Download WolfWave free for macOS 26+ on Apple Silicon. Install the signed .dmg or run `brew install --cask mrdemonwolf/den/wolfwave`. Free Apple Music bot for Twitch.
Settings
Every WolfWave settings pane in one place. General, Song Requests, Stream Widgets, History and Stats, Twitch, Discord, Software Update, Advanced, and About.