TraCoConverter – Manual (Introduction, FAQ's, Release Notes)

last Update: Sept. 4, 2017

 


Introduction

What is TraCoConverter ?

How to use TraCoConverter ?

 

FAQ’s  

TraCoConverter System requirements

Is Mac OS X supported ?

Do I need Traktor Pro, itunes or any songs on the TraCoConverter PC ?

Where can I find the collection.nml of Traktor Pro (Mac or PC) ?

Where can I find the collection.nml of Traktor DJ (iOS) ?

Some details to the new generated files

How to transfer Traktor metadata into the iOS app ‘DJ Player Pro’ ?

TraCoConverter File Viewer

What is TraCoMerger and how does it work together with TraCoConverter ?

Contact for further questions, ideas, comments

 

Release Notes

  


Introduction

 

What is TraCoConverter ?

TraCoConverter is a PC Windows application to export and convert Traktor song collection meta data (bpm, grid, hot cues, musical keys) into new file formats. Primary use case: get an overview about all hot cue points of all songs in the Traktor song collection or (NEW) transfer all data into the file format for other DJ applications.

Version 1.0 (named TraCoAnalyzer) supported the file formats TXT, CLV and XLS: TraCoConverter converts the Traktor collection.nml (from Traktor Pro on Mac or PC, or from TDJ app on iOS) into new files: TXT text file, CSV text file, and most useful a XLS (Excel) spreadsheet. The files present all important meta data, e.g. song grid, bpm, musical key, 1-8 hot cue points etc.. The .xls spreadsheet is pre-formatted with a coloured cue matrix: blue (single), green (loop), Fade In/Out (red) etc. You can scroll through the spreadsheet, filter columns, sort or printout any data.

Version 2.x (renamed to TraCoConverter) supports in addition the file format of the iOS app DJ Player Pro (DJPP). You can convert any Traktor collection directly into a DJPP compatible database file. If you import this file into DJPP then all Traktor data will transferred, all metadata will appear directly in DJ Player Pro.

Future plans: Maybe I will try to support additional formats, e.g. Record Box. But even the existing csv/xls and the new db format will allow technical folks to write an own application to transfer the csv or db file in their favorite DJ app. Even if you do not use DJ Player Pro, the .db file could be useful, it is an open source SQLite format, so quite easy to use as input for further usage (see details below).

Some background to the history: Many Traktor Pro and Traktor DJ user spent a lot of time in cueing of songs, so I thought about an option to get an overview of all this work, I also wanted to see at a glance which songs are still un-cued. TraCoConverter was primary build for TDJ (Traktor DJ on iOS), because TDJ does not offer any kind of export an overview about the track collection. It is also useful for Traktor Pro user, because TPro does support reports, but still missing hot cue meta data information in reports. Since version 2.0 I can utilize my spent time (in cueing of thousands of songs) also for other DJ applications. My personal workflow: I always define grids and cues in TDJ or Traktor Pro only. This allows me to have one master. I also check my work with an xls overview regularly. And I can transfer all updated data whenever I need ... outside of the NI Traktor world, using e.g. in DJ Player Pro.

TraCoConverter can read all kind of Traktor song collection files, Traktor Pro files from Windows PC or from Mac and also Traktor DJ (iOS). Be aware, the application itself is a Windows application, but can also convert Mac Traktor collection.nml files.

 

How to use TraCoConverter ?

The workflow is quite simple. First you need your “collection.nml” file from your Traktor collection. All Traktor versions (Traktor Pro and Traktor DJ) store the analyzed meta data of the Traktor song collection in a file named “collection.nml”. Traktor Pro stores "collection.nml" locally in the Traktor root folder, easy to find (see below). Traktor DJ is an iOS app, you will not find any collection.nml in iTunes file sharing, but it is quite easy to generate a collection.nml using TDJ’s sync feature (see below). In both cases: Search for the collection.nml file, then store a copy on the PC and convert this file using TraCoConverter.

Start TraCoConverter on the PC to convert. Good news: Use any PC, it must not be the PC/Mac with your itunes mediathek or your songs, the only file you need on this PC is your "collection.nml". Press button “Browse” to search for your "collection.nml” or drag/drop the file into the input field. Click button “Create Files” and wait ... TraCoConverter will create addition files: .txt, .csv, xls, db. DONE, that’s all.

You can view your new files with the integrated file viewer (select menu “View Files”) or exit the application and use the new files for any further usage.

TraCoConverter generates new files:

 

Summary: TraCoConverter reads your “collection.nml” and creates new additional files for further usage. TraCoConverter does not change anything in your original “collection.nml”, its opens in Read-Only mode. Use the application whenever you need an updated hot cue overview of your current song collection or if you want to export all updated data into other applications.

MAC user: TraCoConverter itself is a native Windows application, so will not run on a Mac OS X. But TraCoConverter can analyze also collection.nml files from your Traktor Pro on Mac, more details see FAQ’s below.

 


FAQ’s  

 

TraCoConverter System requirements

TraCoConverter runs on Microsoft Windows 7 (or later), 32 or 64 Bit. Also a parallel Windows 7 Installation on Mac works, confirmed from several Mac user. I do not have any experiences with Windows simulations on Mac (e.g. Wine with .NET framework), feel free to test and send me back your feedback.

Microsoft .NET Framework (3.5 or higher) is always needed. Actual Windows versions include .NET already, no addition installation necessary. If you start TraCoConverter and an application error or .NET warning occurs, then update your Windows with .NET first. Use any of the official MS Update links, e.g.: Microsoft .NET Framework (Web Installer)

Windows XP is not longer supported from MS, but works also with TraCoConverter, if (!) latest XP update packages (including actual .NET 3.5) were installed before the MS Windows XP support ended.

If you want to create an XLS file you need in addition MS Excel to create this file. You do not need Excel to create the TXT, CSV or DJPP DB files.

TraCoConverter is a portable direct run application. Copy the content of the .zip file including all sub-folders into a folder on your disk and double click the .exe to run the application. No install procedure necessary. So it’s possible to run the application from any PC or direct from an USB stick or hard disc.  

 

Is Mac OS X supported ?

TraCoConverter itself is a native Windows application and is not executable on a Mac OS X. But also Mac user can benefit from TraCoConverter: TraCoConverter running on any Windows PC can create TXT, CSV and XLS files also from your Mac Traktor Pro song collection. If you have a Mac only, no PC … maybe ask a friend to run the application on his PC, or contact me :).

