Rekordbox OneLibrary
Rekordbox 7 introduced a new library export format called OneLibrary. It
replaces the legacy .PDB binary database on USB and SD exports with an
encrypted SQLite database, exportLibrary.db. Now Playing supports this new
format through the onelibrary-connect package.
Where OneLibrary Appears
Section titled “Where OneLibrary Appears”- On USB drives and SD cards exported from Rekordbox 7.
- On CDJ-3000 and CDJ-3000X media players reading modern exports.
- As the on-device library on newer AlphaTheta hardware.
The legacy .PDB format continues to be used by older CDJs and older Rekordbox
versions, and is still supported via a separate code path in
alphatheta-connect.
How It Works
Section titled “How It Works”OneLibrary is a SQLCipher-encrypted SQLite database — the same encryption
family used by Rekordbox’s desktop library. The onelibrary-connect package:
- Opens
exportLibrary.dbusing the known decryption key. - Exposes an adapter interface for querying tracks, playlists, cues, hot cue banks, history, and myTags.
- Returns schema-aware result rows ready for consumption by
alphatheta-connect.
Because the schema is well-defined and stable, the adapter can expose structured queries rather than ad-hoc SQL — for example, “list all hot cues for track ID X” returns typed cue objects with colours and labels.
What Data Is Available
Section titled “What Data Is Available”| Data | Notes |
|---|---|
| Track metadata | Full catalog with title, artist, album, genre, key, BPM |
| Playlist hierarchy | Nested playlists with parent/child relationships |
| Cues and hot cues | Per-track with RGB colour, position, comment |
| Hot cue banks | Modern hot-cue bank layouts |
| Beatgrid | Beatgrid markers with tempo changes |
| Artwork references | IDs that resolve to artwork files elsewhere on the drive |
| History sessions | Playback history from the player |
| myTags | User-defined track tagging system |
Relationship to PRO DJ LINK
Section titled “Relationship to PRO DJ LINK”When the network-protocol connector detects a CDJ-3000 or XDJ-XZ with a USB
containing an exportLibrary.db, it delegates to onelibrary-connect for
library queries. This is invisible from the user’s perspective: from the
dashboard it still appears as a PRO DJ LINK source, but the heavy lifting
underneath uses the newer adapter.
What It Does Not Do
Section titled “What It Does Not Do”onelibrary-connect is a read-only query layer. It does not modify exports,
write back to the database, or enable Rekordbox-style sync. It is purely a way
to read the modern format so that Now Playing can work with Rekordbox 7 exports
the same way it worked with earlier .PDB exports.