Back to Details

cli-anything-musescore

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

MuseScore CLI Skill

MuseScore CLI 技能

Overview

概述

Wraps MuseScore 4's 
mscore
backend for music notation tasks: transposition, export to multiple formats (PDF, PNG, MP3, MIDI, MusicXML, Braille), part extraction, instrument management, and score analysis.
封装MuseScore 4的
mscore
后端，用于乐谱记谱相关任务：移调、导出为多种格式（PDF、PNG、MP3、MIDI、MusicXML、盲文）、声部提取、乐器管理以及乐谱分析。

Commands

命令

Project Management

项目管理

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

Transposition

移调

bash
undefined
bash
undefined

Transpose to a target key

移调至目标调

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-key -i score.mscz -o out.mscz --target-key "C major" --direction closest

Transpose by semitones

按半音移调

cli-anything-musescore --json transpose by-interval -i score.mscz -o out.mscz --semitones 3
cli-anything-musescore --json transpose by-interval -i score.mscz -o out.mscz --semitones 3

Diatonic transposition

自然音移调

cli-anything-musescore --json transpose diatonic -i score.mscz -o out.mscz --steps 2
undefined
cli-anything-musescore --json transpose diatonic -i score.mscz -o out.mscz --steps 2
undefined

Part Extraction

声部提取

bash
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/
bash
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/

Export

导出

bash
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
bash
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

Instrument Management

乐器管理

bash
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"
bash
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"

Score Analysis

乐谱分析

bash
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
bash
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

Session

会话管理

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

Supported Input Formats

支持的输入格式

  • .mscz
    (MuseScore native)
  • .mxl
    (compressed MusicXML)
  • .musicxml
    / 
    .xml
    (MusicXML)
  • .mid
    / 
    .midi
    (MIDI)
  • .mscz
    （MuseScore原生格式）
  • .mxl
    （压缩版MusicXML）
  • .musicxml
    / 
    .xml
    （MusicXML）
  • .mid
    / 
    .midi
    （MIDI）

Key Names for Transposition

移调用调名

Major: Cb, Gb, Db, Ab, Eb, Bb, F, C, G, D, A, E, B, F#, C# Minor: Ab, Eb, Bb, F, C, G, D, A, E, B, F#, C#, G#, D#, A#
Accepted formats: "C", "C major", "Am", "A minor", "Db major", "F# minor"
大调：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"

Agent Guidance

Agent 指引

  • Always use 
    --json
    flag for machine-readable output
  • Verify exports with 
    export verify
    after rendering
  • Use 
    media probe
    to inspect an unknown score before operating on it
  • Transposition requires both 
    -i
    (input) and 
    -o
    (output)
  • Part names are case-insensitive for 
    parts extract
  • 始终使用
    --json
    参数以获取机器可读的输出
  • 渲染完成后使用
    export verify
    验证导出结果
  • 在处理未知乐谱前，使用
    media probe
    检查其信息
  • 移调操作同时需要
    -i
    （输入）和
    -o
    （输出）参数
  • parts extract
    中的声部名称不区分大小写