A command-line app for converting data files to and from different DJ software formats, such as Traktor, Rekordbox and Serato DJ.
In addition to an automated test suite comprising specification-driven tests on expected input and output data, this app has been manually tested with Traktor Pro 2 and Rekordbox 5.7.0 on Windows 10.
Feature | Basic Edition | Pro Edition |
---|---|---|
Convert from Traktor to Rekordbox | Yes | Yes |
Convert from Rekordbox to Traktor | Yes | No (1) |
Convert tempo (BPM) and beat grid | Yes | Yes |
Convert cue points and loops | Yes | Yes |
Convert multiple beat grid markers | Yes | Yes |
Correct 26ms grid offset when converting mp3 files | Yes | Yes |
Convert unsupported Traktor cue types using a colour mapping | Yes | Yes |
Convert playlists | No | Yes |
Runs on Windows | Yes, download here | Yes |
Runs on Mac | Yes, download here | Yes |
Price | FREE! | Contact me for pricing |
(1) Will be released in a new version TBA
Unlike other apps for handling this task, this app is open source and available on Windows, in addition to Mac OS.
Download the Basic Edition from the releases page as a zip or tar.gz archive, and then extract the archive into a directory.
To download the Pro Edition, please contact me for pricing.
cd <download-dir>
Now execute the app, providing the location of the Traktor collection file, or an exported Rekordbox collection file:
dj-data-converter-win.exe [options] <traktor-or-rekordbox-collection-file>
For example, assuming Traktor is installed in the default location on Windows:
dj-data-converter-win.exe "C:\Users\<your-user-name>\Documents\Native Instruments\Traktor <version-number>\collection.nml"
A converted rekordbox.xml
or collection.nml
file will be created in the current directory.
If the conversion fails due to an error, an error-report.edn
file will be created, also in the current directory.
cd <download-dir>
Now execute the app, providing the location of the Traktor collection file, or an exported Rekordbox collection file:
./dj-data-converter-macos [options] <traktor-or-rekordbox-collection-file>
For example, assuming Traktor is installed in the default location on Mac OS:
./dj-data-converter-macos "/Users/<your-user-name>/Documents/Native Instruments/Traktor <version-number>/collection.nml"
A converted rekordbox.xml
or collection.nml
file will be created in the current directory.
If the conversion fails due to an error, an error-report.edn
file will be created, also in the current directory.
-h, --help
View
and under Layout
enable rekordbox xml
Advanced
Database
and under rekordbox xml
change Imported Library
to the location of the generated rekordbox.xml
filerekordbox xml
entry should now be visible in the tree lower-left.rekordbox xml
icon in the tree and select the All Tracks
entryImport to Collection
as normal.Back up any existing collection.nml
file. The location of this file will depend on whether the app is being used on Windows or Mac:
OS | File Location |
---|---|
Windows | C:\Users\<your-user-name>\Documents\Native Instruments\Traktor <version-number>\collection.nml |
Mac | /Users/<your-user-name>/Documents/Native Instruments/Traktor <version-number>/collection.nml |
collection.nml
file to the above location, overwriting the existing file.Analyze (Async)
, and tick Special
, Key
and Gain
, and untick BPM
.This app is mostly concerned with availability, correctness and transparency, for which a command-line app is more than adequate.
However, usability is important, and lack of familiarity can be an problem for command-line apps; this will be addressed in good time!
Donations for the Basic Edition are most welcome! Becoming a sponsor will help to support more DJ software formats, add new features, improve performance and fix bugs.
[djdc]
. These tagged cues will be removed when converting from Rekordbox back to Traktor.The cue point types are mapped as follows:
Traktor Type | Traktor Colour | Rekordbox Type | Rekordbox Colour |
---|---|---|---|
Cue | Blue | Cue | Green (default) |
Fade-in | Orange | Cue | Pink |
Fade-out | Orange | Cue | Pink |
Load | Yellow | Cue | Yellow (unchanged) |
Grid | White | Cue | White (unchanged) |
Loop | Green | Loop | Orange (default) |
[djdc]
. These tagged cues will be removed and re-created as tempos, when converting from Traktor back to Rekordbox.The hot cue and memory cue types are mapped as follows:
Rekordbox Type | Traktor Type |
---|---|
Cue | Cue |
Loop | Loop |
Field | Traktor | Rekordbox | Copied? |
---|---|---|---|
Album Title | Title | Album | Yes |
Artist | Artist | Artist | Yes |
Bpm | Bpm | AverageBpm | Yes |
Comments | Comment | Comments | Yes |
Date Added | Import Date | Date Added | Yes |
Genre | Genre | Genre | Yes |
Label | Label | Label | No |
Total Time | Playtime | Total Time | Yes |
Play Count | Playcount | Play Count | No |
Track Number | Track | Track Number | Yes |
Track Title | Title | Name | Yes |
Year | Release Date | Year | No |
Please report any possible bugs as GitHub issues in this project, and remember to include the steps performed, what was expected and the actual result. If an error occurred during the conversion, please attach the generated error-report.edn
file.
To see planned and upcoming features, refer to the Unreleased
section at the top of the Changelog.
Requests are welcome, please create them as GitHub issues in this project. However, before creating any new requests, please check the Unreleased
section at the top of the Changelog first, to see if the feature is already planned for.
Developers will need to install Java, NodeJS and the Clojure command line tools.
clj -Adev:test-cljs
clj -Adev:nrepl-server
Copyright © 2018 Digital DJ Tools
Released under the MIT license.