Settings

Open Settings from the menu bar wolf icon. A sidebar lists every pane; this page tells you what lives where, with links to the deep-dives.

General

How WolfWave tracks your music and where it shows up. Four sections in one scrollable pane:

• Music Sync — the master switch. A hero now-playing card plus an integrations dashboard showing what's connected.

• App Visibility — run WolfWave as a menu bar app, a Dock app, or both.

• Appearance — pick how WolfWave looks. Covers the whole app, menu bar menu included, and the picker shows preview thumbnails before you commit.

  Option	What it does
  System (default)	Matches macOS, including its light/dark schedule.
  Light	Light look everywhere, even if macOS is in dark mode.
  Dark	Dark look everywhere, even if macOS is in light mode.

• Notifications — opt-in macOS banners: song changes, skip-vote started, and skip-vote passed. All off by default; each has its own toggle.

Appearance and notification choices are preferences, so they travel with Back Up & Restore.

Song Requests

The guided setup, the request policy preset (Open, Sub Only, Channel Point Only, Custom), queue rules, approval screening, hold mode, vote-skip, and the live queue view. The behavior is documented in Song Requests; the chat side lives in Bot Commands.

Stream Widgets

The OBS overlay: turn the connection on, drop in the ready-made browser source, and style it. Cards run in the order you need them, so the raw WebSocket feed (port, read-only overlay token, and the two addresses) sits last, under Build your own overlay, because only a hand-written overlay needs it. Sizes, themes, and the message contract are in the widget guide.

Stream Deck

The control side, on its own page. Holds the Allow Stream Deck commands switch, the same-Mac control token, and the setup steps. It is separate from Stream Widgets on purpose: the overlay token is read-only and reachable across your network, while the control token runs commands and is accepted only from this Mac. Turning commands off leaves your overlay running. Full walkthrough: Stream Deck.

History & Stats

Opt-in, on-device listening history with charts and the Monthly Wrap. What counts as a play and how retention works: Listening History.

Twitch

Connect your Twitch account (device code — no password typed into WolfWave), manage the chat bot, built-in command toggles and aliases, custom commands, and cooldowns. Command reference: Bot Commands.

Discord

Rich Presence: show what you're listening to on your Discord profile, with optional buttons and an idle status when nothing is playing.

If the connection doesn't come up, the pane now says which of these it is instead of always guessing that Discord is closed:

Software Update

Check for updates, switch between the Stable and Nightly channels, and see what's new. Channel details: Nightly Builds.

Advanced

Settings backup and restore, log export, the bug-report flow, and opt-in on-device diagnostics. If WolfWave ever crashes, a one-time recovery callout appears here.

About

Version, credits, license, and links to the docs, community Discord, and acknowledgements.

Show sponsor links controls whether WolfWave asks for support. Leave it on and you get a Sponsor item here, in the menu bar's Help submenu, and in the Help menu. Turn it off and all three disappear — the toggle itself stays, so you can turn it back on. WolfWave is free and fully functional either way.

Debug

Only exists in development builds — inspectors, service controls, and UI previews for people working on WolfWave. You won't see it in a release build.