Overview

libdjinterop is a C++ library that allows access to database formats used to store information about DJ record libraries.

State of Support

The library is currently in development, and not all features are implemented yet. It currently supports only the Engine Library format.

What is supported:

• Track metadata
• Beat grids
• Hot cues
• Loops
• Waveforms
• Crates
• Playlists

The library supports the following firmware and application versions:

• Engine DJ OS from 1.0.3 to 4.3.3.
  • Tested on Denon SC5000 and Numark Mixstream Pro. Other players (e.g. SC6000/M) may work, but this is currently untested.
• Engine DJ Desktop (aka Engine Prime) from 1.0.1 to 4.3.0.

What is not supported (yet):

• Album art
• Play history
• DJ record libraries in formats other than Engine Prime

How Do I Use It?

If you are new to the library, see the introductory guide for an explanation of how the library is structured and how to get started.

The examples/ directory contains some small self-contained applications that use the library.

Detailed reference documentation for the public API can be viewed on GitHub Pages.

How Do I Build It?

libdjinterop requires the following compile-time dependencies:

• SQLite3
• zlib

To run unit tests, the following are required:

• Boost

libdjinterop uses CMake. Assuming you have the above dependencies in place, and the build tools, you can issue the following commands:

$ mkdir cmake-build
$ cd cmake-build
$ cmake ..
$ cmake --build .
$ ctest   # To run unit tests

With Nix

When Nix is installed, then you don't need to manually install any dependencies. In order to drop into a development environment with dependencies available, execute:

$ nix-shell

You can then build libdjinterop by as described above.

Thanks To

libdjinterop makes use of a number of software libraries, and is extremely grateful for:

• SQLite
• SQLite Modern C++ Wrapper
• zlib
• Boost
• ClangFormat

Interfacing with the Engine Library database format was made a lot easier with the help of MixMasterG from ATGR, who is the author of the Denon Conversion Utility.