Share the migration story

04 — Control

Recovery

Recognise the characteristic failure patterns before they damage the new system. Search by the symptom you can actually see.

Accidental Add Folder import

Symptom

Track count doubles and artist/album folders appear as playlists.

Likely cause

The collection was imported with Add Folder instead of a clean XML import.

Correct response

Restore or reimport the clean XML with Merge OFF; do not manually clean tens of thousands of records.

Do not delete — Do not delete the fresh XML.

ImportLexiconXMLReport page 31

Wrong XML baseline

Symptom

Recent tracks or playlists are absent.

Likely cause

The XML was exported before the latest Apple Music changes.

Correct response

Export a fresh full XML from the current Apple Music database and rebuild.

Do not delete — Do not delete Music Library.musiclibrary or legacy .itl files.

ImportXMLApple MusicReport page 31

Moved files not relocated

Symptom

Warning triangles and silent previews.

Likely cause

Files were moved on disk before the records were relocated.

Correct response

Create the Is file missing smartlist and bulk Relocate to the Master Music Library.

Do not delete — Do not delete the old iTunes media folder while unresolved files remain.

File pathsLexiconMaster Music LibraryReport page 31

Old-only files

Symptom

Small unresolved remainder after relocation.

Likely cause

Some files never made it into the Master Music Library.

Correct response

Search the old iTunes folder, move recovered files into the new library and relocate records individually or in a batch.

Do not delete — Do not delete the old iTunes media folder.

File pathsRecoveryReport page 31

Target path already exists

Symptom

Relocate refuses because another Lexicon record uses the file.

Likely cause

Two records point at the same audio file.

Correct response

Treat as a duplicate-record case; do not force two records to one path.

Do not delete — Do not delete either record before resolving the duplicate.

File pathsLexiconReport page 31

Serato data overwritten

Symptom

Cues or grids disappear after a full replacement.

Likely cause

A full replacement wrote over existing performance data.

Correct response

Restore the Serato/Lexicon backup and repeat the merge with selected fields.

Do not delete — Do not delete _Serato_Backup after a first migration.

SeratoBackupReport page 31

Serato-only crates disappear

Symptom

A later Full Sync removes work not represented in Lexicon.

Likely cause

Serato-only structures were never imported into the administrative master.

Correct response

Import Serato into Lexicon with Merge ON before the Full Sync, or use Modified/Playlist Sync instead.

Do not delete — Do not delete the Lexicon baseline backup.

SeratoCratesBackupReport page 31

TIDAL mirror is stale

Symptom

New Spotify additions do not appear in TIDAL or Serato.

Likely cause

The one-way Soundiiz sync did not run or partially failed.

Correct response

Run or check the Soundiiz sync, inspect match history, then refresh streaming services in Serato.

StreamingSpotifyTIDALSoundiizReport page 31

Wrong streaming match

Symptom

Different version, remix, clean edit or cover appears.

Likely cause

Soundiiz matched an incorrect release.

Correct response

Create a Soundiiz matching rule or correct the destination playlist manually.

StreamingSoundiizMetadataReport page 31

Crossed cloud icon in Lexicon

Symptom

Track is local but not uploaded to Lexicon cloud storage.

Likely cause

Cloud storage state, not a missing-file state.

Correct response

No action required for local playback; distinguish it from the missing-file warning triangle.

LexiconMetadataReport page 31
Part 13CONTROL

Failure, Drift and Recovery Architecture

Recognise the characteristic failure patterns before they damage the new system.

Failure, Drift and Recovery Architecture

