Settings reference - songify-rocks/Songify GitHub Wiki

Settings reference

Settings are organized in tabs. Names may differ slightly when the UI is translated.

Language — UI language. Help translate via Weblate.
Behavior — Autostart, minimize to tray, open queue on startup, Chrome / Browser Companion fetch rate (lower = more CPU use; only relevant for Browser Companion).
Privacy — Show or hide account names and avatars in Songify.
Songify token — Used for Songify Premium and cloud sync (if enabled).

Theme — Light or dark.
Window backdrop — Mica, Acrylic, Tabbed, Auto, or None.
Accent color — App accent (wheel, System / Windows accent, recent colors, or hex). The last 7 custom colors are remembered.
Interface scale — Extra zoom on top of Windows DPI.
Overrule minimum size — Allow resizing the main window below 900×500.
Side menu — Main navigation layout (expanded, top, or bottom). The expanded/collapsed state of the left menu is restored on launch.

Output directory — Where Songify.txt, Artist.txt, Title.txt, cover image, etc. are written.
Output format (text file & widget) — Placeholders such as {artist}, {title}, {extra}, {url}, {{requested by {req}}} (block only shown for requests).
Output format (Twitch chat) — Format when posting current song to chat via command.
Append spaces — Pads text files for smoother scrolling in some setups.
Pause text — Text shown when playback is paused (if enabled).
Upload song info — Uploads track data for hosted widgets and the queue website. Getting started and Tools → Widget turn this on when you open a widget.
Split artist and title — Writes separate Artist.txt / Title.txt files.
Download album cover — Saves cover art (works when metadata comes from APIs that provide it, e.g. Spotify).

Login with Twitch — OAuth for API features (rewards, stream state, etc.).
Account name, OAuth token, channel — Bot identity and channel to join.
Autoconnect — Connect bot when Songify starts.
Announce song to chat — Post track info when the song changes.
Limit to live stream — Bot/features only when you are live (requires Twitch API).

Select channel point rewards, refresh list, create rewards via Songify (needed for refund integration).
Refund conditions — When to refund channel points automatically.

Configure Twitch polls integration (when available in your build).

Enable channel point requests and/or command requests.
Queue — Clear on startup, user level, max requests per user, cooldown, max song length.
Refund and moderation options as shown in the UI.

Commands — Enable/disable commands, change triggers (no spaces in triggers).
Responses — Templates with placeholders like {user}, {artist}, {title} (varies per response).

Link — Connect your Spotify account.
Use Songify App ID / own App ID — Own App ID is recommended; create an app on the Spotify Dashboard. See Spotify setup.
Client ID / Client Secret — From your Spotify application settings.

Settings for linking YTM Desktop or related integrations. See YTM Desktop and Pear (YouTube Music).

Optional: use your own YouTube Data API key for more reliable YouTube metadata.

Port — Local HTTP + WebSocket (use a port above 1024; avoid conflicts).
Start / auto-start — Run the built-in server for JSON and WebSocket control. See Web server and API.

Queue — Request queue (app queue is not always identical to Spotify’s queue; deleting here may not remove from Spotify).
Blocklist — Block artists, songs, or users from requesting.
History — Listening history (optional upload/share).
Help — Getting started, support links, folders, and the live log / API metrics (detach to a separate window from Tools).