Exporting library metadata

Export library metadata

Documentation home

Create an explicitly requested, read-only metadata snapshot from the loaded library in Settings. Audio and image files are not included.

Complete library metadata exports

Settings → Export library metadata offers Prepare JSON export and Prepare CSV ZIP. When the file is ready, choose its separate Download button. No Save is needed. This exports the full loaded library, regardless of the current search, filter or selection. Open drafts and later iBroadcast changes are excluded; reload the library first if you need a fresh snapshot.

Both formats retain native album/disc and track IDs, separate primary/additional album artists and track credits, ordered roles and credit phrases, exact main and additional genres, ratings, artwork IDs and upload dates/times. The ZIP contains linked artists, albums, album_tracks, tracks, credits and genres CSVs, plus optional tag, playlist and local-favourite tables. IDs keep the relationships clear. Native disc records are exported without Tagcast's browser grouping.

Optional loaded tags/playlists and saved local album/artist hearts are selected by default. They are read only when already available; missing or damaged optional data is reported in the manifest rather than silently shown as empty. Playlist order, repeated track IDs and playlists over 10,000 positions are preserved.

Export schema 2 separates native playlist folders into playlist_folders and playlist_folder_items. Folder contents refer to playlist/folder IDs, never music track IDs; nesting, order, repeated and missing references are preserved. Schema 1 incorrectly placed folder contents in playlist_tracks; prepare a new export if you need folder relationships. CSV files use UTF-8 and quote multiline text, escape spreadsheet formulas and preserve null versus empty text; JSON preserves native scalar types.

Preparation uses the server's loaded library and a private temporary file, without extra iBroadcast requests or loading the complete archive into browser JavaScript. Close Settings and return to download; files expire 15 minutes after preparation starts. Library/account/connection changes invalidate an older export. Preparation can be cancelled. No music metadata, settings, change history or playback is changed. Audio, image binaries, credentials, signed file URLs and provider prose are excluded. This metadata archive has no restore function; CSV playlist import is a separate workflow. Export changes remains a separate browser-local change-history download.

See the format and completeness guide.

See what is saved where for the difference between a snapshot, Change history and iBroadcast data.