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)
사용법
# 상태 확인
cli-anything-rekordbox status
# REPL 모드
cli-anything-rekordbox
# 에이전트용 JSON 출력
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 백업을 생성합니다. Rekordbox가 열려 있는 경우 --force가 제공되지 않으면 작업을 거부하며, 강제 쓰기 시에도 백업이 필요합니다. --no-backup은 Rekordbox가 닫혀 있을 때만 허용됩니다.
데크 (라이브 MIDI)
| 명령 | 설명 |
|---|---|
play --deck N | 재생/일시 정지 |
sync --deck N | 템포 싱크 |
crossfade FROM TO --secs S | 부드러운 크로스페이드 |
eq --deck N --hi --mid --lo | EQ 제어 |
hot-cue --deck N --slot 1-8 | 핫 큐 트리거 |
최상위 명령
| 명령 | 설명 |
|---|---|
status | 런타임 / DB / MIDI 상태 |
install-mapping | Bunker.midi.csv를 rekordbox의 MidiMappings 폴더에 넣기 |
mix A B --secs S | 고수준: 검색 + 로드 + 싱크 + 크로스페이드 |
작동 방식
+------------------+
| 당신의 에이전트 |
+--------+---------+
|
v
+------------------+
| cli-anything- |
| rekordbox CLI |
+--------+---------+
| |
v v
+----------+ +----------+
|pyrekord- | | mido + |
|box DB | | 가상 |
|쓰기 | | MIDI |
+----------+ +----------+
| |
v v
+----------+ +-----------+
| master.db| | Rekordbox |
|SQLCipher | | 라이브 |
| | | 데크 |
+----------+ +-----------+
- master.db는 모든 rekordbox 6/7 설치에서 공유하는 정적 AES-256 키로 암호화됩니다(pyrekordbox가 자동 추출).
- 가상 MIDI 매핑은 Pioneer의 표준
.midi.csv형식을 사용합니다. 이 CLI는Bunker.midi.csv와 함께 제공되며,install-mapping명령을 사용하여 rekordbox의MidiMappings/폴더에 넣을 수 있습니다.
JSON 출력
모든 명령에서 --json을 지원합니다:
$ cli-anything-rekordbox --json library count
{"track_count": 30344}
라이선스
MIT