Back Up & Restore

Guide

Save your settings to a file, restore them anywhere. Bring your setup to another Mac or back after a clean reinstall. Your accounts are never in the file, so backups are safe to keep and share.

What gets backed up

Your preferences. Things like:

• Song Request rules (limits, cooldowns, command names, vote-skip)
• Stream Widget look and ports (theme, layout, colors, server port)
• Discord Rich Presence options (buttons, playlist, idle and pause behavior)
• Everything else: notification toggles, History & Stats options, appearance, dock visibility

What does NOT get backed up

Anything tied to an account or kept secret. None of this leaves your Mac:

• Your Twitch sign-in (the OAuth token, plus your user and channel IDs)
• The Stream Widgets auth token
• System permissions, like Apple Music control and notifications

These live in the macOS Keychain, or macOS grants them per Mac, so they never get written to the file. A backup is just your settings, in plain JSON you can open and read. After importing on a new Mac, you may need to re-grant access (like Apple Music control) the first time WolfWave asks.

Export

1. Open Settings → Advanced.
2. Click Export Settings under Back Up Settings.
3. Pick where to save. The file is named wolfwave-settings-<date>.json.

Import

1. Open Settings → Advanced.
2. Click Import Settings and choose a backup file.
3. Review. A sheet shows how many preferences will be restored.
4. Decide on Twitch. If the backup had Twitch connected, you choose:
   • On: WolfWave restores your channel and asks you to sign in to Twitch again (your login was never in the file).
   • Off: Twitch is skipped. Everything else still imports.
5. Click Import.

It merges, never wipes. Importing adds your preferences in. It won't delete settings missing from the backup, and it won't touch a connection you leave switched off.

Move to a new Mac

1. Old Mac: Export Settings.
2. Copy the file over. AirDrop, iCloud Drive, a USB stick, anything.
3. New Mac: install WolfWave, then Import Settings.
4. Reconnect Twitch: turn it on in the review sheet and sign in once. Done.

Good to know

• Reconnecting Twitch always means signing in again, because your login is never part of a backup.
• Permissions don't carry over. macOS grants them per Mac, so re-grant access (like Apple Music control) after importing.
• Newer-version backups ask you to update WolfWave before they'll import.
• Listening History stays put. Your play log and stats are personal data, not settings, so they're not in a settings backup.