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.
What you need
- macOS 26.0+ (Tahoe). Older versions won't run it.
- Apple Silicon (M1 or later). Intel Macs aren't supported.
- The Apple Music app. WolfWave reads only from Apple Music, which is built into macOS. Spotify and other players don't work.
Get WolfWave
Pick this if you're not sure. It's the normal installer, signed and notarized, so no security warnings.
- Open the
.dmgyou just downloaded. - Drag WolfWave into Applications.
- Launch it from Spotlight or Launchpad.
For developers who want one-command installs and brew upgrade.
brew install --cask mrdemonwolf/den/wolfwaveUpdates come through Homebrew. The in-app Sparkle updater is off in this mode.
brew upgrade --cask wolfwaveFirst launch
A setup wizard runs the first time you open WolfWave. It's 8 short steps. Skip any optional one and finish it later from Settings.
Welcome
A quick intro. What WolfWave does and what you're about to set up.
Discord (optional)
Sign in to your Discord desktop app. WolfWave talks to it locally. No bot token, no server to run.
Twitch (optional)
Connect your Twitch account. You're sent to twitch.tv to approve. Your login is stored safely in your Mac's Keychain.
OBS Widget (optional)
Add a now-playing overlay to OBS. Turn on the widget, copy the localhost URL, and paste it into OBS as a Browser Source. Details in the widget guide.
Preferences
Tweak the small stuff. Launch at login, song-change notifications, and other handy toggles.
Permissions
Click OK when macOS asks for Apple Music access. This one is required. It's how WolfWave reads the song that's playing.
Notifications (optional)
Pick which alerts you want: song-change banners, skip-vote started, skip-vote passed. Turn on notifications first, then choose. Skip any you don't need.
Menu Bar
Find the wolf icon. An arrow points to it, top-right of your screen.
Done
You're set. Click the wolf icon any time to see what's playing or open Settings.
Features
Every WolfWave feature and how to use it: !song chat command, song requests, channel points and bits, Discord Rich Presence, OBS overlay, Stream Deck control.
Bot Commands
Full !song, !sr, !queue, !skip, and vote-to-skip command reference for WolfWave. With cooldowns, permissions, and channel-point and bits redemptions.