Features

One app. Apple Music → Twitch, Discord, OBS. This page covers what each piece does and how to turn it on; every section links to its deep-dive.

Menu bar and Music Sync

WolfWave lives in your macOS menu bar. Click the wolf icon for a now-playing card with artwork, quick toggles, and hold/resume for the request queue.

• Native sync. Talks to Apple Music directly. No hacks, no lag. Flip Sync Music in Settings → General and WolfWave spots every song change.
• Remembers your last song, so !last just works.
• Battery friendly. Polling slows down in Low Power Mode.

Twitch Chat Bot

Log in once (Settings → Twitch, device code — you never type your password into WolfWave) and the bot auto-connects when the app opens.

• Pick your commands. Flip !song, !last, !sr, !voteskip, !stats, and more on with a click, each with its own aliases and cooldowns.
• Anti-spam. Global and per-user cooldowns; mods and the broadcaster bypass them.
• Custom commands. Roll your own !command with a fixed reply. Variables like $user, $touser, $args, $song, and $lastsong fill in live, with per-command aliases, cooldowns, and a permission level.

Full reference, aliases, and defaults: Bot Commands.

Song Requests

Open Settings → Song Requests and run the guided setup. It checks your Twitch connection, asks for Apple Music access, and creates the WolfWave Requests playlist. Requests can't switch on until setup finishes, so nothing half-configured ever goes live.

• !sr <song or link>. Chat requests by name or by Apple Music, Spotify, or YouTube link; WolfWave resolves it to the matching Apple Music track and queues it.
• Presets. One-tap policies: Open (everyone; points and bits on), Sub Only, Channel Point Only, or Custom for fine-grained control over who can use !sr (Everyone, Subscribers, VIPs & Subscribers, Mods Only).
• Built-in queue. See every request in Settings. Reorder, remove, or clear.
• Fair-share ordering. Round-robin: everyone's first request plays before anyone's second, so a fast re-typist can't hog the queue. On by default; turn it off for classic first-in, first-out.
• Sub / VIP priority. Optional perk: Skip cooldown lets subs, VIPs, and mods request without the wait; Jump the queue also moves them ahead within the current fair-share round. Off by default.
• Approve before play. Opt-in Require My Approval: every request — chat, channel points, bits — waits for your OK before it plays.
• Hold mode. Pause the queue from the menu bar or !hold. Requests still pile up; nothing plays until you resume.
• Vote-skip. Chat skips the current song together with !voteskip — a chat tally or a native Twitch poll, with a minimum-vote threshold you set.
• Blocklist. Block songs or artists you never want played, or a person you don't want requesting at all. A blocked person is turned away before WolfWave even looks their song up.
• Fallback playlist. When the queue runs dry, WolfWave can keep the music going from a playlist you pick.
• Share the playlist. Requests collect in "WolfWave Requests"; share it and !playlist posts a live link in chat. If the playlist ever goes missing or un-shared, WolfWave turns !playlist off and shows a fix-it banner instead of letting chat get a dead link.
• Sync Library check. WolfWave makes the playlist in your Apple Music library, but songs play out of the Music app on this Mac, and the playlist only reaches Music if Sync Library is on (Music → Settings → General). Setup and the Song Requests pane both ask Music directly and warn you if it can't see the playlist, so you find out before a viewer's request does.

Channel points and bits

• Channel-point reward. One toggle and WolfWave creates, reconciles, and fulfills a "Request a Song" reward for you. Redemptions feed the same queue.
• Crash-safe paid actions. WolfWave saves a recovery record before touching the queue and replays point fulfill/refund results or qualifying Bits actions after a quit or outage. If storage is unavailable, it pauses the managed reward and shows a fix-it banner; an already-paid Bits cheer still gets one process-owned attempt.
• Bit boost. When a viewer cheers past your minimum, their most-recent queued request jumps to the front. Same queue, same blocklist, same rules.
• Same controls as !sr. Points and bits respect the request audience, per-user limits, approval screening, and hold mode.

Now-Playing Widget

A good-looking overlay, one browser source, served entirely from your Mac — no hosted overlay service.

• Themes and layouts. Pick a theme (Default, Dark, Light, Glass, Neon) and a layout (Horizontal, Vertical, Compact, Vinyl, Classic), then tweak colors and fonts to match your stream.
• Updates instantly with smooth transitions — no strobing on stream.
• Queue ticker, opt-in. Add ?queueTicker=1 to the URL for a panel showing the next requests so viewers see their spot in line.
• Read-only token-gated. Every install has an overlay token; two-PC streamers can receive state over a trusted LAN without gaining command access. Details: WebSocket security.

Sizes, the message contract, and theming internals: OBS Widget.

Stream Deck control

The official plugin puts playback, your request queue, and your integrations on physical keys, with live state on every one. Its separate control token works only on the same Mac. Setup: Stream Deck. Building your own local client instead? See Stream Deck Control API.

Discord Status

Show "Listening to WolfWave" on your Discord profile with album art and a live progress bar. Connects to the Discord app on your Mac — no bot, no tokens, no setup. Off by default; when on, an idle status shows between songs (you can turn that off too).

Listening History & Stats

• Opt-in and on-device. Off by default; your history is a plain file on your Mac, never uploaded.
• Counts real plays. A track counts after the halfway mark (or 4 minutes), so skips don't pad your stats.
• Charts and Monthly Wrap. Top artists, listening time, trends, and a monthly "wrapped"-style summary you can export as an image.
• !stats for chat, live-gated so it only answers during a stream.

Retention, what counts, and privacy: Listening History.

Notifications

Opt-in macOS banners: song changes (with album art), skip-vote started, and skip-vote passed. Each type replaces its previous banner instead of stacking. All off by default — turn them on in Settings → General.

Streamer Mode

One tap from the menu bar makes WolfWave camera-safe: channel name, overlay URLs, and the auth token mask to •••••• on screen while everything keeps working underneath. Details: Streamer Mode.

Backup & Restore

Export your settings to a JSON file and import them on a new Mac. Accounts and secrets are never included. Details: Back Up & Restore.

Diagnostics and bug reports

A built-in bug-report flow pre-fills a GitHub issue with your app version, and opt-in on-device diagnostics capture crash and performance data that never leaves your Mac unless you share it. See Report a bug.

Security & Privacy

Tokens live in the macOS Keychain. Zero analytics — data only goes to services you turn on. Signed and notarized by Apple. Details: Security and the Privacy Policy.

Wondering how WolfWave stacks up against Jam Deck, SpotchBot, or Discord-RPC-only tools? See the comparison.

Where to next