/cli-anything-rekordbox

name: "cli-anything-rekordbox"
description: >-
  Command-line interface for Pioneer Rekordbox 6/7 - DJ library and live-deck control via guarded SQLCipher master.db access (pyrekordbox) + virtual MIDI mapping. Provides library inspection, playlist creation/add/clear, and live-deck mixing (play/sync/crossfade/EQ). Pioneer ships no playback REST API; this harness combines the only two real surfaces (encrypted DB + MIDI) into one agent-native CLI.

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