With rekordbox

Supported version

The officially supported version of rekordbox is currently rekordbox 5.7.0. While other versions of rekordbox may still work with Rekord Buddy, they are not officially supported.

Viewing your rekordbox collections

Unfortunately for rekordbox users, the app is currently the least intuitive to use with Rekord Buddy. Unlike with the other DJ apps, Rekord Buddy uses a XML bridge file to communicate with rekordbox instead of being able to directly modify its collection. This means you have some setup to do before being able to use rekordbox with Rekord Buddy.

If rekordbox is detected the first time you launch Rekord Buddy, you will see an empty rekordbox collection in the sidebar.

To view or edit a rekordbox XML file located in a custom (non-standard) location, drag the XML file directly from Finder to right below the very last line in the Rekord Buddy sidebar. The cursor should turn into a + indicating that the collection can be opened. Drop the collection file and that collection will be opened from the custom location. From that point on, Rekord Buddy will remember this collection and alway open it when you launch the app.

If you'd like to remove a custom-location collection just select it in the sidebar and press delete or right click and choose Remove this Collection. Note that removing a custom location collection from Rekord Buddy doesn't actually delete the collection file itself, it only removes it from the collection list in the Rekord Buddy sidebar.

Exporting your rekordbox collection

When you first use Rekord Buddy with rekordbox, and every time you make changes in rekordbox that you'd like to see propagated in Rekord Buddy, you will need to export your rekordbox collection to an XML file that Rekord Buddy can use.

Follow the following steps:

BPM change points tells rekordbox to export the track’s beatgrid
  1. In rekordbox, go to Preferences, then Advanced and in the rekordbox XML section make sure Export Beatgrid Information is set to BPM change points. This ensure your beatgrid will be part of the exported data.

  2. In the rekordbox menu, go to File -> Export collection in XML format, and save the file somewhere you’ll remember (such as your Documents folder). You can name the file however you wish, as long as it has the XML file extension.

  3. Once the file has exported, locate it in Finder.

  4. Launch Rekord Buddy, and click on the little disclosure triangle next the the main rekordbox collection (the one named simply rekordbox) to make sure it is open.

  5. Drag the XML file from Finder on to the the rekordbox collection header in the Rekord Buddy sidebar (the one with the triangleto expand it).

  6. Reply Yes to the dialog asking if you want to update the current rekordbox bridge collection.

Importing your changes to rekordbox

Rekord Buddy cannot write any information directly into rekordbox. Changes are only reflected in the rekordbox XML file that Rekord Buddy manages for you. You will then need to import those changes yourself from that file, into the rekordbox collection itself.

Certain versions of rekordbox have shipped with bugs causing the XML bridge to not import changes to tracks. Make sure you are running the currently supported version of rekordbox in order to avoid this issue.

First you have to make sure the rekordbox XML bridge is visible in rekordbox and that it it pointing to the same file that Rekord Buddy is modifying for you.

Tick the rekordbox XML option in the Layout section.
  1. In rekordbox, go to Preferences, View and in the Layout section, make sure rekordbox XML is ticked.

  2. Now, go to the Advanced tab. Ensure that the Imported Library file path is set as default (delete the current path to be sure). The XML collection will appear in rekordbox's browser as rekordbox XML.

  3. Close the Preferences and expand the rekordbox XML section of the browser tree.

  4. To add single tracks to your main rekordbox collection, select All Tracks from the XML tree, right click the desired track and select Import to collection.

  5. To add a whole playlist, repeat step 4 on a playlist.

  6. Alternatively, you can drag and drop files or playlists into the main collection.

Make sure the Imported Library XML path is default

If you try to add one or more tracks that already exist in the collection, you will get the message below. Click Don’t ask me again and then Yes to make sure the most up-to-date track information is transferred.

You’ll get this warning if rekordbox detects that a track is already in your collection

rekordbox may start analyzing new tracks to generate the waveform it uses on your laptop and on CDJs. Make sure you wait for this to finish before closing the app otherwise it will loose the BPM value for these tracks when you reopen it.

It should only need to do this once when the track is first imported to the collection. Subsequent imports should ask Do you want to overwrite metadata? and after saying "yes", no more analyzing should take place.

