cli-anything-rekordbox

O que cli-anything-rekordbox faz?

CLI nativo para agentes que controla o Pioneer Rekordbox 6/7. Aciona a biblioteca e decks ao vivo de forma programática.

Instalação

pip install cli-anything-rekordbox

Pré-requisitos:

• Python 3.10+
• Rekordbox 6 ou 7 instalado (master.db deve existir)
• Driver MIDI virtual para controle de decks ao vivo:
  • Windows: loopMIDI / LoopBe / teVirtualMIDI
  • macOS: IAC Driver
  • Linux: ALSA virtual MIDI (snd-virmidi)

Uso

# Verificação de status
cli-anything-rekordbox status

# Modo REPL
cli-anything-rekordbox

# Saída JSON para agentes
cli-anything-rekordbox --json library search "Daft Punk"

Grupos de Comandos

Biblioteca

Comando	Descrição
count	Contagem total de faixas
search QUERY	Encontra faixas por substring do título/artista
info TRACK_ID	Metadados completos da faixa
dump --out FILE.json	Exporta a biblioteca inteira como JSON

Playlist

Comando	Descrição
list	Todas as playlists
create NAME [--force] [--no-backup]	Nova playlist
add NAME --track-title T [--force] [--no-backup]	Adiciona faixa
clear NAME [--force] [--no-backup]	Esvazia uma playlist

Escritas em playlists criam um backup do master.db antes da mutação. Elas se recusam a executar enquanto o Rekordbox estiver aberto, a menos que --force seja fornecido; escritas forçadas ainda exigem um backup. --no-backup só é aceito quando o Rekordbox está fechado.

Deck (MIDI ao vivo)

Comando	Descrição
play --deck N	Play/pause
sync --deck N	Sincronização de tempo
crossfade FROM TO --secs S	Crossfade suave
eq --deck N --hi --mid --lo	Controle de EQ
hot-cue --deck N --slot 1-8	Aciona hot cue

Nível superior

Comando	Descrição
status	Estado do runtime / DB / MIDI
install-mapping	Copia Bunker.midi.csv para a pasta MidiMappings do rekordbox
mix A B --secs S	Nível alto: busca + carrega + sincroniza + crossfade

Como funciona

+------------------+
|   Seu Agente      |
+--------+---------+
         |
         v
+------------------+
| cli-anything-    |
| rekordbox CLI    |
+--------+---------+
   |          |
   v          v
+----------+  +----------+
|pyrekord- |  |  mido +  |
|box DB    |  |  virtual |
|writes    |  |  MIDI    |
+----------+  +----------+
   |               |
   v               v
+----------+  +-----------+
| master.db|  | Rekordbox |
|SQLCipher |  | decks ao  |
+----------+  | vivo      |
               +-----------+

• master.db é criptografado com uma chave estática AES-256 compartilhada por todas as instalações do rekordbox 6/7 (extraída automaticamente pelo pyrekordbox)
• O mapeamento MIDI virtual usa o formato padrão .midi.csv da Pioneer; este CLI inclui Bunker.midi.csv e um comando install-mapping para copiá-lo para a pasta MidiMappings/ do rekordbox

Saída JSON

Todo comando suporta --json:

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

Licença

MIT