Music Library Doctor
Playlist migration

djay Pro → Serato DJ

One-pass migration from djay Pro JSON library into Serato crate files. %% separator encodes nested crate folders preserved end-to-end, format gotchas handled on both sides, nothing leaves your machine.

The problem

Moving from djay Pro to Serato DJ normally means an XML round-trip: export from djay Pro, hope Serato DJ parses it correctly, manually rebuild %% separator encodes nested crate folders, discover cues didn't translate. djay Pro syncs library data through iCloud on Mac, which means the canonical library may live in a hidden iCloud Drive folder rather than the local app support folder. And on the destination side: Every write must update both the main DB and each affected .crate atomically, or Serato shows ghost entries.

How Music Library Doctor does it

  1. 1 Install Music Library Doctor on the machine with djay Pro and Serato DJ. MLD detects both libraries automatically.
  2. 2 MLD opens djay Pro JSON library directly without needing djay Pro to be running.
  3. 3 Select the djay Pro playlists or folders you want in Serato DJ. MLD maps playlists and collections into %% separator encodes nested crate folders sensibly.
  4. 4 Choose Serato DJ as the destination. MLD writes Serato crate files natively and updates both the main DB and every .crate file in one pass.
  5. 5 Open Serato DJ — playlists are already there with hierarchy intact, paths pointing at the right files.

Supported today

Rekordbox · Serato DJ · VirtualDJ (incl. Favorite Folders) on Windows 10+ and macOS (Apple Silicon + Intel).

Why native integration matters

djay Pro and Serato DJ speak completely different languages: djay Pro JSON library (djay Pro integrates tightly with Apple Music and Spotify streams alongside local files — tracks that came from a stream have no portable file path) versus Serato crate files (Smart Crates are rule-based queries, not static lists — they have no direct equivalent in most other apps and need to be snapshotted at transfer time). XML export-import is the usual bridge — and it's lossy on both ends. MLD treats both formats as first-class, reads djay Pro's structure natively, and writes Serato DJ's native format directly, so %% separator encodes nested crate folders survives and the target app doesn't re-import anything. A timestamped backup of each app's library is taken before any write.

Frequently asked questions

Do I need to install djay Pro and Serato DJ on the same machine?

Yes. MLD reads both libraries locally, so both apps (or at least their library files) must be accessible on the same computer. Nothing uploads anywhere — all scanning is local.

Will nested %% separator encodes nested crate folders transfer correctly?

Yes. MLD reads playlists and collections and writes %% separator encodes nested crate folders natively so the structure survives the migration.

What if my music files moved after I built the djay Pro library?

Run Fix Missing Tracks for djay Pro first. MLD scans your drives, matches moved/renamed files, and repairs links in djay Pro before the transfer — so Serato DJ receives a clean library.

Does it back up my libraries before writing?

Yes. djay Pro and Serato DJ libraries are both copied to timestamped backups before any write. Rollback is always one folder away.

Can I go the other way, Serato DJ back to djay Pro?

Yes — see the Serato DJ to djay Pro guide. MLD supports every direction between supported apps.

Does this work with the latest djay Pro version?

Yes. MLD tracks djay Pro version compatibility and updates with each new release. See the changelog for the version matrix.

Get your library in shape in minutes

Free tier covers detection and viewing. Lifetime access is $49 — $19 for the first 100 DJs.

Related guides