TraCoConverter is a direct run application, no installation necessary. Launch the application on any Windows PC with MS Excel and .NET 3.5 directly from USB stick.

Important, strength of TraCoConverter: You do not need any itunes or your mp3 song on the TraCoConverter PC, you need only the TraCoConverter application and your single “collection.nml” file (from TDJ on iOS or from Traktor Pro on Mac or PC).

 

Do I need Traktor Pro, itunes or any songs on the TraCoConverter PC ?

No, you don’t need itunes on the PC to create the new files. Traktor Pro is also not needed. Also the songs are not needed on the TraCoConverter PC.

You need only the TraCoConverter application itself (extracted zip file with all subfolders) and your “collection.nml” file. This makes it quite easy to create the new files also on separate Windows PC.

 

Where can I find the collection.nml of Traktor Pro (Mac or PC) ?

The file collection.nml is stored in the Traktor Pro main directory, typical path (or similar):

PC Windows (7,10): C: \Users \xy.. \Documents \Native Instruments \Traktor xy.

Mac OS X: Macintosh HD /Library /Application Support /Native Instruments /Traktor xy.

 

Where can I find the collection.nml of Traktor DJ (iOS) ?

This has changed with TDJ 1.6.8, as TDJ is using iCloud now (instead Dropbox):

Open iCloud and you will find the TDJ collection, two ways how you can access iCloud:

Now open iCloud and search for the ‘iCloud Drive’, open drive .. you will find ‘Traktor DJ’. Open this folder, you will find the file ‘collection.nml.gz’. This is the compressed (gz-zipped) collection.nml. Save it on a safe place on PC/Mac. Open (unzip) on your local PC/Mac with double click .. inside is your ‘collection.nml’ – this .nml file (not the nml.gz file) is needed for TraCoConverter.

 

Some details to the new generated files

All generated files (TXT, CSV, XLS, DB) can be quite useful, depending of your workflow. Enable/disable the certain checkboxes of TraCoConverter main screen to define which file format you want to generate:

The TXT file presents the complete original content, each song in a separate line, all converted into ANSI character set. The TXT file is useful to see the original tags using any text editor.

The CSV file is most useful for importing into other apps. It contains the song related tags only. Much application can import .csv files, so if you e.g. want to import your collection data in a database, this csv file could make most sense.

The XLS makes most sense for comfortable browsing and scrolling through your song collection data. You need Excel on the TraCoConverter PC to create the XLS file. The XLS Excel spreadsheet presents the date most comfortable view, some facts to the created XLS file:

The DB format is the file format of the iOS DJ app ‘DJ Player Pro (DJPP)’ from iMect Ltd. This enables you to transfer your song collection the metadata from Traktor to DJPP:  

 

How to transfer Traktor metadata into the iOS app ‘DJ Player Pro’ ?

TraCoConverter allows you to transfer your Traktor metadata (including grid, bpm, hot cue’s and musical key) directly into the iOS DJ app DJ Player Pro (DJPP) from iMect Ltd.

