Use Euphoria with your DJ program
Euphoria brings its keys, tempos and energy ratings into a DJ program in one of these ways:
- Tags.
euphoria tags write --preset <program>writes them into the files’ own tags, which the program reads when it imports a track or reloads its tags. See write tags into your files. - rekordbox XML.
euphoria export rekordboxwrites a library file that rekordbox and Engine DJ can import. Your audio files are not changed. See export to rekordbox. - Traktor NML.
euphoria export traktorwrites a collection file that Traktor imports, with beat grids and cue points if you ask. See export to Traktor. - Engine DJ library.
euphoria export enginewrites key, tempo, beat grid and cues into the tracks of your Engine DJ library, after saving a copy. See export to Engine DJ. - VirtualDJ database.
euphoria export virtualdjwrites key, tempo, beat grid, cues and energy into the songs of your VirtualDJ database, after saving a copy. See export to VirtualDJ.
DJ program support has a table of what each program receives by each route, and which were tested in the program.
No DJ software vendor publishes which tag fields its program reads. What this page says about each program comes from the program’s own manual where it says anything, from the source code of programs that read the same files, from the names stored inside the rekordbox application, and from user reports. Each statement is marked:
| Mark | Meaning |
|---|---|
| Confirmed | Stated by the vendor, or visible in the program’s own source code. |
| Reported | Stated by another vendor’s guide, such as Mixed In Key’s, or by user reports, or suggested by the names stored inside the program, and not contradicted. |
| Tested | Checked in the program itself with the test kit. |
| Unconfirmed | Sources disagree, or nothing was found. |
The rekordbox facts marked Tested were checked in rekordbox 7.2.19 on macOS 27 on 11 November 2026, with the test kit described below and automatic analysis switched off. Other versions may behave differently; the kit lets you check yours. The other presets have not yet been tried in the program they are named after.
The same in every program
Every preset writes these fields. The key is written in the notation you choose: a Camelot code (8A, the default), a musical name (Am) or an Open Key code (1m).
| MP3, AIFF and WAV (ID3v2) | M4A and MP4, AAC or ALAC | FLAC and Ogg Vorbis | |
|---|---|---|---|
| Key | TKEY |
----:com.apple.iTunes:initialkey and ----:com.apple.iTunes:KEY |
INITIALKEY, and KEY when the file already has one |
| Tempo | TBPM |
tmpo |
BPM |
| Label | COMM, such as 8A - Energy 7 in front of your comment, and in WAV also the RIFF INFO comment ICMT |
©cmt |
COMMENT |
Why these choices:
- Two key fields in M4A. rekordbox reads the key only from
KEY(tested), the other programs are reported to readinitialkey, and no program is known to misread a file that has both. Most of a typical library is M4A, so this is the field that matters most. - The codec does not change the fields. An ALAC file and an
.mp4file carry the same MP4 atoms as an AAC file in.m4a, and an Ogg Vorbis file the same Vorbis comments as a FLAC file, so each gets the same fields. Mixxx reads them the same way (confirmed in its source code). For the other programs, what is known about M4A and FLAC is assumed to hold for these formats too, which is unconfirmed: no source looked at them separately. - No new
KEYin FLAC. VirtualDJ is reported to read neither field when a FLAC file has both. When a file already has aKEY, left by another program, Euphoria gives it the same value, so the two never disagree. - Whole number tempos. Only Mixxx is known to read a tempo with decimals. Every preset except Mixxx writes
128, not127.6. A tempo with decimals belongs in the rekordbox XML, which keeps two. - The energy rating is in the comment. No program has a tag field for it. The label
8A - Energy 7has the form Mixed In Key writes, so sorting and searching on it works the same way. - WAV is the weakest case. Euphoria writes an ID3 chunk into WAV files, as most tag editors do. rekordbox shows the title and comment from a WAV file’s RIFF INFO list, not from its ID3 chunk (tested), so Euphoria also puts the label into the RIFF INFO comment,
ICMT, in front of the comment already there, with every preset. RIFF INFO is the tag WAV defines for itself, and a program that does not read it ignores it. RIFF INFO has no key or tempo field, so those stay in the ID3 chunk. Serato’s staff have said WAV holds no tags for Serato, and Mixed In Key does not tag WAV at all. For the key and tempo of WAV files in rekordbox, use the rekordbox XML, or convert the files to AIFF.
Formats each program plays
A tag only helps in a program that plays the file. What each program plays, as far as the sources go:
| Program | ALAC | AAC in .mp4 |
Ogg Vorbis |
|---|---|---|---|
| rekordbox | .m4a only. Confirmed by the rekordbox 7 manual. |
Confirmed by the manual. | Not listed in the manual, which lists the formats it plays, and its tag list leaves Ogg out too. Treat Ogg Vorbis as not playable in rekordbox. |
| Serato DJ | Unconfirmed | Unconfirmed | Reported: Serato keeps its own cue and grid data in Ogg Vorbis files, in comments named serato_*, according to the open source readers of that data. |
| Traktor | Unconfirmed | Unconfirmed | Unconfirmed |
| Engine DJ | Unconfirmed | Unconfirmed | Unconfirmed |
| VirtualDJ | Unconfirmed | Unconfirmed | Unconfirmed |
| Mixxx | Its source code reads the tags of M4A and MP4 files (confirmed). Playback was not looked at. | As for ALAC | Its source code reads Ogg Vorbis tags with the same fields as FLAC (confirmed). Playback was not looked at. |
“Unconfirmed” here means only that the research behind this page did not look at it; check your program’s own list of supported formats. A track in a format your program cannot play is still analyzed and tagged by Euphoria, and euphoria export rekordbox still lists it, which matters for Engine DJ, the other program that imports a rekordbox XML file.
rekordbox
--preset rekordbox writes the fields above.
What to set in rekordbox:
- Preferences > Analysis > Track Analysis > Track Analysis Setting: untick KEY, so that rekordbox’s analysis does not replace Euphoria’s key. Tested: with KEY ticked, analyzing a track replaced the key it had been given, and the tempo too. Leave BPM / Grid ticked if you want rekordbox’s own beat grid, knowing that its analysis then sets the tempo. This is what Mixed In Key tells its users.
- Leave Preferences > Analysis > Key Analysis > Write the value to the ID3 tag off, or rekordbox writes its own key over Euphoria’s. Confirmed by the manual.
- For tracks already in your collection, select them, right click and choose Reload Tag. rekordbox reads tags when a track is added and on Reload Tag. Confirmed by the manual.
Reload Tag replaces information you edited inside rekordbox with what the file says, comments included. Confirmed by the manual.
| What | Status |
|---|---|
Key from TKEY in MP3 (ID3v2.3 and 2.4) and AIFF |
Tested: read when the track is added. |
| Key from M4A | Tested: read from ----:com.apple.iTunes:KEY. A file with only initialkey shows the text in the Alphanumeric display but no key in the Classic display, so rekordbox does not take it as a key. Euphoria writes both names. |
| Key from FLAC | Tested: read from INITIALKEY. A file with only KEY shows no key. |
Key from ALAC and .mp4 files |
Unconfirmed: the tests used AAC in .m4a. These files hold the same atoms, so the result is expected to be the same. |
| Title and comment from WAV | Tested: read from RIFF INFO, not from the ID3 chunk. Euphoria writes the label into the RIFF INFO comment too. That rekordbox shows a comment written by Euphoria is unconfirmed: test T11 of the kit checks it. |
Tempo from TBPM, tmpo and FLAC BPM |
Tested: not read when a track is added; the BPM column stays empty until rekordbox analyzes the track. Use the rekordbox XML to hand rekordbox a tempo. |
8A, Am and 1m in a key tag |
Tested: all three are recognised as keys and shown in the display format you chose. Display key information on the database shows the text as written. |
Comment from COMM, M4A ©cmt, FLAC COMMENT and AIFF |
Tested: read when the track is added. |
The rekordbox XML is the route Pioneer documents for handing rekordbox a key, a tempo with decimals and a comment, for any format, and the only one that brings in a tempo. Tested: a new track imported from the XML gets its key, its tempo with decimals and its comment. For a track already in your collection, importing only a playlist changes nothing, while Import To Collection on the track replaces its key, tempo and comment. Export to rekordbox has the steps.
euphoria export rekordbox --beat-grid also writes a beat grid for each track whose grid is rated medium or high, so rekordbox needs no grid analysis of its own for it. Unconfirmed: Import To Collection on a track already in your collection is expected to replace a grid or cue points you set by hand there with what the file holds; the test covered key, tempo and comment, not grids or cues. Try it on a few tracks first. --cues adds cue points at the sections of each track, and leaves tracks that already have cues in your collection out of the file entirely, reading them from a collection you export from rekordbox; see export to rekordbox.
Check it yourself in rekordbox
The repository has a script that builds a test kit: a few short clips, each tagged one way, a rekordbox XML file, and a ten minute checklist with a table to fill in. It answers the questions above for your rekordbox version.
cargo build --release -p euphoria-cli
uv run bench/rekordbox_test_kit.py --clips bench/data/key/audio --output /tmp/euphoria-kit
It needs uv, ffmpeg, a release build of Euphoria, which tags one of the WAV files, and the benchmark clips from ./bench/download_datasets.sh. It reads the clips and writes only into the new folder. Back up your rekordbox library before you follow the checklist; it ends with how to remove the test tracks again.
Serato DJ
--preset serato writes the fields above, except the tempo, unless you add --tempo. Serato does not run its own tempo detection on a file that already has a tempo (confirmed by Serato), so a tempo written by Euphoria would stand in for Serato’s own and Serato would build no beat grid from its analysis.
What to set in Serato:
- In the analysis options, untick Set Key before analysing, so Serato keeps Euphoria’s key. Leave Set Beatgrid / BPM ticked. Confirmed by Serato.
- Choose how keys are shown in Setup > Library + Display: Camelot, Open Key, musical, or Original Tag, which shows the text exactly as written. Confirmed by Serato.
- For tracks already in your library, use Rescan ID3 Tags in the Files panel. Confirmed by Serato.
| What | Status |
|---|---|
| Key from the ID3 key field in MP3 | Confirmed by Serato’s staff, who do not name the frame; TKEY is the frame the ID3 standard has for it. |
Comment shows the 8A - Energy 7 label |
Reported: Mixed In Key’s guide shows its label in Serato’s Comment column. |
Key from M4A (initialkey) |
Unconfirmed: stated in a comment in Mixxx’s source code only. |
| Key from FLAC | Unconfirmed, with old reports of FLAC key bugs. |
| Key from Ogg Vorbis | Unconfirmed |
| Key and tempo from WAV | Not read: Serato’s staff said WAV holds no tags for Serato. |
Whether a key written as 8A or 1m is converted for display and Key Sync |
Unconfirmed. Original Tag always shows it. |
For cue points and a beat grid, add --serato-markers: Euphoria writes them into the fields Serato keeps in the file, and keeps every cue and grid the file already has. Not tested in Serato. See cue points and beat grids for Serato.
Traktor
--preset traktor writes the fields above. With --key-notation open-key the key is written as Traktor writes its own, such as 1m.
The key Euphoria writes appears in Traktor’s Key Text column, not in the Key column, which holds only Traktor’s own analysis. Traktor shows the text unchanged, so a Camelot 8A stays 8A. Reported by Mixed In Key’s guide and by users.
What to set in Traktor:
- Preferences > File Management: set tag writing to write no tags, or only Traktor’s own tags. With all tags written, Traktor’s analysis can replace the key field with its own notation. Confirmed that the setting exists; the replacement is reported by users.
- When you import tracks, untick BPM and Key in the import dialog’s analysis options, or Traktor may rewrite the key and tempo fields of the files. Unconfirmed: one detailed user report for Traktor Pro 4.1.
- For tracks already in your collection, select them and run Check Consistency, as Mixed In Key advises. Users report that in Traktor Pro 4 this no longer refreshes every field. Unconfirmed.
| What | Status |
|---|---|
Key Text from TKEY in MP3 |
Reported |
Comment from COMM in MP3 |
Reported: a real Traktor collection file has the comment, though not where it came from |
| Key Text from M4A, MP4, FLAC and Ogg Vorbis | Unconfirmed |
| Tempo from tags when Traktor’s analysis is off | Unconfirmed |
For the key in Traktor’s own Key column, a tempo with decimals, a beat grid and cue points, use euphoria export traktor, which writes an NML collection file that Traktor imports with Import Another Collection. It never writes your own collection.nml. It fills MUSICAL_KEY, numbered 0 to 11 for the major keys from C upwards by semitone and 12 to 23 for the minor keys from C minor, checked against a real Traktor Pro 4 collection; Mixxx’s Traktor reader is one semitone off from this. Not tested in Traktor. See export to Traktor.
Engine DJ
--preset engine-dj writes the fields above.
What to set in Engine DJ:
- After writing tags, right click the tracks and choose Re-import track information. Confirmed by the Engine DJ user guide.
- Do not choose Re-analyze for those tracks: the guide says re-analysis uses Engine’s own BPM and key detection regardless of the tags. Confirmed.
- To bring in a tempo with decimals, use the rekordbox XML: Engine DJ’s Import Assistant reads a rekordbox XML file. A track that was imported before is not updated by a second import; remove it from the Engine collection and import it again. Confirmed by the guide, and users report the same.
| What | Status |
|---|---|
| Key from MP3 tags | Reported: users see Mixed In Key’s keys. The frame name is unconfirmed. |
| Whether the first analysis keeps a tagged key | Unconfirmed: users disagree. |
| Key from FLAC | Unconfirmed: reported missing in Engine 2.2.2. |
| Key from M4A, MP4, Ogg Vorbis, AIFF and WAV | Unconfirmed |
| Whether the key, tempo and comment of a rekordbox XML are imported, or the file’s tags | Unconfirmed |
VirtualDJ
--preset virtualdj writes the fields above.
What to set in VirtualDJ (in Options):
- Set
useKeyFromTagto yes, so the key in the tag is preferred over VirtualDJ’s own. Confirmed by the options list. - Consider setting
setTagsAutoto no. Users report automatic tag writing replacing keys written by other programs. Unconfirmed. getCommentFromTagscontrols whether the comment, and with it the energy label, is read. Confirmed.
VirtualDJ reads a tempo tag when it first meets a file, then replaces it with its own analysis, and has no option to prefer the tag (reported by VirtualDJ’s staff and users). Writing the tempo does no harm, but it does not last.
| What | Status |
|---|---|
Key from FLAC INITIALKEY and KEY |
Confirmed by VirtualDJ’s CTO, who said both are read and KEY wins when both exist. One user reports neither being read when both exist, which is why Euphoria never adds a KEY and keeps an existing one equal. |
| Key from MP3 | Reported: users see Mixed In Key’s keys. The frame name is unconfirmed. |
| Key from M4A, MP4, Ogg Vorbis, WAV and AIFF | Unconfirmed |
Mixxx
--preset mixxx writes the fields above, keeps up to two decimals in the tempo, and adds ----:com.apple.iTunes:BPM with decimals in M4A next to tmpo, which can hold only whole numbers. Everything in this section is confirmed in Mixxx’s source code.
- Mixxx reads every field Euphoria writes, both key names in M4A, MP4, FLAC and Ogg Vorbis, Camelot, Open Key and musical notation, and Camelot with a leading zero. Ogg Vorbis files are read with the same fields as FLAC.
- A track that already has a key is not analysed for its key again.
- Mixxx does not notice tag changes made by another program on a rescan. Select the tracks and choose Metadata > Import From File Tags.
- Mixxx does not read tags from WAV files beyond RIFF INFO, which has no key or tempo.
Generic
--preset generic, the default, writes the fields above with a whole number tempo, and in M4A adds ----:com.apple.iTunes:BPM next to tmpo. It is the choice when you use several programs.
Sources
The research behind this page lists every source for each statement: the rekordbox 7 manual and Pioneer’s XML format description, the strings stored in rekordbox 7.2.19, the Serato, Native Instruments, Engine DJ and VirtualDJ documentation, the source code of Mixxx, libdjinterop, pyrekordbox and dj-data-converter, Mixed In Key’s integration guides, and user reports on each vendor’s forum. Where those sources disagree, this page says so.