Skip to content
WolfWave

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.

Install in 2 minutes

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.

  1. Open the .dmg you just downloaded.
  2. Drag WolfWave into Applications.
  3. Launch it from Spotlight or Launchpad.

For developers who want one-command installs and brew upgrade.

brew install --cask mrdemonwolf/den/wolfwave

Updates come through Homebrew. The in-app Sparkle updater is off in this mode.

brew upgrade --cask wolfwave

WolfWave is signed and notarized by Apple. No security warnings, no right-click "Open Anyway" dance.

First 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 URL, and paste it into OBS as a Browser Source. The URL already includes your private access token.

Preferences

Tweak the small stuff. Launch at login, song-change notifications, and other handy toggles.

Apple Music Access

Click OK when macOS asks. This 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.

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.


Love it? Sponsor WolfWave on GitHub →

On this page