A native macOS menu bar app that bridges Apple Music with Twitch, Discord, and your stream overlays. Real-time now playing detection, automated chat commands, Discord Rich Presence with dynamic album art, and WebSocket streaming — all from your menu bar.
- Real-time Now Playing — Track Apple Music and broadcast instantly via ScriptingBridge
- Twitch Chat Bot —
!song,!currentsong,!nowplaying,!lastsongvia EventSub + Helix - Discord Rich Presence — Show "Listening to Apple Music" on your Discord profile with dynamic album art
- WebSocket Streaming — Send now-playing data to overlays (ws:// or wss://)
- Secure by Default — All credentials stored in macOS Keychain; no plain-text tokens
- First-Launch Onboarding — Guided setup wizard for new users
- Download the latest DMG from the GitHub Releases page
- Open the DMG and drag WolfWave to your Applications folder
- Launch WolfWave and follow the onboarding wizard
The app is signed and notarized by Apple — no Gatekeeper warnings.
| 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 |
Enable in Settings > Discord to show what you're listening to on your Discord profile. Album artwork is fetched automatically from the iTunes Search API — no manual setup needed.
Configure in Settings > WebSocket to broadcast now-playing data to your stream overlays in real-time.
- macOS 15.0+
- Xcode 16.0+
- Swift 5.9+
- Command Line Tools:
xcode-select --install
git clone https://github.com/MrDemonWolf/WolfWave.git
cd WolfWave
# Configure API keys
cp src/wolfwave/Config.xcconfig.example src/wolfwave/Config.xcconfig
# Edit Config.xcconfig with your Twitch Client ID and Discord Application ID
# Open in Xcode and run (Cmd+R)
make open-xcodeGet a Twitch Client ID at dev.twitch.tv/console/apps
Get a Discord Application ID at discord.com/developers/applications
| Command | Description |
|---|---|
make build |
Debug build |
make clean |
Clean build artifacts |
make prod-build |
Release build + DMG |
make notarize |
Notarize the DMG (requires Developer ID) |
make test |
Run tests |
make open-xcode |
Open Xcode project |
make update-deps |
Resolve SwiftPM dependencies |
Pushing a version tag triggers the CI/CD pipeline which builds, notarizes, and creates a GitHub Release:
git tag v1.0.0
git push origin v1.0.0See Releasing & Notarization in the docs for full CI/CD setup instructions.
For complete documentation, visit: mrdemonwolf.github.io/wolfwave
- Features — Complete feature list
- Installation — Download and setup
- Usage Guide — How to use WolfWave
- Bot Commands — Chat command reference
- Development — Contributing guide
- Architecture — Project structure
Questions or feedback? Join the Discord: mrdwolf.net/discord
Made with ❤️ by MrDemonWolf, Inc.