Troubleshooting - songify-rocks/Songify GitHub Wiki

Troubleshooting

Updating from 1.8.x to 2.0

Hosted widgets, recap, and cloud sync need a Songify API token. History converts from history.shr to history.yaml. Full steps: Migrating from 1.8.

Songify won’t start or behaves oddly after an update

  • Install the latest release.
  • Coming from 1.8: Migrating from 1.8.
  • As a last resort, reset local data (this removes settings): delete the folder
    %LocalAppData%\Songify.Rocks
    Warning: Backup/export config first if you use Settings β†’ Config β†’ Export.

No song info

  • Confirm the correct player is selected (main window dropdown).
  • For Spotify, ensure the account is linked (Settings β†’ Spotify; status icons in the footer).
  • For Browser Companion, try increasing the fetch interval under Settings β†’ System to reduce missed updates / CPU load.

No album cover

  • Enable Download album cover under Settings β†’ Output.
  • Covers need a source that provides art (e.g. Spotify API). Some sources only provide title text.

Song requests not working

  • Spotify Premium is required for Spotify-based requests.
  • Complete Spotify setup and Twitch setup.
  • Bot must be connected; reward/command toggles must be enabled under Song requests.
  • See Song requests.

High CPU with Browser Companion / Chrome

Songify reads browser tab information on an interval. Lower the polling rate (increase seconds between fetches) under Settings β†’ System β†’ Chrome fetch rate (or similarly named option).

INVALID CLIENT: Failed to get client (Spotify)

Usually wrong Client ID or Client Secret. Recreate them on the Spotify Dashboard and paste again under Settings β†’ Spotify.

INVALID_CLIENT: Invalid redirect URI (Spotify)

Add the redirect URI to your Spotify app (Edit settings β†’ Redirect URIs β†’ Save):

http://127.0.0.1:4002/auth

If it still fails, also add:

http://localhost:4002/auth

See Spotify setup.

Web server won’t start

  • Pick a different port (another app may be using it).
  • For another device on the LAN: run Songify as administrator (it binds the LAN IP and adds a TCP firewall rule for the port). Localhost does not need a firewall rule.

Logs

Logs: %LocalAppData%\Songify.Rocks\Logs β€” attach relevant logs when reporting issues on GitHub or Discord.