Documentation
Install, configure, and extend the Apple Music → Twitch / Discord / OBS bridge for macOS. Free, open source, sandboxed.
Howl quietly.
Stream loud.
WolfWave bridges Apple Music to Twitch, Discord, and OBS. Press play once and it keeps them in sync. These docs cover the whole loop, from your first launch to a custom overlay over WebSocket.
Pick your path
For streamers
Install, connect Twitch, drop the overlay into OBS. Five minutes, no terminal.
For builders
Native Swift. Local WebSocket. Fork it, wire it into your own overlay or Home Assistant.
Streamers start here
Install
DMG or Homebrew. Signed and notarized.
Use it
Menu bar, widget, song requests, Streamer Mode.
Bot commands
!song, !sr, !voteskip. Every trigger.
Settings
Every pane, and what lives where.
FAQ
Spotify? Intel Mac? Second-PC OBS? Answered.
Builders start here
Architecture
MVVM + service-oriented Swift. ScriptingBridge → Apple Music.
Development
Build from source. Run the tests. Ship a PR.
OBS widget
Tailwind + TypeScript workspace. Inlined into one HTML file.
Stream Deck API
Drive playback and the queue over the overlay socket.
Security
Keychain, App Sandbox, OAuth, EdDSA-signed updates.
Most-asked topics
Open Settings → Twitch. Click Connect Twitch Account.
Authorize on twitch.tv. WolfWave uses OAuth Device Code. No password ever touches the app.
Flip on the commands you want. !song, !last, and !voteskip start off; song requests switch on after the guided setup.
Full walkthrough: Twitch chat bot setup · Every command
Settings → Stream Widgets. Click Enable Widget Server.
Copy the Widget Link. For localhost, WolfWave injects the WebSocket credential into the served HTML instead of exposing it in the URL.
Paste into OBS as a Browser Source. Size it for your layout with the canvas table.
Full walkthrough: OBS widget setup · Themes & layouts
Settings → Song Requests. Turn it on. Set who can request. Everyone, subs, mods.
Pick a preset or wire your own. Channel-point reward and bit boost are one toggle each.
Chat types !sr <song>. WolfWave finds it on Apple Music and queues it. Blocklist + hold mode in the same panel.
Full walkthrough: Song requests · Vote-to-skip
Settings → Discord. Toggle Discord Status on.
That's it. No bot token, no server. WolfWave talks to your Discord desktop app via local IPC socket.
Verify on your profile. "Listening to WolfWave" with Apple Music album art and live progress.
Full walkthrough: Discord status