Failure patternObserved symptomCorrect response — Accidental Add Folder importTrack count doubles and artist/album folders appear as playlists.Restore or reimport the clean XML with Merge OFF; do not manually clean tens of thousands of records.
Wrong XML baselineRecent tracks or playlists are absent.Export a fresh full XML from the current Apple Music database and rebuild.
Moved files not relocatedWarning triangles and silent previews.Create Is file missing smartlist and bulk Relocate to Master Music Library.
Old-only filesSmall unresolved remainder after relocation.Search the old iTunes folder, move recovered files into the new library and relocate records individually or in a batch.
Target path already existsRelocate refuses because another Lexicon record uses the file.Treat as a duplicate-record case; do not force two records to one path.
Serato data overwrittenCues or grids disappear after a full replacement.Restore the Serato/Lexicon backup and repeat the merge with selected fields.
Serato-only crates disappearA later Full Sync removes work not represented in Lexicon.Import Serato into Lexicon with Merge ON before the Full Sync, or use Modified/Playlist Sync instead.
TIDAL mirror is staleNew Spotify additions do not appear in TIDAL or Serato.Run/check Soundiiz sync, inspect match history, then refresh streaming services in Serato.
Wrong streaming matchDifferent version, remix, clean edit or cover appears.Create a Soundiiz matching rule or correct the destination playlist manually.
Crossed cloud icon in LexiconTrack is local but not uploaded to Lexicon cloud storage.No action required for local playback; distinguish from the missing-file warning triangle.
LexiconSeratoSpotifyTIDALSoundiiziTunesApple MusicXMLBackupFile pathsSmartlistsCratesPlaylistsImportRecoveryMaster Music Library

Restore hierarchy

  1. 01Stop making changes in both Lexicon and Serato.
  2. 02Identify the last known-good matched checkpoint.
  3. 03Restore the Lexicon database backup if the administrative master is damaged.
  4. 04Restore the Lexicon-created Serato backup or _Serato_Backup if the performance database is damaged.
  5. 05Verify file paths before reopening both applications.
  6. 06Repeat only the failed migration phase, not the entire process unless the baseline itself was wrong.
LexiconSeratoBackup

Source basis: S5, S6.

What not to delete

  • Do not delete the old iTunes media folder while unresolved files remain.
  • Do not delete the fresh XML after successful migration.
  • Do not delete Music Library.musiclibrary or the legacy .itl files merely to make the folder look clean.
  • Do not delete _Serato_Backup immediately after a successful first migration.
  • Do not delete the successful Lexicon baseline backup from the automatically cleaned backup folder without copying it elsewhere.
Part 14CONTROL

Operating Cycles and Checklists

Turn the migrated system into a repeatable professional routine.

Daily streaming cycle

  1. 01Discover and add streamed music in Spotify.
  2. 02Maintain existing genre, theme, event and current/classic playlists rather than creating unnecessary new lists.
  3. 03Allow or trigger Soundiiz to synchronize the selected Spotify playlists to TIDAL.
  4. 04Review failures or suspicious matches in active DJ playlists.
  5. 05Use the TIDAL mirror in Serato when stems or FLAC performance is required.
SeratoSpotifyTIDALSoundiizStemsPlaylists

New local-purchase cycle

  1. 01Place the file in Lexicon Watch Folder.
  2. 02Process it in Incoming.
  3. 03Set Grouping/riddim, BPM, key, genre and version details.
  4. 04Add it to durable Lexicon playlists.
  5. 05Mark it done and move it into Master Music Library.
  6. 06Run Modified Sync to Serato.
  7. 07Test the file in Serato before relying on it at a gig.
LexiconSeratoPlaylistsGroupingMaster Music Library

Before a gig

  • Lexicon changes have been synced.
  • Critical crates load and contain the expected tracks.
  • Grouping/riddim and BPM columns are visible where useful.
  • The intended streaming provider is selected.
  • TIDAL playlists have been refreshed after Soundiiz synchronization.
  • Stems have been tested on critical TIDAL tracks.
  • Local fallback music is sufficient if streaming fails.
  • A backup controller/computer plan exists if the event warrants it.
LexiconTIDALSoundiizBackupCratesStemsPlaylistsGrouping

After a gig

  • Add useful requests and discoveries to the correct Spotify playlists.
  • Promote important streaming-only tracks to purchased local files when long-term reliability is required.
  • Decide whether temporary Serato crates should remain temporary or be imported into Lexicon.
  • Create a Lexicon backup after substantial administrative work.
  • Quit Serato normally so its backup can update.
