Installation
Download and set up WolfWave on your Mac
Get WolfWave running on your Mac in minutes.
Download
Download the latest DMG from the GitHub Releases page.
WolfWave requires macOS 15.0 or later.
Install
- Open the downloaded
.dmgfile - Drag WolfWave to your Applications folder
- Eject the DMG
First Launch
- Open WolfWave from your Applications folder
- The onboarding wizard will guide you through initial setup
- WolfWave will appear in your menu bar once setup is complete
WolfWave is signed and notarized by Apple — no Gatekeeper warnings on first launch.
Onboarding Wizard
On first launch, WolfWave walks you through everything you need:
Grant Permissions
WolfWave needs permission to read your Apple Music playback:
- When prompted, click OK to allow Apple Music access
- If not prompted, go to System Settings → Privacy & Security → Automation
- Enable WolfWave → Music
Connect Twitch (Optional)
To enable chat commands like !song:
- Click Connect with Twitch in the onboarding wizard
- Follow the device authorization flow in your browser
- Return to WolfWave — you're connected!
Enable Discord Rich Presence (Optional)
To show what you're listening to on your Discord profile:
- Enable Discord Rich Presence in the onboarding wizard
- Make sure Discord is running on your Mac
- WolfWave will connect automatically
You'll need a Discord Application ID from the Discord Developer Portal. See the Usage Guide for setup details.
Configure WebSocket (Optional)
To stream now-playing data to overlays:
- Enter your WebSocket endpoint URL
- Add JWT token if required
- Enable the connection
You're Ready!
WolfWave is now tracking your Apple Music playback. Your viewers can use:
!song— Shows the current track!currentsong— Shows the current track!nowplaying— Shows the current track!lastsong— Shows the previous track!last— Shows the previous track!prevsong— Shows the previous track