Settings reference - songify-rocks/Songify GitHub Wiki

Settings reference

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

System

  • 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.
  • Appearance β€” Accent color, light/dark theme.
  • Songify token β€” Used for Songify Premium and cloud sync (if enabled).

Output

  • 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 the widget and queue website features.
  • 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).

Integration (Twitch)

  • 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).

Rewards

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

Polls

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

Song requests

  • 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.

Bot commands & Bot responses

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

Spotify

  • 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.

YouTube (YTM Desktop / Pear)

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

Web server

  • 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.

Config

  • Beta updates, export/import configuration.

Windows in the app (outside Settings)

  • 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).
  • Console β€” Log output for debugging.