mcpField
C
cli-anything-rekordbox

cli-anything-rekordbox

github.com/hkudsクリエイティブ・メディア57.6k294 回インストール5 週間前に更新
リポジトリ

cli-anything-rekordbox について

cli-anything-rekordboxは、Rekordbox 6/7向けのエージェント対応コマンドラインツールです。音楽ライブラリやプレイリストの操作に加え、仮想MIDI経由のデッキ制御とJSON出力に対応します。

主な機能

  1. 01トラックの検索と詳細表示
  2. 02ライブラリのJSONエクスポート
  3. 03プレイリストの作成と編集
  4. 04MIDI経由のデッキ制御
  5. 05複合コマンドによるミックス

活用シーン

  1. 01タイトルやアーティストで曲を検索
  2. 02処理用にライブラリデータを出力
  3. 03プレイリストの作成と曲の追加
  4. 04デッキ操作やクロスフェードの実行

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-rekordbox

インストール後、Claude Code で/cli-anything-rekordboxを入力して読み込まれたか確認します。

詳細

cli-anything-rekordbox

Pioneer Rekordbox 6/7 向けのエージェントネイティブな CLI です。DJ ライブラリとライブデッキをプログラムから操作します。

インストール

pip install cli-anything-rekordbox

前提条件:

  • Python 3.10+
  • Rekordbox 6 または 7 がインストールされていること（master.db が存在する必要があります）
  • ライブデッキ制御用の仮想 MIDI ドライバー:
    • Windows: loopMIDI / LoopBe / teVirtualMIDI
    • macOS: IAC Driver
    • Linux: ALSA 仮想 MIDI（snd-virmidi）

使用方法

# Status check
cli-anything-rekordbox status

# REPL mode
cli-anything-rekordbox

# JSON output for agents
cli-anything-rekordbox --json library search "Daft Punk"

コマンドグループ

ライブラリ
コマンド説明
count総トラック数
search QUERYタイトル/アーティストの部分一致でトラックを検索
info TRACK_IDトラックの完全なメタデータ
dump --out FILE.jsonライブラリ全体を JSON としてエクスポート
プレイリスト
コマンド説明
listすべてのプレイリスト
create NAME [--force] [--no-backup]新しいプレイリスト
add NAME --track-title T [--force] [--no-backup]トラックを追加
clear NAME [--force] [--no-backup]プレイリストを空にする

プレイリストへの書き込みは、変更前に master.db のバックアップを作成します。--force を指定しない限り、Rekordbox が開いている間は実行を拒否します。強制書き込みでもバックアップは必要です。--no-backup は Rekordbox が閉じている場合にのみ受け付けられます。

デッキ（ライブ MIDI）
コマンド説明
play --deck N再生/一時停止
sync --deck Nテンポ同期
crossfade FROM TO --secs Sスムーズなクロスフェード
eq --deck N --hi --mid --loEQ コントロール
hot-cue --deck N --slot 1-8ホットキューをトリガー
トップレベル
コマンド説明
statusランタイム / DB / MIDI の状態
install-mappingBunker.midi.csv を rekordbox の MidiMappings フォルダに配置
mix A B --secs S高レベル: 検索 + ロード + 同期 + クロスフェード

仕組み

+------------------+
|   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 は、すべての rekordbox 6/7 インストールで共有される静的な AES-256 キーで暗号化されています（pyrekordbox によって自動抽出されます）
  • 仮想 MIDI マッピングは Pioneer 標準の .midi.csv 形式を使用します。この CLI には Bunker.midi.csv と、それを rekordbox の MidiMappings/ フォルダに配置する install-mapping コマンドが同梱されています

JSON 出力

すべてのコマンドは --json をサポートしています:

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

ライセンス

MIT

コメント

Markdown 対応