Share the migration story

01 — Architecture

The system model

Ownership, administration and performance are separated on purpose. This section defines which application holds authority over what, and how the streaming channel stays subordinate to the owned library.

Part 1FOUNDATION

Document Control — Scope, authority and use

What this guide covers, who it is for, and the limits of its authority.

Document Control — Scope, authority and use

FieldDefinition — PurposeTo move a long-running iTunes/Apple Music DJ collection into a durable, application-neutral local library managed in Lexicon and performed in Serato, while maintaining a parallel streaming workflow.
Primary audienceExperienced or long-running DJs whose local crates and playlist history remain trapped in iTunes or Apple Music.
Operating modelAdministration Mode in Lexicon; Performance Mode in Serato; Streaming Curation in Spotify; TIDAL mirror for stems and higher-quality DJ streaming.
ScopeLocal files, playlist migration, metadata, Serato crates, smartlists, backups, Spotify-to-TIDAL mirroring, routine operations and recovery.
Not coveredCopyright acquisition, public-performance licensing, detailed controller mapping, music production workflows or a complete tutorial for every Lexicon utility.
Version sensitivityStreaming capabilities and subscription rules change. Re-check official documentation before making permanent subscription or platform decisions.
LexiconSeratoSpotifyTIDALiTunesApple MusicBackupSmartlistsCratesMetadataStemsPlaylistsRecovery

Document Control — Scope, authority and use

Separate ownership, administration and performance: The audio files must remain ordinary files in a neutral Master Music Library. Lexicon should administer the owned collection. Serato should perform it. Streaming services should supplement the collection, not become the only place where the DJ's organisational intelligence exists.

How this guide is structured

The guide uses a controlled-part structure: first the system model and authority rules, then the migration sequence, then the operating modes, then failure and recovery architecture, and finally acceptance tests. It is designed to be followed as a complete migration order rather than as a loose collection of tips.

Part 0FOUNDATION

Executive Operating Statement

What the migration solves and what the final system should become.

Executive Operating Statement

For many long-running DJs, iTunes became the crate holder during the transition from vinyl and CD collections to digital performance. The problem is not simply that Apple renamed iTunes. The deeper problem is that playlist history, local-file references and years of practical DJ classification became dependent on an application that no longer functions well as a specialist DJ administration environment.

Executive Operating Statement

The correct replacement is not another single platform. It is a division of responsibility in which each system does one job clearly.

Executive Operating Statement

LayerPrimary authorityFunction — Owned audio filesMaster Music Library folderPermanent, application-neutral storage of purchased, ripped and otherwise lawfully held local audio.
Owned-library administrationLexiconPlaylists, playlist folders, smartlists, metadata, Grouping/riddim, BPM, key, cue consolidation and backups.
DJ performanceSerato DJ ProNative crates and subcrates, loading, playback, cueing, stems, event preparation and hardware integration.
Daily streaming curationSpotifyDiscovery, social sharing, client lists, household use and day-to-day streamed playlist work.
Streaming performance mirrorTIDALTIDAL DJ integration, FLAC/AAC options and Serato Stems while Spotify Stems remain unavailable.
Cross-service bridgeSoundiizOne-way playlist synchronization from Spotify to TIDAL.
Legacy recoveryApple Music/iTunes files and XMLHistorical evidence and recovery source only after the migration passes.
LexiconSeratoSpotifyTIDALSoundiiziTunesApple MusicXMLBackupSmartlistsCratesMetadataStemsPlaylistsGroupingRecoveryMaster Music Library

The target is a complete switch, not a partial workaround

The migration is complete only when the old playlist hierarchy is editable in Lexicon, appears as native crates and subcrates in Serato, local files load from the new Master Music Library, the Show iTunes Library option can be disabled, and the streaming workflow continues independently.

The four operating modes

ModeApplicationsPurposeAuthority rule — Administration ModeLexicon + Master Music LibraryOwned-file intake, metadata, playlists, smartlists, recovery and synchronization.Permanent owned-library changes originate here.
Performance ModeSerato + controller/mixerLocal crates, TIDAL or Spotify streaming, stems, cues and live set execution.Serato is the runtime, not the sole archive.
Streaming Curation ModeSpotify + Soundiiz + TIDALDaily discovery in Spotify and one-way replication to TIDAL.Spotify is source; TIDAL is mirror.
Legacy Recovery ModeApple XML, .musiclibrary, old iTunes mediaRecover missing files and reconstruct smart rules.Read-only unless a deliberate recovery action is required.
LexiconSeratoSpotifyTIDALSoundiiziTunesXMLSmartlistsCratesMetadataStemsPlaylistsRecoveryMaster Music Library

What the guide does not assume

  • It does not assume that a streaming playlist is equivalent to owning the audio file.
  • It does not assume that Serato crates automatically synchronize back to Spotify or TIDAL.
  • It does not assume that an Apple XML contains the audio files; it contains records, paths and playlist information.
  • It does not assume that the old iTunes folder is safe to delete merely because Apple Music appears to work.
  • It does not assume that every iTunes Smart Playlist rule survives XML migration.
  • It does not require a second internal copy of a very large music folder when the folder is moved on the same disk volume.
Part 1FOUNDATION

Units of the DJ Library System

Keep the objects separate so one migration action is not mistaken for another.

Units of the DJ Library System

A reliable migration depends on distinguishing six different objects. A song file, a database record and a playlist entry are related, but they are not the same thing.