LexiconSeratoSpotifyBackupCratesPlaylistsImport

Monthly maintenance

  • Review Soundiiz synchronization history and persistent match failures.
  • Resolve part of the missing-files smartlist.
  • Copy a current Lexicon backup to a permanent location.
  • Confirm an independent backup of Master Music Library is current.
  • Recreate one or more high-value Smartlists from the former iTunes rules.
  • Avoid large cleanup projects immediately before an important gig.
Part 15CONTROL

Future State if Spotify Enables Stems

How the architecture can simplify without losing the owned-library foundation.

Current state

Spotify already functions as a powerful streaming curation source and, in current Serato versions, can be edited from within Serato and added to ordinary crates. The remaining decisive limitation for this workflow is that Spotify tracks do not currently support Serato Stems. TIDAL therefore remains the practical stems-capable mirror.

Source basis: S9, S10.

Potential future architecture

Channel 1

Streaming — Spotify
Serato streaming playlists and mixed crates

Potential future architecture

Channel 2

Owned music — Master Music Library
Lexicon
Serato native crates

Potential future architecture

Merged runtime

Lexicon local crates
Spotify tracks
Spotify Stems

Conditions for retiring TIDAL and Soundiiz

  • Spotify Stems are officially available and stable in Serato.
  • The feature is permitted on the subscription tier you intend to use.
  • Audio quality is adequate for your venues and system.
  • The deck limit and other streaming restrictions fit your four-channel workflow.
  • The Spotify catalogue versions used in performance are reliable.
  • The contractual terms are acceptable for the intended professional context.
  • A tested local fallback remains available.
SeratoSpotifyTIDALSoundiizStems

Conditions for retiring TIDAL and Soundiiz

Do not dismantle the mirror on speculation: Do not cancel TIDAL or dismantle the mirror based on speculation. Change the architecture only after the official feature is available, tested on the actual Serato version and controller, and proven over several performances.

Part 16CONTROL

Final Acceptance and End State

The migration is finished when the system passes these conditions.

Acceptance tests

  • The current physical audio resides in Master Music Library.
  • Lexicon points to those physical files and plays them.
  • The current Apple Music XML has been preserved as a frozen migration source.
  • The historical ordinary playlist hierarchy is editable in Lexicon.
  • Serato cues and desired performance metadata have been merged into Lexicon.
  • Grouping/riddim, BPM and key are preserved.
  • The historical hierarchy appears as native Serato crates and subcrates.
  • Tracks load from Master Music Library in Serato.
  • Show iTunes Library is disabled and the native crates remain.
  • The known unresolved files are documented in a missing-files smartlist.
  • The old iTunes media folder is retained only until recovery work is complete.
  • Spotify is the streaming curation source.
  • Soundiiz mirrors selected Spotify playlists to TIDAL.
  • TIDAL is usable in Serato for stems and higher-quality streaming.
  • New local music enters through Lexicon Incoming and is synced to Serato.
  • Routine syncs use Modified or Playlist mode rather than unnecessary Full Syncs.
  • Lexicon and Serato backups exist as a matched successful-migration checkpoint.
  • The audio files themselves have or are scheduled to receive an independent backup.
LexiconSeratoSpotifyTIDALSoundiiziTunesApple MusicXMLBackupSmartlistsCratesMetadataStemsPlaylistsGroupingRecoveryMaster Music Library

Acceptance tests

The full switch: Apple Music/iTunes is no longer the working crate holder. The Master Music Library holds the files. Lexicon holds the living owned-library intelligence. Serato holds the performance copy and combines it with streaming. Spotify holds daily streamed curation. TIDAL reproduces the selected streaming intelligence for stems-capable performance.

What has been preserved

  • Years of historical playlist organisation.
  • The DJ-specific logic encoded in Grouping/riddim, BPM, keys and cues.
  • The ability to use old owned music and new streaming music in the same performance environment.
  • The freedom to change performance software later because the administrative master is no longer trapped in Apple Music.
  • A clear route for future simplification if Spotify gains stems.