Cli Anything Rekordbox

cli-anything-rekordbox

Agent-native CLI for Pioneer Rekordbox 6/7. Drives the DJ library and live decks programmatically.

Installation

pip install cli-anything-rekordbox

Prerequisites:

• Python 3.10+
• Rekordbox 6 or 7 installed (master.db must exist)
• Virtual MIDI driver for live-deck control:
• Windows: loopMIDI / LoopBe / teVirtualMIDI
• macOS: IAC Driver
• Linux: ALSA virtual MIDI (snd-virmidi)

Usage

# Status check
cli-anything-rekordbox status

# REPL mode
cli-anything-rekordbox

# JSON output for agents
cli-anything-rekordbox --json library search "Daft Punk"

Command Groups

Library

Playlist

Playlist writes create a master.db backup before mutation. They refuse to run while Rekordbox is open unless --force is supplied; forced writes still require a backup. --no-backup is only accepted when Rekordbox is closed.

Deck (live MIDI)

Top-level

How it works

+------------------+
|   Your Agent     |
+--------+---------+
         |
         v
+------------------+
| cli-anything-    |
| rekordbox CLI    |
+--------+---------+
   |          |
   v          v
+----------+  +----------+
|pyrekord- |  |  mido +  |
|box DB    |  |  virtual |
|writes    |  |  MIDI    |
+----------+  +----------+
   |               |
   v               v
+----------+  +-----------+
| master.db|  | Rekordbox |
|SQLCipher |  | live decks|
+----------+  +-----------+

• master.db is encrypted with a static AES-256 key shared by all rekordbox 6/7 installs (auto-extracted by pyrekordbox)
• Virtual MIDI mapping uses Pioneer's standard .midi.csv format; this CLI ships Bunker.midi.csv and an install-mapping command to drop it into rekordbox's MidiMappings/ folder

JSON output

Every command supports --json:

$ cli-anything-rekordbox --json library count
{"track_count": 30344}

License

MIT