How to Use

WolfWave runs itself once set up. Here's how each piece works.

The Menu Bar

WolfWave lives in your macOS Menu Bar (top-right of your screen).

• Click the wolf icon to see what's playing.
• From the menu: quick toggles, hold/resume the request queue, open Settings.

Sync Music

Flip the Sync Music switch in Settings. WolfWave instantly spots when you change a song.

Now-Playing Widget

WolfWave hosts the widget right on your Mac. No external links. No internet needed.

Auth Token

The widget is gated by a per-install token, stored in the macOS Keychain and auto-injected into the Widget Link.

• Reveal it: Eye toggle next to the token field. Hidden by default.
• Regenerate: Drops every active client. Re-copy the Widget Link into OBS afterward.
• Custom value: Edit the token field to supply your own string (handy when you want a memorable value or you're rotating after a leak).

Connecting from a second computer or phone? Use http://<your-lan-ip>:7780/?token=<token>. Both the host and the token are required.

Themes & Layouts

Pick from six themes (Default, Dark, Light, Glass, Neon, WolfWave) and three layouts (Horizontal, Vertical, Compact) in Settings → Stream Widgets.

Twitch Chat Bot

Once you're logged into Twitch (Settings → Twitch), the bot auto-connects when you open the app.

• Pick commands: Choose which ones chat can use (like !song, !last, !sr, !voteskip, !stats).
• Cooldowns: Set wait times so nobody spams.
• Mod Bypass: Mods and you can use commands as much as you want.

See the Bot Commands page for the full list, including Vote-Skip and Live Stats.

Song Requests

Open Settings → Song Requests to turn it on.

• How chat uses it: !sr <song name or Apple Music link>. WolfWave finds the track and adds it to the queue.
• Queue Panel: See every pending request right in Settings. Reorder or remove with a click.
• Hold Mode: Pause new requests when you need a break. Flip it from Settings or !hold in chat.
• Blocklist: Block specific tracks, artists, or albums you never want played.
• Quick Access: Hold/resume the queue directly from the menu bar.

Streamer Mode

Flip Streamer Mode from the menu bar's Streamer Quick Actions before you go live. WolfWave masks the connected Twitch channel name, the overlay/widget URLs, the WebSocket URI, and the auth token across every settings view. Copy/Open buttons next to masked values are disabled so screenshots can't reveal the underlying value via accessibility.

Streamer Mode is UI-only. Your WebSocket broadcast, Discord Rich Presence, and Twitch chat output keep working as usual.

Discord Status

When Discord Status is on, WolfWave updates your Discord profile to "Listening to WolfWave", with Apple Music album art and the track.

• Album Art: High-res artwork auto-fetched.
• Progress Bar: Shows where you are in the song.
• No Setup: As long as Discord is open, WolfWave finds it.

Settings

From the menu bar, open Settings to:

• Stream Widgets: Port, themes, layouts, auth token.
• History & Stats: Listening history opt-in, Stats charts, Monthly Wrap.
• Notifications: Song-change banner toggle.
• Twitch: Log in, pick commands, tweak cooldowns.
• Discord: Turn the profile status on/off.
• Song Requests: Queue, hold, blocklist.
• Advanced: Check for updates or reset the setup wizard.