mcpField
C
cli-anything-rekordbox

cli-anything-rekordbox

github.com/hkuds创意与媒体57.6k294 次安装5 周前更新
代码仓库

关于 cli-anything-rekordbox

cli-anything-rekordbox 是面向 Agent 的 Rekordbox 6/7 命令行工具，可管理音乐库和播放列表，并通过虚拟 MIDI 控制实时播放设备，也支持 JSON 输出。

主要功能

  1. 01搜索和查看曲目
  2. 02以 JSON 导出音乐库
  3. 03创建和编辑播放列表
  4. 04通过 MIDI 控制播放设备
  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

面向 Agent 的原生命令行工具，用于 Pioneer Rekordbox 6/7。可以以编程方式操作 DJ 曲库和实时 Deck。

安装

pip install cli-anything-rekordbox

前置条件：

  • Python 3.10+
  • 已安装 Rekordbox 6 或 7（master.db 必须存在）
  • 用于实时 Deck 控制的虚拟 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 打开时会拒绝运行；强制写入仍然需要备份。仅当 Rekordbox 已关闭时才接受 --no-backup。

Deck（实时 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-mapping将 Bunker.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 格式；此命令行工具附带 Bunker.midi.csv 和一个 install-mapping 命令，可将其放入 rekordbox 的 MidiMappings/ 文件夹

JSON 输出

每个命令都支持 --json：

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

许可证

MIT

评论

支持 Markdown