cli-anything-rekordbox

¿Qué hace cli-anything-rekordbox?

CLI nativo para agentes de Pioneer Rekordbox 6/7. Controla la biblioteca de DJ y los decks en vivo de forma programática.

Instalación

pip install cli-anything-rekordbox

Requisitos previos:

• Python 3.10+
• Rekordbox 6 o 7 instalado (master.db debe existir)
• Controlador MIDI virtual para control de decks en vivo:
  • Windows: loopMIDI / LoopBe / teVirtualMIDI
  • macOS: IAC Driver
  • Linux: ALSA virtual MIDI (snd-virmidi)

Uso

# Verificar estado
cli-anything-rekordbox status

# Modo REPL
cli-anything-rekordbox

# Salida JSON para agentes
cli-anything-rekordbox --json library search "Daft Punk"

Grupos de comandos

Biblioteca

Comando	Descripción
count	Recuento total de pistas
search QUERY	Buscar pistas por título/artista (subcadena)
info TRACK_ID	Metadatos completos de una pista
dump --out FILE.json	Exportar biblioteca completa como JSON

Lista de reproducción

Comando	Descripción
list	Todas las listas de reproducción
create NAME [--force] [--no-backup]	Crear nueva lista de reproducción
add NAME --track-title T [--force] [--no-backup]	Agregar una pista
clear NAME [--force] [--no-backup]	Vaciar una lista de reproducción

Las escrituras en listas de reproducción crean una copia de seguridad de master.db antes de la mutación. Se niegan a ejecutarse mientras Rekordbox esté abierto a menos que se proporcione --force; las escrituras forzadas siguen requiriendo una copia de seguridad. --no-backup solo se acepta cuando Rekordbox está cerrado.

Deck (MIDI en vivo)

Comando	Descripción
play --deck N	Reproducir/pausa
sync --deck N	Sincronizar tempo
crossfade FROM TO --secs S	Crossfade suave
eq --deck N --hi --mid --lo	Control de ecualizador
hot-cue --deck N --slot 1-8	Activar hot cue

Nivel superior

Comando	Descripción
status	Estado del runtime/DB/MIDI
install-mapping	Colocar Bunker.midi.csv en la carpeta MidiMappings de rekordbox
mix A B --secs S	Alto nivel: buscar + cargar + sincronizar + crossfade

Cómo funciona

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

• master.db está encriptado con una clave AES-256 estática compartida por todas las instalaciones de rekordbox 6/7 (extraída automáticamente por pyrekordbox)
• El mapeo MIDI virtual utiliza el formato estándar .midi.csv de Pioneer; este CLI incluye Bunker.midi.csv y un comando install-mapping para colocarlo en la carpeta MidiMappings/ de rekordbox

Salida JSON

Cada comando soporta --json:

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

Licencia

MIT