Please note that this step is necessary so disabling auto analysis in the rekordbox preferences is not recommended. rekordbox needs some of this info in order to display cue points and beatgrid correctly.

These are the only valid steps to import tracks back into rekordbox. Dragging tracks from the iTunes bridge, drag and dropping from the desktop, or anything else will not import the metadata generated by Rekord Buddy (cue points, beatgrid, etc...)

You can import all the playlists by right clicking on Playlists in the rekordbox XML section of the browser tree and selecting Import Playlist.

rekordbox preferences

Duplicate hotcues as memory cues when writing to rekordbox

All track hotcues will also be exported to the rekordbox XML as memory cues. This is helpful for hardware-specific limitations.

Maximum number of hotcues written to rekordbox

Sets whether to save three, four or eight cue points for your tracks. This is helpful for hardware-specific limitations. Extra hotcues will be output as memory cues.

When reading from rekordbox never read more than number of grid markers

rekordbox can generate a lot of grid markers in dynamic mode. This can help limit the number of markers imported so that the tracks do not display with thousands of markers in apps like Traktor.

Metadata support

Things that are not supported at all

Tags. rekordbox does not have an equivalent field to copy this value to/from.

Grouping. rekordbox does not have an equivalent field to copy this value to/from.

Rating. Serato does not have an equivalent field to copy this value to/from.

Smart Playlists. Those are not currently being read from of written to. Smart playlists from Rekord Buddy itself will be converted to regular playlists when written to rekordbox.

Things that are partially supported (with caveats)

Date Released. rekordbox does read dates released from MP3 and AIFF files if it is missing from its database.

Grid Markers. If rekordbox is set to ‘dynamic’ mode for analysis this can potentially create too many grid markers for other apps to handle. Use the Preferences setting to ignore tracks with more than a certain number of grid markers.

Cue Markers. rekordbox can support 3, 4 or 8 hotcues for loops and cues depending on the hardware you use to playback. Use the Preferences setting to make sure only the number of hotcues you need get exported to rekordbox. Other hotcues will be converted to memory cues on export.

Memory Cues. rekordbox only supports a maximum of 10 memory cues, so all extra cue points transferred from other software will be not be exported to rekordbox.

Track and Marker colors. Rekord Buddy will try to use the closest match to the source colors when writing those to rekordbox. It may not be an exact match.

Artists, Remixers, Producers and Genres. Rekord Buddy treats these properties as multiple values but reads/writes it as one value using separators selected in the Preferences.

Musical Keys. Key values are always written to rekordbox according to the musical notation set in the Preferences. Rekord Buddy treats this property as multiple values but reads/writes it to rekordbox as one value using a separator selected in the Preferences.

Folders. rekordbox allows folders to contain multiple playlists or folders with the same name but different case. This is not supported in Rekord Buddy and only the first one listed will be parsed.

Analysis Lock. This only prevents Traktor from analyzing the track but Rekord Buddy ignores it and still modifies the BPM and beatgrid during copying. rekordbox does not ignore it though, if this flag is set then changes coming from the XML bridge will be ignored.

Playlists. Rekord Buddy does not support duplicate tracks in playlists. Those will be ignored when reading from rekordbox.

rekordbox FAQ

Track data does not update when importing tracks in rekordbox

Make sure you are running the officially supported version of rekordbox and that you are following the steps details inthe section Importing Changes to rekordbox. Additionally, make sure the track does not have analysis lock set to on as this will cause rekordbox to ignore some of the imported metadata.

Why is rekordbox analyzing my tracks again when importing?

Most likely it’s not re-analyzing the track. If you are importing the track for the first time it’s generating the waveforms it needs to play the tracks back. So it’s not recalculating the beatgrid but just doing some internal stuff.

How do I backup my rekordbox collection?

If you actually want to back up your rekordbox library and all the music, click File > Library > Backup Library. You will be prompted that it will take a while, click OK. The next pop-up window you’ll see will ask you if you want to backup your music as well.

Click Yes, then you’ll be prompted with a browser window asking you to select the location (and rename it if you want).