Rekordbox import and export

Import from Rekordbox

Ora DJ reads the Rekordbox database on this computer. You don't export anything from Rekordbox first.

Open Settings, then Library, then Import Rekordbox. Ora DJ finds the database on its own:

• macOS: ~/Library/Pioneer/rekordbox
• Windows: %APPDATA%\Pioneer\rekordbox

If your database is somewhere else (an external drive, a second library), click Change and point it at the folder that holds master.db.

Ora DJ reads from a copy of the database and never writes to it. Nothing in Rekordbox changes.

Choose what to import

The first step is a tree of everything in your Rekordbox library. Tick what you want to bring across:

• Music Library: every track, with the total count.
• Playlists: your folders and playlists, in the same hierarchy as Rekordbox. Tick a folder to take everything inside it, or pick individual playlists. Tracks used by a playlist you select come in even if you leave the Music Library unticked.
• Tags: your My Tag groups (Genre, Mood, and so on).

Smart playlists are marked smart (see Smart playlists below).

Choose how it merges

The second step decides how the import meets your existing Ora DJ library:

• Import new tracks: brings in tracks that aren't in your library yet.
• Update tracks: also updates tracks you already have. Under it you choose what to overwrite: the BPM and cues, the key, and the rating.
• Import new playlists and Update playlist tracks by playlist name and folder location.

What gets imported

Per track: the BPM, the key, hot cues (up to eight), memory points (up to ten), the rating, play count, and comments. The Rekordbox track ID is kept too, so the same tracks line up if you export back later.

Your My Tag structure comes across in full: the groups (Genre, Mood, and the rest), the tags inside each one, and which tracks carry them. This is the part a Rekordbox XML file leaves out.

Ora DJ builds its own beatgrid from analysis. The database holds the BPM and cue positions but not the grid itself, so cues settle onto the Ora DJ grid once a track is analyzed.

Smart playlists

A Rekordbox smart playlist is built from rules, like "genre is House" or "rating is 4 or more". Ora DJ reads the rules and brings in the tracks that match right now as a normal playlist. It's a snapshot: run the import again to refresh it. A rule it can't read (some date and range conditions) is listed in the summary and left out.

How tracks are matched

Each Rekordbox track is matched to one in your library in order of confidence: exact file path first, then file name, then artist and title, then duration within two seconds. If a match is genuinely ambiguous, the import stops and lists the tracks rather than guessing.

Import from a file instead

If Rekordbox is on another computer, import a Rekordbox XML file instead. In the import window, click Import from XML instead. Export the file from Rekordbox first: open File, choose Export Collection in xml format, and save it. Then pick that file in Ora DJ. The merge options and matching work the same way.

Export to Rekordbox

Ora DJ writes a Rekordbox XML file. You can export your whole library or a single playlist.

• Whole library: open Settings, then Library, then Export as Rekordbox XML. This writes every track and playlist, with your folder hierarchy intact.
• One playlist: right-click the playlist and choose Export. Only that playlist's tracks go in the file.

The file saves through the system save dialog, with a default name of ora-dj-rekordbox.xml.

Keep it in sync automatically

Instead of exporting by hand each time, point Ora DJ at one file and let it stay current. In Settings, open Library and find Save library as Rekordbox XML. Choose a location to turn it on. The file is written right away, then rewritten within about five seconds of any change: cues, ratings, tags, playlists, metadata.

• The file holds the full library, the same as a manual export.
• It also saves when the Ora DJ window loses focus and when you quit.
• During a library scan or analysis run, the automatic save waits and writes once after the run finishes.

The panel shows the file path and the last save status. The Export as Rekordbox XML button still works for a one-off copy somewhere else.

What gets exported

Per track: the title, artist, album, and genre, the BPM and beatgrid, the key in Camelot, hot cues and memory cues (with their loop endpoints, colors, and names), the rating, play count, comments, and file details like bitrate, sample rate, and duration. Your playlist folder structure is preserved.

Load it into Rekordbox

Rekordbox reads an XML library as a separate source you point it at: