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.
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.
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 the commands you want. !song, !last, !sr, !voteskip are all off by default.
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. Recommended canvases include the widget's transparent padding: Horizontal (532×132), Vertical (252×312), Compact (382×88), Vinyl (292×332), Classic (472×144).
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 Rich Presence · Features
What's new
Check the changelog for every release. WolfWave auto-updates via Sparkle (EdDSA-signed); Homebrew installs update with brew upgrade --cask wolfwave.
