rbox 0.1.5

⚠️ Disclaimer: This project is not affiliated with Pioneer DJ, AlphaTheta Corp., or any related entities. The maintainers and contributors assume no liability for any data loss or damage to your Rekordbox library. "Rekordbox" is a registered trademark of AlphaTheta Corporation.

rbox is a high-performance Rust library for seamlessly interacting with Pioneer DJ's Rekordbox software data. It supports the following Rekordbox files:

• Rekordbox database: Query and update the Rekordbox v6/v7 master.db database through a type-safe ORM
• One Library: Read and write Rekordbox One Library (Device Library Plus) export files
• XML database: Read and write Rekordbox XML database files
• Analysis Files: Read and write ANLZ files containing waveforms, beat grids, hot cues and more
• Settings Access: Read and write My-Setting files

🔧 Installation

rbox is available on Cargo. Run the following Cargo command in your project directory:

cargo add rbox

or add the following line to your Cargo.toml:

rbox = "0.1.5"

Features

The library is organized into modular components that can be enabled individually:

• full (default): Enables all component features
• master-db: Access to the Rekordbox 6/7 master.db database (enables anlz feature)
• one-library: Access to the One Library (Device Library Plus) database
• anlz: Support for ANLZ analysis files
• xml: Support for Rekordbox XML database files
• settings: Support for My-Setting files

SQLCipher Features

The master-db and one-library features require SQLCipher for working with Rekordbox's encrypted database files. To make building easier, there are two features for choosing SQLCipher's installation:

• bundled-vendored-openssl (default): Builds and statically links both SQLCipher and OpenSSL. This is the most portable option and requires no system dependencies, but increases compilation time.
• bundled: Builds and statically links SQLCipher, but uses the system's OpenSSL installation. Choose this if you already have OpenSSL installed and want to reduce compilation time.

Note: The SQLCipher features (bundled-vendored-openssl, bundled) require either master-db or one-library to be enabled.

Language Bindings

The library can be compiled with bindings for other programming languages. These features are used in the bindings and should not be enabled manually:

• pyo3: Enables Python bindings
• napi: Enables Node.js/JavaScript bindings through N-API

🚀 Quick-Start

❗ Caution: Please make sure to back up your Rekordbox collection before making changes to rekordbox data. The backup dialog can be found under "File" > "Library" > "Backup Library"

Rekordbox 6/7 database

Rekordbox 6 and 7 use a SQLite database for storing the collection content. Unfortunatly, the master.db SQLite database is encrypted using SQLCipher, which means it can't be used without the encryption key. However, since your data is stored and used locally, the key must be present on the machine running Rekordbox.

rbox can unlock the new Rekordbox master.db SQLite database and provides an easy interface for accessing and updating the data stored in it.

use rbox::prelude::*;

fn main() -> anyhow::Result<()> {
    let mut db = MasterDb::open()?;
    let contents = db.get_contents()?;
    for content in contents {
        println!("{:?}", content);
    }
    Ok(())
}

One Library (Device Library Plus)

For newer generation Pioneer DJ devices, Rekordbox exports a new library format to the USB storage device (or SD card), called One Library (formerly known as Device Library Plus). As of 2025, this format is only supported by the OPUS-QUAD, OMNIS-DUO, XDJ-AZ and CDJ-3000X devices. The database schema is similar to the main Rekordbox database. It contains a selection of tables from the main database, with similar columns and data types.

rbox can unlock the new Rekordbox exportLibrary.db One Library database and provides an easy interface for accessing the data stored in it:

use rbox::prelude::*;

fn main() -> anyhow::Result<()> {
    let mut db = OneLibrary::new("exportLibrary.db")?;
    let contents = db.get_contents()?;
    for content in contents {
        println!("{:?}", content);
    }
    Ok(())
}

Rekordbox XML

The Rekordbox XML database is used for importing (and exporting) Rekordbox collections including track metadata and playlists. They can also be used to share playlists between two databases.

rbox can read and write Rekordbox XML databases.

use rbox::prelude::*;

fn main() -> anyhow::Result<()> {
    let mut xml = RekordboxXml::load("database.xml");
    let tracks = xml.get_tracks();
    for track in tracks {
        println!("{:?}", track);
    }
    Ok(())
}

Rekordbox ANLZ files

Rekordbox stores analysis information of the tracks in the collection in specific files, which also get exported to decives used by Pioneer professional DJ equipment. The files have names like ANLZ0000 and come with the extensions .DAT, .EXT or .2EX. They include waveforms, beat grids (information about the precise time at which each beat occurs), time indices to allow efficient seeking to specific positions inside variable bit-rate audio streams, and lists of memory cues and loop points.

rbox can parse and write all three analysis files.

use rbox::prelude::*;

fn main() -> anyhow::Result<()> {
    let mut anlz = Anlz::load("ANLZ0000.DAT")?;
    let grid = anlz.get_beat_grid().unwrap();
    for beat in grid {
        println!("Beat: {} Tempo: {} Time: {}", beat.beat_number, beat.tempo, beat.time);
    }
    Ok(())
}

Rekordbox My-Settings

Rekordbox stores the user settings in *SETTING.DAT files, which get exported to USB devices. These files are either in the PIONEERdirectory of a USB drive (device exports), but are also present for on local installations of Rekordbox 6. The setting files store the settings found on the "DJ System" > "My Settings" page of the Rekordbox preferences. These include language, LCD brightness, tempo fader range, crossfader curve and other settings for Pioneer professional DJ equipment.

rbox supports both parsing and writing of My-Setting files.

use rbox::prelude::*;
use rbox::settings::Quantize;

fn main() -> anyhow::Result<()> {
    let mut sett = Setting::load("MYSETTING.DAT")?;
    println!("Quantize: {}", sett.get_quantize()?);
    sett.set_quantize(Quantize::Off)?;
    sett.dump()?;
    Ok(())
}

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Sponsor

If rbox has helped you or saved you time, consider supporting its development - every coffee makes a difference!