cli-anything-rekordbox

Controls Pioneer Rekordbox libraries and live decks via SQLCipher database access and virtual MIDI.

48.8k|4.5k|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/HKUDS/CLI-Anything --skill cli-anything-rekordbox
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cli-anything-rekordbox
Source: https://github.com/HKUDS/CLI-Anything/tree/main/rekordbox/agent-harness/cli_anything/rekordbox/skills
Command: npx skills add https://github.com/HKUDS/CLI-Anything --skill cli-anything-rekordbox

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyrekordbox, mido.

What problem does it solve?

Pioneer Rekordbox ships no playback REST API, so AI agents and scripts cannot programmatically inspect DJ libraries, manage playlists, or control live decks. This Skill bridges that gap by combining the only two real control surfaces—encrypted master.db access and virtual MIDI—into one agent-native CLI.

Core Features & Use Cases

  • Library Inspection: Count, search, and dump full track metadata from the Rekordbox master.db using pyrekordbox, with JSON output for agent consumption.
  • Playlist Management: Create, add tracks to, and clear playlists with automatic database backups and guards that refuse writes while Rekordbox is open unless forced.
  • Live Deck Control: Trigger play, sync, crossfade, EQ, and hot cues on live decks through virtual MIDI mapping, including a high-level mix command that chains search, load, sync, and crossfade.
  • Use Case: Ask an agent to mix two tracks by name; the CLI searches the library, loads the tracks, syncs tempo, and performs a timed crossfade automatically.

Quick Start

Install the package with pip, ensure Rekordbox 6 or 7 and a virtual MIDI driver are set up, then ask your agent to run cli-anything-rekordbox status to verify the database and MIDI state.

Frequently Asked Questions about cli-anything-rekordbox

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control Rekordbox from the command line?

Install cli-anything-rekordbox with pip, then run commands like cli-anything-rekordbox library search or deck play. Every command supports a --json flag so agents and scripts can parse structured output.

How to automate Rekordbox playlist creation with Python?

Use the playlist command group: playlist create, playlist add with a track title, and playlist clear. Each write creates a master.db backup first and refuses to run while Rekordbox is open unless you pass --force.

Does Rekordbox have an API for live deck control?

Pioneer ships no playback REST API for Rekordbox. This CLI combines the two available surfaces: the encrypted master.db accessed via pyrekordbox, and virtual MIDI mapping for live-deck functions like play, sync, and crossfade.

What virtual MIDI driver works with Rekordbox MIDI mapping?

On Windows use loopMIDI, LoopBe, or teVirtualMIDI; on macOS use the IAC Driver; on Linux use ALSA virtual MIDI (snd-virmidi). The install-mapping command drops the bundled Bunker.midi.csv into Rekordbox's MidiMappings folder.

Why does playlist writing fail while Rekordbox is open?

Writes are blocked while Rekordbox is running to prevent database corruption, since Rekordbox holds master.db open. Close Rekordbox or pass --force; forced writes still require a backup, and --no-backup is only accepted when Rekordbox is closed.