-
-
Notifications
You must be signed in to change notification settings - Fork 34
Migrating from 1.8
This guide is for people updating Songify 1.8.13 (or earlier 1.8.x) to 2.0.
What’s new in the release: Songify 2.0 patch notes.
Settings and listening history migrate automatically. Overlays that read Songify.txt / cover.png keep working. A few 1.8 habits change — those are listed here.
- Close Songify 1.8.13.
-
Copy the folder that contains
Songify.exe. That is whereAppConfig.yamland history live. Put the copy somewhere safe (Desktop / Documents). 2.0 rewrites config on first launch and converts history. - Extract the new
Songify.zipover your install (or into a new folder, then copyAppConfig.yamlacross if you want a parallel install). - Run
Songify.exe. First launch may show a short history migration window if your oldhistory.shris large.
Work through this once. Most 1.8 setups only need steps 1–3.
Widget upload, the online queue, recap, YouTube metadata helper, and cloud sync now need a Songify API token. The old AccessKey is gone and is no longer sent.
- Open songify.rocks/token-import and generate a token (shown once).
- Paste it in Songify: Home checklist, Help, or Settings → System → Songify token.
- If you lose it, rotate it on the website and paste the new one.
Without a token: local files (Songify.txt, cover.png) and the local web server still work. Hosted widgets, the online queue page, song upload, cloud settings, and recap will not.
Tokens, Client ID, and Client Secret from 1.8 usually carry over.
- Status bar dots should go green after a few seconds.
- If they stay red, use Help → Getting started or click the Spotify / Twitch status buttons.
- Spotify still uses your Client ID and Secret (same as 1.8).
Point OBS at the same output folder as before:
| File | Use in OBS |
|---|---|
Songify.txt |
Text (GDI+) → Read from file |
Artist.txt / Title.txt
|
Optional split output |
url.txt |
Track URL |
cover.png |
Image source (always written when the player provides art) |
canvas.mp4 |
New, optional — Spotify canvas, if canvas download is on |
Download album cover is always on in 2.0. There is no toggle anymore.
If you use a Browser source on songify.rocks / widget.songify.rocks:
- Add the API token (step 1).
- Turn on Upload song info (Settings → Output). Tools → Widget can turn this on for you.
- Keep the same widget URL in OBS. Your UUID is unchanged, so the stream ID stays the same once upload works again.
- Local history is now
history.yamlnext to Songify. - On first start,
history.shris converted and then deleted. - Uploading history to the website from the app is removed.
- Stream recap lives on songify.rocks/recap (Premium).
- The in-app History page is local only (calendar).
“Get beta updates” is gone. Use Settings → System → Release channel:
| Channel | What you get |
|---|---|
| Stable | Production releases |
| Beta | 2.0 betas |
| Dev (Unstable) | Cutting-edge builds |
If you had “Get beta updates” on in 1.8, you are on Beta automatically.
- Songify 2.0 runs on .NET 10.
- You need Windows 10 version 1809 (October 2018) or later, or Windows 11.
- Windows 7 / 8 are not supported.
- The main window minimum size is 900×500. Home scrolls on small screens. Allow smaller windows under Settings → Appearance → Overrule minimum size.
- In-app patch notes use WebView2. If it is missing, Songify opens them in your browser instead.
Songify no longer stores or sends an AccessKey. Uploads to songify.rocks authenticate with:
- your UUID (unchanged, still in config), and
- a Songify API token from your website account (Bearer auth).
Configs exported from 1.8 that only had an AccessKey will not upload until you add a token.
| 1.8.13 | 2.0 |
|---|---|
history.shr (binary) |
history.yaml |
| Optional upload from the app | Upload removed |
Migration is one-way: after conversion, history.shr is deleted. Keep your folder backup if you need to roll back to 1.8.
There is no Download album cover checkbox. cover.png is written whenever the player provides art (Spotify, Pear, Windows Playback, Browser Companion, and other sources that have it).
Spotify canvas download is still optional (Settings → Output). When enabled, canvas.mp4 is written to the same folder and can play on Home.
- Existing 1.8 installs skip the wizard (detected from Spotify/Twitch/Client ID already being set).
- New installs get a setup wizard and a Getting started list on Home until the basics are done.
- Re-run the wizard anytime from Help.
The old separate windows (main window, Settings, History, Queue, Blocklist, Console) are one sidebar shell. See Where things moved.
Cloud restore can be blocked if the snapshot’s schema is newer than this build — update Songify first.
| 1.8.13 | 2.0 |
|---|---|
| Center of the main window (now playing) | Home |
| Song requests → Queue | Queue in the sidebar, or Tools → Queue window (pop-out) |
| History window | History in the sidebar (calendar) |
| Song requests → Blocklist | Blocklist in the sidebar |
| User list | Users in the sidebar |
| View → Console | Help (live log), or Tools → Console window (detach) |
| File → Settings | Settings in the sidebar |
| File → Widget | Tools → Widget (gallery + generator) |
| File → Patch notes / Help | Help |
| Twitch → Connect / login | Twitch menu, or click the Twitch status icons |
| Player dropdown | Still on Home (grouped: song requests vs now playing only) |
| Footer status icons | Same idea — clickable (connect, start web server, open Pear, …) |
| “Get beta updates” | Settings → System → Release channel |
Settings tabs are the same ideas (System, Appearance, Output, Twitch, Rewards, Song requests, Bot commands, Spotify, YouTube, Web server, Config) in a cleaner layout.
Bot responses are one catalog: edit, reset, and preview in one place.
2.0 converts history and rewrites AppConfig.yaml. To go back:
- Close Songify 2.0.
- Restore the folder copy you made before updating (exe +
AppConfig.yaml+history.shr). - Do not copy
history.yamlback into 1.8 — 1.8 does not read it. - If you already let 2.0 delete
history.shrand you have no backup, in-app history from before the update is gone. Recap on the website is separate.
- First launch after 1.8.x migrates history and may rewrite
AppConfig.yaml. - A few labels or empty states may still be rough. Missing translations fall back to English.
- Hosted widgets / recap / cloud do nothing until a Songify API token is set.
- Small laptops: enable Overrule minimum size or use Interface scale at 100% and scroll Home.
- Pear with API authorization: you must Allow Songify in Pear after clicking Authorize (or selecting Pear). A WebSocket connect alone will not show the prompt.
Report anything that worked in 1.8.13 and does not in 2.0:
Attach logs from %LocalAppData%\Songify.Rocks\Logs (Help → Log folder).
Setup
Players & integrations
Stream overlay
Reference
Maintainers