cli-anything-rekordbox

Que fait cli-anything-rekordbox ?

CLI natif pour agents, compatible avec Pioneer Rekordbox 6/7. Pilote la bibliothèque DJ et les decks en direct par programmation.

Installation

pip install cli-anything-rekordbox

Prérequis :

• Python 3.10+
• Rekordbox 6 ou 7 installé (master.db doit exister)
• Pilote MIDI virtuel pour le contrôle des decks en direct :
  • Windows : loopMIDI / LoopBe / teVirtualMIDI
  • macOS : IAC Driver
  • Linux : ALSA virtual MIDI (snd-virmidi)

Utilisation

# Vérification du statut
cli-anything-rekordbox status

# Mode REPL
cli-anything-rekordbox

# Sortie JSON pour les agents
cli-anything-rekordbox --json library search "Daft Punk"

Groupes de commandes

Bibliothèque

Commande	Description
count	Nombre total de pistes
search QUERY	Rechercher des pistes par titre/artiste (sous-chaîne)
info TRACK_ID	Métadonnées complètes d’une piste
dump --out FILE.json	Exporter la bibliothèque complète au format JSON

Playlist

Commande	Description
list	Toutes les playlists
create NAME [--force] [--no-backup]	Nouvelle playlist
add NAME --track-title T [--force] [--no-backup]	Ajouter une piste
clear NAME [--force] [--no-backup]	Vider une playlist

Les écritures dans les playlists créent une sauvegarde de master.db avant toute modification. Elles refusent de s’exécuter tant que Rekordbox est ouvert, sauf si --force est fourni ; les écritures forcées nécessitent toujours une sauvegarde. --no-backup n’est accepté que lorsque Rekordbox est fermé.

Deck (MIDI en direct)

Commande	Description
play --deck N	Lecture/Pause
sync --deck N	Synchronisation du tempo
crossfade FROM TO --secs S	Crossfade progressif
eq --deck N --hi --mid --lo	Contrôle de l’égaliseur
hot-cue --deck N --slot 1-8	Déclencher un hot cue

Commandes globales

Commande	Description
status	État du runtime / de la base de données / du MIDI
install-mapping	Déposer Bunker.midi.csv dans le dossier MidiMappings de rekordbox
mix A B --secs S	Haut niveau : recherche + chargement + synchronisation + crossfade

Fonctionnement

+------------------+
|   Votre 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 est chiffré avec une clé AES-256 statique partagée par toutes les installations de rekordbox 6/7 (extraite automatiquement par pyrekordbox)
• Le MIDI virtuel utilise le format standard .midi.csv de Pioneer ; ce CLI intègre Bunker.midi.csv et une commande install-mapping pour le placer dans le dossier MidiMappings/ de rekordbox

Sortie JSON

Chaque commande accepte --json :

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

Licence

MIT