cli-anything-musescore

MuseScore CLI 스킬

개요

MuseScore 4의 mscore 백엔드를 활용한 악보 표기 작업: 조옮김, 여러 형식(PDF, PNG, MP3, MIDI, MusicXML, Braille)으로 내보내기, 파트 추출, 악기 관리, 악보 분석.

명령어

프로젝트 관리

cli-anything-musescore --json project info -i score.mscz
cli-anything-musescore --json project open -i score.mscz

조옮김

# 특정 키로 조옮김
cli-anything-musescore --json transpose by-key -i score.mscz -o out.mscz --target-key "C major" --direction closest

# 반음 단위 조옮김
cli-anything-musescore --json transpose by-interval -i score.mscz -o out.mscz --semitones 3

# 온음계 조옮김
cli-anything-musescore --json transpose diatonic -i score.mscz -o out.mscz --steps 2

파트 추출

cli-anything-musescore --json parts list -i score.mscz
cli-anything-musescore --json parts extract -i score.mscz -o piano.mscz --part "Piano"
cli-anything-musescore --json parts generate -i score.mscz -d ./parts/

내보내기

cli-anything-musescore --json export pdf -i score.mscz -o score.pdf
cli-anything-musescore --json export mp3 -i score.mscz -o score.mp3 --bitrate 192
cli-anything-musescore --json export png -i score.mscz -o score.png --dpi 300
cli-anything-musescore --json export midi -i score.mscz -o score.mid
cli-anything-musescore --json export musicxml -i score.mscz -o score.musicxml
cli-anything-musescore --json export braille -i score.mscz -o score.brf
cli-anything-musescore --json export batch -i score.mscz -o score.pdf -o score.mid

악기 관리

cli-anything-musescore --json instruments list -i score.mscz
cli-anything-musescore --json instruments add -i score.mscz -o out.mscz --id keyboard.piano --name "Piano"
cli-anything-musescore --json instruments remove -i score.mscz -o out.mscz --name "Violin"

악보 분석

cli-anything-musescore --json media probe -i score.mscz
cli-anything-musescore --json media stats -i score.mscz
cli-anything-musescore --json media diff --reference a.mscz --compare b.mscz

세션

cli-anything-musescore --json session status
cli-anything-musescore --json session undo
cli-anything-musescore --json session redo
cli-anything-musescore --json session history

지원 입력 형식

• .mscz (MuseScore 네이티브)
• .mxl (압축 MusicXML)
• .musicxml / .xml (MusicXML)
• .mid / .midi (MIDI)

조옮김 키 이름

장조: Cb, Gb, Db, Ab, Eb, Bb, F, C, G, D, A, E, B, F#, C# 단조: Ab, Eb, Bb, F, C, G, D, A, E, B, F#, C#, G#, D#, A#

허용 형식: "C", "C major", "Am", "A minor", "Db major", "F# minor"

에이전트 지침

• 항상 --json 플래그를 사용하여 기계가 읽을 수 있는 출력을 받으세요.
• 내보내기 후 export verify로 결과를 검증하세요.
• 알 수 없는 악보를 작업하기 전에 media probe로 먼저 검사하세요.
• 조옮김에는 -i(입력)와 -o(출력)가 모두 필요합니다.
• parts extract에서 파트 이름은 대소문자를 구분하지 않습니다.