cli-anything-rekordbox — Claude Code skill: what it does
The cli-anything-rekordbox skill drives Pioneer Rekordbox 6/7's library and live decks from a CLI: playlists, track search, play/sync/crossfade/EQ.
Apache-2.0 353 installs ★ 62,125 updated 2026-09-22
npx skills add HKUDS/CLI-Anything --skill cli-anything-rekordbox -a claude-codeWhat cli-anything-rekordbox does
This skill gives an agent the cli-anything-rekordbox CLI, which reads and writes Rekordbox's master.db through pyrekordbox and controls live decks over virtual MIDI. Commands fall into three groups: library (count, search, info, dump --out FILE.json) for reading the catalog, playlist (list, create, add, clear) for editing playlists, and deck (play, sync, crossfade, eq, hot-cue) for live mixing. A mix A B --secs S command chains search, load and crossfade in one call.
The master.db file is locked behind a static AES-256 key shared across every Rekordbox 6/7 install, and pyrekordbox pulls that key out automatically. Any playlist write triggers a master.db backup first; writing while Rekordbox is running needs --force, and even forced writes still back up the database — skipping that step with --no-backup only works when Rekordbox is closed.
Deck control needs a virtual MIDI driver: loopMIDI, LoopBe or teVirtualMIDI on Windows, IAC Driver on macOS, snd-virmidi on Linux. The MIDI side runs on a Bunker.midi.csv mapping file that ships with the skill; install-mapping copies it straight into Rekordbox's MidiMappings folder.
What it helps with
- look up tracks in a Rekordbox library by title or artist
- build a playlist and fill it with tracks from the command line
- export the whole library to JSON for analysis
- trigger play, sync and crossfade on live decks without touching a mouse
- script EQ or hot-cue moves for an agent to run
Example prompts for the agent
- Search the Rekordbox library for Daft Punk tracks using cli-anything-rekordbox
- Create playlist NAME and add the track titled T with cli-anything-rekordbox
- Crossfade deck A into deck B over 8 seconds using cli-anything-rekordbox mix
How to install cli-anything-rekordbox
1Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-rekordbox -a claude-code2Manually: put the files in place
~/.claude/skills/cli-anything-rekordbox/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cli-anything-rekordbox/
1Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-rekordbox -a codex2Manually: put the files in place
.agents/skills/cli-anything-rekordbox/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-rekordbox -a cursor2Manually: put the files in place
.cursor/skills/cli-anything-rekordbox/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install HKUDS/CLI-Anything skills/cli-anything-rekordbox2Manually: put the files in place
.github/skills/cli-anything-rekordbox/SKILL.md1Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-rekordbox -a gemini-cli2Platform CLI
gemini skills install https://github.com/HKUDS/CLI-Anything --path skills/cli-anything-rekordboxManually: put the files in place
.devin/skills/cli-anything-rekordbox/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-rekordbox -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about cli-anything-rekordbox
How do I install cli-anything-rekordbox in Claude Code?
Run npx skills add HKUDS/CLI-Anything --skill cli-anything-rekordbox -a claude-code; the skill lands at ~/.claude/skills/cli-anything-rekordbox/SKILL.md.
What does cli-anything-rekordbox do?
It's a CLI for Pioneer Rekordbox 6/7 that reads and edits the library through master.db via pyrekordbox, and drives live decks over virtual MIDI for play, sync, crossfade, EQ and hot cues.
What do I need to run cli-anything-rekordbox?
Python 3.10+, a Rekordbox 6 or 7 install with an existing master.db, and for deck control a virtual MIDI driver — loopMIDI/LoopBe/teVirtualMIDI on Windows, IAC Driver on macOS, snd-virmidi on Linux.
Source text
SKILL.md · Apache-2.0
---
name: "cli-anything-rekordbox"
description: >-
Command-line interface for Pioneer Rekordbox 6/7 - DJ library and live-deck control via guarded SQLCipher master.db access (pyrekordbox) + virtual MIDI mapping. Provides library inspection, playlist creation/add/clear, and live-deck mixing (play/sync/crossfade/EQ). Pioneer ships no playback REST API; this harness combines the only two real surfaces (encrypted DB + MIDI) into one agent-native CLI.
---
# cli-anything-rekordbox
Agent-native CLI for Pioneer Rekordbox 6/7. Drives the DJ library and live decks programmatically.
## Installation
```bash
pip install cli-anything-rekordbox
```
**Prerequisites:**
- Python 3.10+
- Rekordbox 6 or 7 installed (`master.db` must exist)
- Virtual MIDI driver for live-deck control:
- Windows: loopMIDI / LoopBe / teVirtualMIDI
- macOS: IAC Driver
- Linux: ALSA virtual MIDI (`snd-virmidi`)
## Usage
```bash
# Status check
cli-anything-rekordbox status
# REPL mode
cli-anything-rekordbox
# JSON output for agents
cli-anything-rekordbox --json library search "Daft Punk"
```
## Command Groups
### Library
| Command | Description |
|---------|-------------|
| `count` | Total track count |
| `search QUERY` | Find tracks by title/artist substring |
| `info TRACK_ID` | Full track metadata |
| `dump --out FILE.json` | Export full library as JSON |
### Playlist
| Command | Description |
|---------|-------------|
| `list` | All playlists |
| `create NAME [--force] [--no-backup]` | New playlist |
| `add NAME --track-title T [--force] [--no-backup]` | Add track |
| `clear NAME [--force] [--no-backup]` | Empty a playlist |
Playlist writes create a `master.db` backup before mutation. They refuse to run
while Rekordbox is open unless `--force` is supplied; forced writes still require
a backup. `--no-backup` is only accepted when Rekordbox is closed.
### Deck (live MIDI)
| Command | Description |
|---------|-------------|
| `play --deck N` | Play/pause |
| `sync --deck N` | Tempo sync |
| `crossfade FROM TO --secs S` | Smooth crossfade |
| `eq --deck N --hi --mid --lo` | EQ control |
| `hot-cue --deck N --slot 1-8` | Trigger hot cue |
### Top-level
| Command | Description |
|---------|-------------|
| `status` | Runtime / DB / MIDI state |
| `install-mapping` | Drop Bunker.midi.csv into rekordbox's MidiMappings folder |
| `mix A B --secs S` | High-level: search + load + sync + crossfade |
## How it works
```
+------------------+
| 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** is encrypted with a static AES-256 key shared by all rekordbox 6/7 installs (auto-extracted by pyrekordbox)
- **Virtual MIDI** mapping uses Pioneer's standard `.midi.csv` format; this CLI ships `Bunker.midi.csv` and an `install-mapping` command to drop it into rekordbox's `MidiMappings/` folder
## JSON output
Every command supports `--json`:
```bash
$ cli-anything-rekordbox --json library count
{"track_count": 30344}
```
## License
MIT
© HKUDS · Apache-2.0 · HKUDS/CLI-Anything