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.

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

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

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

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

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

Usually wrong Client ID or Client Secret. Recreate them on the Spotify Dashboard and paste again under Settings → 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.

• 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: %LocalAppData%\Songify.Rocks\Logs — attach relevant logs when reporting issues on GitHub or Discord.