Units of the DJ Library System

UnitDefinitionWhat can go wrong — Audio fileThe MP3, AIFF, WAV, FLAC, ALAC, AAC or M4A file stored on disk.It can be moved, renamed, deleted, duplicated or protected by DRM.
Track recordA database entry in Apple Music, Lexicon or Serato that points to an audio file and stores metadata.The record can survive while its file path becomes invalid.
PlaylistA manually curated ordered list of track records.The list can import correctly while all referenced files are missing.
Smartlist / Smart CrateA dynamic list generated from rules such as Grouping contains a riddim name or BPM falls in a range.The current membership may transfer while the rule itself does not.
Performance dataCue points, loops, beatgrids, play counts, colors and other DJ preparation.It may exist only in Serato unless deliberately merged into Lexicon.
Streaming referenceA service-specific reference to a Spotify or TIDAL catalogue track.It can disappear, change version, fail to match or become unavailable offline.
LexiconSeratoSpotifyTIDALApple MusicSmartlistsCratesMetadataPlaylistsImportGrouping

Three different meanings of "library"

  • Physical library: the files stored inside the Master Music Library folder.
  • Administrative library: the Lexicon database containing playlists, metadata and file locations.
  • Performance library: the Serato database containing native crates, playback preparation and references to local or streaming tracks.

Three different meanings of "library"

A visible folder in Lexicon is not required: Lexicon can point directly to every file in the Master Music Library without showing the physical artist and album folder tree as playlists. Using Add Folder creates playlist representations of the filesystem; it is not what creates the underlying track-to-file connection.

Local and streaming domains

PropertyOwned local musicStreaming music — PersistenceUnder the DJ's control if the files and backups are retained.Dependent on subscription, service availability and catalogue licensing.
Metadata authorityLexicon and the embedded file tags.Service metadata, with some Serato preparation stored locally.
Playlist authorityLexicon for durable local organisation.Spotify for the source streaming structure; TIDAL as mirror.
Offline useYes, when the file is physically available.Not generally in Serato for Spotify or TIDAL.
StemsAvailable for local compatible files in Serato.Currently available for TIDAL with the DJ Extension; not currently available for Spotify.
Recording in SeratoAvailable for local files, subject to normal setup.Not available for TIDAL or Spotify streaming tracks.
LexiconSeratoSpotifyTIDALBackupMetadataStemsPlaylists

Source basis: S9, S10, S11.

Part 2FOUNDATION

Target Architecture and Authority Model

The stable end state before any migration steps are taken.

Core flow

Owned music channel

Purchased or recovered file
Master Music Library
Lexicon
Serato native crates

Core flow

Streaming channel

Spotify
Soundiiz one-way sync
TIDAL
Serato streaming section

Core flow

Operational merge

Local Lexicon crates
One active streaming provider
Serato

Authority matrix

ObjectCreate/edit primarily inExport or mirror toDo not treat as authority — Local playlist folderLexiconSerato subcrate hierarchyApple Music after retirement
Local playlistLexiconSerato crateA temporary Serato-only copy
Local smartlistLexiconCompatible Serato Smart CrateOld iTunes Smart Playlist membership alone
Grouping / riddimLexicon and file tags where appropriateSerato Grouping fieldFilename alone
Spotify playlistSpotify or Spotify section in SeratoTIDAL through SoundiizLexicon import snapshot
TIDAL playlistSoundiiz destination / TIDALSerato TIDAL sectionAn independently edited second master
Event crateSerato when temporary; Lexicon when permanentOptional import back to LexiconA streaming-service folder structure
Audio file locationMaster Music LibraryLexicon and Serato databases point to itDocuments, Downloads or an app-specific cache
LexiconSeratoSpotifyTIDALSoundiiziTunesApple MusicSmartlistsCratesPlaylistsImportGroupingMaster Music Library

Why Spotify and TIDAL are not two equal masters

A two-way streaming master creates conflict. If the same playlist is edited independently in both Spotify and TIDAL, a synchronization service must decide which version wins. In this architecture Spotify is the source of truth because it is where daily listening, sharing and discovery occur. TIDAL is the performance mirror used when its DJ functions, stems or stream quality justify it.

Why Spotify and TIDAL are not two equal masters

One-way rule: Synchronize Spotify to TIDAL. Do not build a bidirectional mirror unless you have a specific conflict-resolution process and understand which edits will be overwritten.

Version-sensitive operating facts as of 1 August 2026

CapabilitySpotify in SeratoTIDAL in Serato — Playlist visibilityYesYes
Create/edit service playlists in SeratoSupported, including renaming, deleting, adding, removing and reordering.Playlist creation and adding tracks are supported; full parity with Spotify controls is not documented.
Add streaming tracks to ordinary Serato cratesSupported in Serato DJ Pro 4.0.4 and later.Official Serato documentation says no.
StemsNot available.Available with Serato DJ Pro 3.1.3+ and TIDAL DJ Extension.
Offline DJ playbackNoNo
Serato recordingNoNo
Stream qualityUp to 320 kbps according to Serato documentation.AAC or FLAC with DJ Extension.
Simultaneous active providersOnly one streaming provider can be selected in Serato at a time.Only one streaming provider can be selected in Serato at a time.
SeratoSpotifyTIDALCratesStemsPlaylists

Source basis: S9, S10, S11, S12, S15.