Usage Guide

WolfWave is user-friendly and runs from your macOS menu bar. Here's a guide to the features:

The WolfWave icon appears in your macOS menu bar. Click it to access Settings, About, or Quit.

Features

Apple Music Tracking

Toggle Apple Music tracking on/off from Settings → Music Playback Monitor. When enabled, WolfWave monitors your currently playing track in real-time using ScriptingBridge.

A live Now Playing preview card in the Music Monitor settings shows the current track, artist, and album — styled after Apple Music.

Show your now-playing track on stream with a browser source overlay:

Open Settings → OBS Widget
Enable the WebSocket server
Copy the Widget URL
In OBS, add a Browser Source and paste the URL
Set the source size to 500 × 120 for best results

The widget displays album art, track name, artist, and a progress bar. It connects to the local WebSocket server and updates in real time as your music changes.

Enable "Shutdown source when not visible" in OBS for clean reconnects when switching scenes.

Twitch Bot Integration

Connect your Twitch bot via secure device code authentication:

Open the Twitch settings
Click "Connect" to start the device auth flow
Follow the on-screen instructions to authorize
Your bot will automatically connect to your channel

Discord Rich Presence

Show what you're listening to on your Discord profile — just like Spotify, but for Apple Music.

Setup

Create a Discord application at discord.com/developers/applications
Copy the Application ID
(Optional) Upload an Apple Music logo as a Rich Presence asset named apple_music
Add the Application ID to your Config.xcconfig as DISCORD_CLIENT_ID
Enable Discord Rich Presence in Settings → Discord

What It Shows

When a song is playing, your Discord profile will display:

"Listening to Apple Music" activity status
Song title and artist name
Album name
Album artwork (fetched automatically from the iTunes Search API)
Playback progress with elapsed time and duration

Album artwork is fetched dynamically — no need to manually upload art assets to Discord. If you upload an apple_music asset to your Discord app, it will appear as a small icon alongside the album art.

Requirements

Discord must be running on your Mac
WolfWave connects automatically via Discord's local IPC socket
No bot token or server setup required

Chat Commands

Once connected, your viewers can use these commands in chat:

Command	Description
`!song`	Current playing song
`!currentsong`	Current playing song
`!nowplaying`	Current playing song
`!lastsong`	Previously played song
`!last`	Previously played song
`!prevsong`	Previously played song

Commands can be toggled on/off in Settings under "Bot Commands".

Settings

Access settings from the menu bar icon to configure:

Music Monitor: Enable/disable Apple Music tracking
OBS Widget: Enable the stream overlay WebSocket server and copy the widget URL
Twitch: Connect your Twitch account and configure the bot
Discord: Enable/disable Rich Presence and view connection status
Advanced: Software updates, reset onboarding, reset all settings

Menu Bar