What we read from your files
You can upload an export from your DJ software, a CSV, or your audio files directly. Here is exactly what each format carries — and which columns a CSV needs, which is the most flexible option because almost any tool can produce one.
Formats
| Format | What it carries | Relinks files |
|---|---|---|
| Traktor NML | Everything: BPM, key, genre, energy, length and the file path. Your hotcues, comments and tags come back untouched on export. | Yes |
| Rekordbox XML | Everything, same as NML — including memory cues and ratings on the way back out. | Yes |
| CSV | Whatever columns you give it — see the table below. The most flexible option, and the one almost every tool can produce. | Yes |
| Rekordbox TXT | BPM, key, genre and length. Rekordbox' own TXT has no file path, so a native re-export can't relink. | No |
| M3U8 / M3U | File paths and track lengths. That is all the format has — there is no BPM, key, genre or energy in an M3U8, so there is nothing for us to read. | Yes |
| Audio files | Read straight from the tags in your files. Your audio never leaves your computer — only the parsed metadata. | No |
CSV columns
Column order doesn't matter: we resolve them by header name and accept several names for each. Row order is play order. Accents are fine.
| Field | Header names we accept | |
|---|---|---|
| Titlerequired | Title · Track Title · Name · Song · Título · Canción · Tema | The only column we insist on. A row with no title isn't a track. |
| Artist | Artist · Artists · Artista | Optional: plenty of exports put "Artist - Title" in one column. |
| BPM | BPM · Tempo | Decimals are fine. A comma decimal separator is read too. |
| Key | Key · Tonality · Camelot · Open Key · Tonalidad · Clave | Any notation — Camelot, Open Key or musical. We convert. |
| Energy | Energy · EnergyLevel · Energía | 1 to 10. A bare number is fine in this column. |
| Genre | Genre · Style · Género | Used to detect the set's dominant genre. |
| Length | Time · Duration · Length · Duración · Tiempo | "5:17" or plain seconds. |
| File path | Location · Path · File · Filename · Ruta · Archivo | Worth including: it's what lets a CSV import export back to Rekordbox or Traktor and still find your files. |
| Comment | Comment · Comments · Grouping · Comentario | Read for an energy value when there's no Energy column. |
The fastest reference
Export any EnergyCurve playlist as CSV and look at the header: that file is exactly what the importer reads back. If your tool can produce those columns, it imports as-is.
Commas or semicolons
Both work. If you open a CSV in Excel on a Spanish or German locale and save it again, you get semicolons back — we read those too. A title with a comma in it needs quotes around it, which is what every export already does.
Common questions
Which format should I export?
Traktor NML or Rekordbox XML if your software writes one: they carry BPM, key, genre, energy, length and the file path, which is everything the analysis can use. CSV is the most flexible and almost every tool produces one. M3U8 carries only file paths and lengths, so there is nothing in it for us to read beyond the order.
What is the minimum a CSV needs?
A title column. That is the only one we insist on — a row with no title is not a track. Everything else (artist, BPM, key, genre, energy, length) is optional and simply gives the analysis more to work with. Row order is play order.
Does the column order matter?
No. Columns are resolved by header name, not by position, and several spellings are accepted for each one — the table above lists them, and they are the same synonyms the importer actually matches against. Accents are fine.
My CSV uses semicolons instead of commas. Is that a problem?
No, both work. Opening a CSV in Excel on a Spanish or German locale and saving it gives you semicolons, and we read those too. A title containing a comma needs quotes around it, which is what every export already does.
Moving a playlist between programs
This page says what each format carries. The journeys — from where to where, and what survives — each have their own article:
This page covers what each format carries. If it is energy that is missing, see which tag we read it from.
See your set's curve, free
No account, and nothing uploaded anywhere: the analysis happens in your browser.
Open the tool →