cli-anything-rekordbox

Was macht cli-anything-rekordbox?

Agent-native CLI für Pioneer Rekordbox 6/7. Steuert die DJ-Mediathek und Live-Decks programmatisch.

Installation

pip install cli-anything-rekordbox

Voraussetzungen:

• Python 3.10+
• Rekordbox 6 oder 7 installiert (master.db muss vorhanden sein)
• Virtueller MIDI-Treiber für Live-Deck-Steuerung:
  • Windows: loopMIDI / LoopBe / teVirtualMIDI
  • macOS: IAC-Treiber
  • Linux: ALSA virtuelles MIDI (snd-virmidi)

Verwendung

# Statusprüfung
cli-anything-rekordbox status

# REPL-Modus
cli-anything-rekordbox

# JSON-Ausgabe für Agenten
cli-anything-rekordbox --json library search "Daft Punk"

Befehlsgruppen

Bibliothek

Befehl	Beschreibung
count	Gesamtzahl der Tracks
search SUCHBEGRIFF	Suche nach Titeln/Künstlern (Teilzeichenkette)
info TRACK_ID	Vollständige Track-Metadaten
dump --out DATEI.json	Komplette Bibliothek als JSON exportieren

Playlist

Befehl	Beschreibung
list	Alle Playlists anzeigen
create NAME [--force] [--no-backup]	Neue Playlist erstellen
add NAME --track-title T [--force] [--no-backup]	Track hinzufügen
clear NAME [--force] [--no-backup]	Playlist leeren

Playlist-Schreibbefehle erstellen vor der Änderung ein Backup der master.db. Sie verweigern die Ausführung, solange Rekordbox geöffnet ist, es sei denn, --force wird angegeben; forcierte Schreibvorgänge erfordern weiterhin ein Backup. --no-backup wird nur akzeptiert, wenn Rekordbox geschlossen ist.

Deck (Live-MIDI)

Befehl	Beschreibung
play --deck N	Wiedergabe/Pause
sync --deck N	Tempo-Synchronisation
crossfade VON NACH --sek S	Sanfter Überblendvorgang
eq --deck N --hi --mid --lo	EQ-Steuerung
hot-cue --deck N --slot 1-8	Hot Cue auslösen

Top-Level

Befehl	Beschreibung
status	Laufzeit-/Datenbank-/MIDI-Status
install-mapping	Bunker.midi.csv in den MidiMappings-Ordner von rekordbox ablegen
mix A B --sek S	Hochwertig: Suche + Laden + Synchronisieren + Überblenden

Funktionsweise

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

• master.db ist mit einem statischen AES-256-Schlüssel verschlüsselt, der von allen Rekordbox-6/7-Installationen gemeinsam genutzt wird (wird automatisch von pyrekordbox extrahiert)
• Virtuelle MIDI-Abbildung verwendet Pioneers standard .midi.csv-Format; diese CLI enthält Bunker.midi.csv und einen install-mapping-Befehl, um sie in den MidiMappings/-Ordner von rekordbox zu kopieren

JSON-Ausgabe

Jeder Befehl unterstützt --json:

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

Lizenz

MIT