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. Each pane heading below also carries a wolfwave:// link that opens WolfWave straight to it (see Deep links).

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 (each with its own delivery mode: reply, plain message, or announcement), 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. Export Logs writes one diagnostics file: an environment summary (version, macOS, install method), the last crash if there was one, and every rotated log, oldest first, so a bug report carries everything in a single attachment. If WolfWave ever crashes, a one-time recovery callout appears here and says what crashed.

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.

Deep links

WolfWave registers the wolfwave:// URL scheme. A link opens Settings on a pane, scrolls to a card, and flashes it for a moment. It works whether Settings is closed or already open somewhere else. Anything WolfWave doesn't recognise opens General, so a stale link never errors.

wolfwave://settings                       General
wolfwave://settings/<pane>                one pane
wolfwave://settings/<pane>/<section>      one card inside that pane

Names are stable identifiers, not the titles you see on screen, so they survive copy changes.

Some cards only exist once a feature is on (Song Requests cards need setup finished and the feature enabled; History cards need history on). A link to a card that isn't showing opens the pane and stops there.

Try one from Terminal:

open "wolfwave://settings/twitch/custom-commands"

Debug

Only exists in development builds: inspectors, service controls, a live log viewer that tails the log file as it is written (level and category filters, search, follow), and UI previews for people working on WolfWave. You won't see it in a release build.