MuseScore CLI 技能
概述
封裝 MuseScore 4 的 mscore 後端,用於音樂記譜任務:移調、匯出多種格式(PDF、PNG、MP3、MIDI、MusicXML、布拉耶點字)、分部提取、樂器管理及樂譜分析。
命令
專案管理
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,分部名稱不區分大小寫