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)
  • Apple Silicon (M1 or later). Intel Macs are not supported
  • Apple Music app. WolfWave only reads from Apple Music (built into macOS). Spotify and other players are not supported.

Get WolfWave

The standard installer. Signed and notarized, no Gatekeeper warnings.

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

Best for developers who want one-command installs and brew upgrade parity.

brew install --cask mrdemonwolf/den/wolfwave

Updates come through Homebrew. Sparkle's in-app updater is disabled in this install mode.

brew upgrade --cask wolfwave

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

First launch

WolfWave opens an 8-step setup wizard the first time you launch. Skip any optional step and come back later from Settings.

Welcome

Quick intro to what WolfWave does and what's about to be set up.

Discord (optional)

Sign in to your Discord desktop app. WolfWave talks to it over local IPC. No bot token, no server.

Twitch (optional)

OAuth Device Code flow. You're sent to twitch.tv to approve; tokens land in your macOS Keychain.

OBS Widget (optional)

Turn on the local widget server, copy the URL (your per-install auth token is baked in), and drop it into OBS as a Browser Source.

Preferences

Launch at login, song-change notifications, and other quality-of-life toggles.

Apple Music Access

Click OK when macOS asks WolfWave to control Apple Music. Required. This is how WolfWave reads the now-playing track.

A friendly arrow shows where the wolf icon lives. Top-right of your screen.

Done

WolfWave is running. Click the wolf icon any time to see what's playing or open Settings.


Love it? Sponsor WolfWave on GitHub →

On this page