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

Command	Description
count	Total track count
search QUERY	Find tracks by title/artist substring
info TRACK_ID	Full track metadata
dump --out FILE.json	Export full library as JSON

Playlist

Command	Description
list	All playlists
create NAME [--force] [--no-backup]	New playlist
add NAME --track-title T [--force] [--no-backup]	Add track
clear NAME [--force] [--no-backup]	Empty a 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)

Command	Description
play --deck N	Play/pause
sync --deck N	Tempo sync
crossfade FROM TO --secs S	Smooth crossfade
eq --deck N --hi --mid --lo	EQ control
hot-cue --deck N --slot 1-8	Trigger hot cue

Top-level

Command	Description
status	Runtime / DB / MIDI state
install-mapping	Drop Bunker.midi.csv into rekordbox's MidiMappings folder
mix A B --secs S	High-level: search + load + sync + crossfade

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