Instruction (3 steps):

Done. DJPP should present now all Traktor metadata also in DJPP. You can repeat the procedure whenever you want to transfer your Traktor metadata (grid, bpm, hot cue’s and musical key) from Traktor to DJPP.

In case you still miss metadata in DJPP for few songs, then check the db.log file. Version 2.1 added a footer ‘ERROR’ (in case a error or warning appeared) where you find all songs which could not be transferred. DJPP is more strict as Traktor, in some Traktor Collection same songs are included twice (same means: same title, same artist, same long length in seconds), DJPP does not allow this, so check your log file for a ERROR section at bottom, telling you which songs couldn’t be transferred and repair your collection first. Don't worry too much about any warnings during creating a db file, even if song duplicates which will raise any warnings .. all other songs will still be ok and transferred.

Also avoid any “ character in song titles, Traktor is struggling sometimes with this character.

Detail: DJPP does never ‘forget’ any metadata, even if you remove the song from the iOS song library the earlier metadata will never be lost (it’s stored in the internal DJPP database, also mirrored in iCloud). If you add the removed song later again, all earlier metadata will appear again. This is a strength of DJPP and quite different to Traktor and TDJ.

Detail: TraCoConverter allows transferring ‘your’ musical keys into DJPP. Background: Traktor Pro allows you to update musical keys e.g. with MixedInKey, great feature. Using TraCoConverter you can transfer this MIK keys also into DJPP: Tag your songs (e.g. with MixedInkey) on PC or Mac, import the key information into Traktor Pro, create an import.db file with TraCoConverter and upload the file into DJPP. You will find your musical key values now also in DJPP. If you use DJPP and TDJ only (and don’t want to use Traktor Pro), then use TraCoMerger instead (see below).

 

TraCoConverter File Viewer

The integrated File viewer in TraCoConverter allows you to ‘see’ the content your collection.nml and the new files (.txt, .csv, .xls). You don’t need the viewer to create the new files. The idea behind this viewer is to offer a more comfortable ‘splitted’ view of the original nml content and direct access to all new files for experienced user.

Open menu ‘View Files’ to open the integrated File Viewer. You can view the original .nml file and the new files. A typical nml file looks like a long ‘garbage text file’ - the nml ‘split view’ helps: adding line breaks between the songs AND important tags, allows you to browse through the song information much easier.

The text search in the nml/txt/csv file viewer allows you to search for certain tags or songs.

The xls viewer opens Excel directly with the new created spreadsheet.

I did not add a viewer for the DJPP db file. Experienced user who want to see the content of the db file can use e.g. the open source SQLite file browser: http://sqlitebrowser.org/   

 

What is TraCoMerger and how does it work together with TraCoConverter ?

TraCoMerger is another stand alone application, also developed by myself. The idea behind TraCoMerger is to transfer the meta data (bpm, grid, cue points, musical keys) from one collection.nml to an other. Intended use: backup/restore management, migration of song collection to new devices, transfer of metadata between Traktor Pro and TDJ (iOS).

TraCoMerger could also be useful for DJPP user, which are using TDJ in parallel (without using Traktor Pro). In particular if you want to update musical keys in DJPP. Workflow: modify mp3 key tags (e.g. with MixedInkey) > use TraCoMerger to create updated TDJ (iOS) collection > use TraCoConverter to create DJPP import.db.

The software architecture of TraCoMerger and TraCoConverter are quite similar, based on the same code base. Detail: TraCoConverter needs .NET 3.5 only, so also older Windows XP are supported.

Both application work perfectly together. I always use TraCoConverter together with TraCoMerger. When I create any new collection files with TraCoMerger I always use TraCoConverter in addition to compare the content via created Excel spread sheets.

You can download both applications (TraCoConverter and TraCoMerger) in the NI TDJ community forum: http://www.native-instruments.com/forum/forums/traktor-dj-for-iphone-and-ipad.327/

 

Contact for further questions, ideas, comments

All questions, ideas or suggestions for further updates are always welcome. Contact me (KALO) on the NI community forum: http://www.native-instruments.com/forum/forums/traktor-dj-for-iphone-and-ipad.327/

If you have any detailed question, then send me a PM (private message): open my avatar and ‘Start a Conversation’.

Join me in the DJ Player Pro slack forum if you have any DJ Player Pro related questions: https://djtechnology.slack.com

 


Release Notes

 

Version 2.3 (Sept. 4, 2017)

Version 2.2 (August 11, 2017)

Version 2.1 (February 5, 2017)

Version 2.0 (August 16, 2016)

Version 1.1 (July 12, 2015)

Version 1.0 (June 28, 2015)

 


Hope you enjoy TraCoConverter :)

KALO