Skip to content

Import and Export

Michael Riddle edited this page Aug 20, 2026 · 3 revisions

Import & Export

Reach this page from the header menu → Import / Export. It's the only place to move data off the device, back it up, or pull songs in from somewhere else — three sections, six buttons.

Singer profile

Move a singer — their songs and performance history — to another device, or keep a backup. Tonight's set stays on this device.

Button Sub-caption
📤 Export [name]'s profile "[count] songs + history, as .json"
📥 Import a profile "Add a singer from a .json file"

Export hands a .json file to your phone's share sheet (Files, Drive, email, AirDrop, whatever you normally share to) — it contains that singer's name, color, glyph, their whole My Songs list, and every logged performance. It does not include tonight's set or venues.

Import opens the file picker for a .json file, then asks how to bring it in:

  • Add as a new singer — "[name] joins this device with their own My Songs and history, and becomes the active singer." This is the real restore/move path: the singer, their songs, and their history all come across as-is, and the app switches to them. It always adds — importing your own backup onto a phone where that singer is still present gives you a second copy of them alongside the original, not an update to it. Restoring onto a fresh install, where there's nothing to clash with, brings the singer back exactly as exported. If you only meant to top your existing list up, use Merge songs instead.
  • Merge songs into [current singer] — "Just the songs, added to your current list. Identity and history are left behind." Only the songs' details (title, artist, notes, genre, year, enjoyment, favorite and tags) are copied into whoever you're currently signed in as; a song already on your list (matched by title and artist) is skipped, and no performance history comes along.

An older export file that's a bare list of songs (no singer attached) is accepted too — it's merged straight into your current list the same way.

Venues

Venues are shared by everyone on this device. Export the list, or merge one in.

Button Sub-caption
📤 Export venues "[count] venues as .json"
📥 Import venues "Merge venues from a .json file"

Export venues is grayed out until you have at least one venue (its sub-caption reads "No venues to export yet" until then). Once you do, it bundles up your whole Venues list into one .json file, sent to the share sheet.

Import merges — nothing is replaced wholesale. A venue you already have gets its details updated (so any performance history tagged to it keeps pointing at the right place); a venue you don't have yet is added. You'll see a result like "Venues merged — 2 added, 1 updated." A file with no valid venues in it says "No venues found in that file."; a file that isn't a venues export at all says "That file isn't a valid venues export."

Third-party import

Pull songs into your list from a public playlist.

Button Sub-caption
Import from Spotify "A public playlist link"
Import from YouTube Music "A public playlist link"

No account or sign-in, on either side — paste a link to a public playlist and tap Fetch playlist.

What you can paste:

Source Accepted forms
Spotify A web link like https://open.spotify.com/playlist/…, a spotify:playlist:… link, or just the playlist's id
YouTube Music A music.youtube.com or youtube.com link with ?list=… in it, a …/browse/VL… link, or just the playlist's id

Only the title and artist of each track come across — no year, genre or cover art from the playlist itself (auto-fill picks those up afterward, see below). A very long playlist is cut off around the first 100 tracks, flagged with "Showing the first 100 tracks — longer playlists are trimmed."

If something goes wrong, you'll see one of these:

What happened Message
Link doesn't look like that service's playlist link "That doesn't look like a Spotify playlist link." / "That doesn't look like a YouTube Music playlist link."
Spotify playlist not found or private "That playlist couldn't be found — make sure it's public."
YouTube Music playlist private or invalid "No tracks were found for that playlist. Make sure it's public."
The service returned an error "Spotify returned an error (…). Try again later." / "YouTube Music returned an error (…). Try again later."
No network "Couldn't reach Spotify. Check your connection and try again." / "Couldn't reach YouTube Music. Check your connection and try again."
The playlist page couldn't be read at all "Couldn't read the playlist — Spotify may have changed its embed format." / "…YouTube Music may have changed its page format."
Playlist read fine but had nothing to import "That playlist has no importable tracks."

Once a playlist loads, tracks already on your list (matched by title and artist) are pre-marked already added and left unchecked; everything else starts checked. All / None select the whole list at once. Tap Import [count] songs to bring in whatever's checked — a track you check anyway despite the "already added" label still gets imported.

After an import

If Settings → My Songs → "Enable Auto-fill Year & Genre" is on, the sheet stays open and looks each newly-imported song up one at a time, showing "Looking up [x] of [y]…". Once done, review what it found and tap Apply [count] to fill in the blanks — or Skip to leave them as-is (a skipped song still gets a normal lookup later, whenever you happen to open it).

These lookups are spaced out rather than fired all at once, controlled by Settings → App → "Import lookup speed" — Gentle, Normal, or Fast. Faster finishes sooner, but risks the lookup provider refusing requests partway through a big playlist; Gentle is the safest choice for a long one.

If auto-fill is off, the sheet closes after the import, and each song picks up year/genre/cover art the normal way the first time you open it (see Metadata & album art).

Duplicate handling

What you're importing How a duplicate is handled
Spotify / YouTube Music playlist Matched by title + artist against your current list; matches are pre-unchecked as "already added," but you can force-check and import them anyway
Merge a profile's songs into your current list A title + artist match already on your list is skipped automatically
Add a profile as a new singer Nothing is skipped — it's a full restore of that singer's own list
Venues Not really a "duplicate" — a venue you already have is updated, a new one is added

Backing up

Exporting your profile is how you back yourself up. It's the only export that includes your full performance history, so keep a copy somewhere safe (cloud drive, email to yourself) before you wipe or replace a phone.

  • Updating the app in place keeps your data — installing a newer version over the current one doesn't touch it.
  • Uninstalling does not — everything (your songs, history, venues, singers) is gone with the app, with no way back except a profile/venues export made beforehand.
  • Venues aren't part of a singer's profile export — back them up separately with Export venues if you rely on them.

See also

Clone this wiki locally