MuseScore CLI

Habilidad CLI de MuseScore

Resumen

Envuelve el backend mscore de MuseScore 4 para tareas de notación musical: transposición, exportación a múltiples formatos (PDF, PNG, MP3, MIDI, MusicXML, Braille), extracción de partes, gestión de instrumentos y análisis de partituras.

Comandos

Gestión de proyectos

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

Transposición

# Transponer a una tonalidad destino
cli-anything-musescore --json transpose by-key -i score.mscz -o out.mscz --target-key "Do mayor" --direction closest

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

# Transposición diatónica
cli-anything-musescore --json transpose diatonic -i score.mscz -o out.mscz --steps 2

Extracción de partes

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/

Exportación

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

Gestión de instrumentos

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 "Violín"

Análisis de partituras

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

Sesión

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

Formatos de entrada admitidos

• .mscz (nativo de MuseScore)
• .mxl (MusicXML comprimido)
• .musicxml / .xml (MusicXML)
• .mid / .midi (MIDI)

Nombres de tonalidades para transposición

Mayores: Do♭, Sol♭, Re♭, La♭, Mi♭, Si♭, Fa, Do, Sol, Re, La, Mi, Si, Fa#, Do# Menores: La♭, Mi♭, Si♭, Fa, Do, Sol, Re, La, Mi, Si, Fa#, Do#, Sol#, Re#, La#

Formatos aceptados: "Do", "Do mayor", "Lam", "La menor", "Reb mayor", "Fa# menor"

Guía para el agente

• Usa siempre la bandera --json para obtener salidas legibles por máquina
• Verifica las exportaciones con export verify después de renderizar
• Usa media probe para inspeccionar una partitura desconocida antes de operar sobre ella
• La transposición requiere tanto -i (entrada) como -o (salida)
• Los nombres de las partes no distinguen entre mayúsculas y minúsculas en parts extract