Traktor NML utils

This module contains utilities to parse and modify Native Instruments Traktor NML files. It was created to be the by far best available library to handle Traktor collections.

It can parse collection files ($TRAKTOR_DIR/collection.nml) and history files ($TRAKTOR_DIR/History/history_$DATE.nml).

You can deal with all XML data in the most Pythonic way.

Requirements

Because traktor-nml-utils uses dataclasses, you need at least Python 3.7.x.

Installation

pip install traktor-nml-utils

Usage

from traktor_nml_utils import TraktorCollection

collection = TraktorCollection('collection.nml')

for entry in collection.entries:
    print(entry)

for history_item in collection.history:
    print(history_item)
    
for playlist in collection.playlists:
    print(playlist)

Run tests

Run tests within Docker container:

make build test

Tutorials

Get artist, title and rating of all collection entries

from traktor_nml_utils import TraktorCollection

collection = TraktorCollection('collection.nml')

for entry in collection.entries:
    print(f'{entry.artist} - {entry.title} ({entry.ranking}')