MkCDJ

A tool to manage an audio playlist with BPM analysis.

Dependencies

You need to have ffmpeg(1) installed.

Usage

• Run mkcdj analyze PRESET PATH to add a track to the collection
• Run mkcdj compile PATH to export all files to the given directory
• Run mkcdj refresh to automatically run BPM analysis on all tracks again
• Run mkcdj list to preview the tracklist
• Run mkcdj files to print absolute file paths (for scripting)
• Run mkcdj prune to remove lost files from the current playlist

Add the -v flag to any of these commands get verbose output.

Configuration

The MKCDJ_STORE environment variable contains the path to the current collection (a JSON file).

If unset, /tmp/mkcdj.json is used.

Presets

A preset is a shorthand to hint the BPM detection. Each preset limits the detection to its predefined BPM range. For example, the dnb (Drum & Bass) preset limits the detection from 165 to 180 BPM.

Check the source to see the supported presets.

You can also pass a BPM value instead of a named preset. In that case the system will lookup the corresponding range.

Export format

All files are exported in WAV 16 bits 44100Hz. We do not want 24 or 32 bits WAV because FFMPEG would use the WAVEFORMATEXTENSIBLE format which is not widely compatible. Only WAVE_FORMAT_PCM works everywhere but in theory bit depths larger than 16 are not supported (even though most of the DAWs and DJ software do).

See this issue for more info.

Additionally, waveform and spectrogram pictures of each file are generated in separate directories.

Credits

BPM detection algorithm is a simplified, slightly optimized and cleaned up version of github.com/benjojo/bpm which a port of bpm-tools in Go.