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 with Twitch, Discord, and OBS. Automatically. These docs cover every part of that 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. Your per-install auth token is baked in. Leave the URL intact.
Paste into OBS as a Browser Source. Pick your layout: Horizontal (500×120), Vertical (320×360), Compact (320×80).
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.
