musicxml2ly1
Manual page for musicxml2ly (lilypond) 2.26.0
Usage
musicxml2ly [OPTION] ...
FILE
Overview
Convert FILE with MusicXML data to a LilyPond input file.
By default, the output file is called 'FILE.ly' for input file 'FILE.xml'. If FILE is '-', read from standard input (and write to standard output).
If FILE cannot be found, 'FILE.xml', 'FILE.musicxml', and 'FILE.mxl' are also tried as input files.
Options
-
-h, --help -
show this help and exit
-
--version -
show version number and exit
-
-v, --verbose -
be verbose
-
--lxml -
obsolete
-
-z, --compressed -
input file is a compressed MusicXML file (by default, activate if file extension is .mxl)
-
-r, --relative -
convert pitches in relative mode (default)
-
-a, --absolute -
convert pitches in absolute mode
-
-l, --language=LANG -
use LANG for pitch names, e.g., 'deutsch' for note names in German
-
--loglevel=LOGLEVEL -
Print log messages according to LOGLEVEL (NONE, ERROR, WARN, PROGRESS (default), DEBUG)
-
--oe, --ottavas-end-early=t[rue]/f[alse] -
expect <octave-shift> end elements before the associated <note> (as in Finale). Default is f[alse]
-
--nd, --no-articulation-directions -
do not convert directions (^, _ or -) for articulations, dynamics, etc.
-
--nrp, --no-rest-positions -
do not convert exact vertical positions of rests
-
--nsb, --no-system-breaks -
ignore system breaks
-
--npb, --no-page-breaks -
ignore page breaks
-
--npm, --no-page-margins -
ignore page margins
-
--npl, --no-page-layout -
do not convert the exact page layout and breaks (shortcut for "--nsb
--npb--npm" options)
-
--nsd, --no-stem-directions -
ignore stem directions from MusicXML, use lilypond's automatic stemming instead
-
--ds, --dynamics-scale=FACTOR -
scale <dynamics> elements by a non-negative FACTOR; value 0 means to use lilypond's standard size for dynamics
-
--afs, --absolute-font-sizes -
use absolute font sizes in markup (default is to use font sizes based on score size)
-
--nb, --no-beaming -
do not convert beaming information, use lilypond's automatic beaming instead
-
-o, --output=FILE -
set output filename to FILE, stdout if -
-
-m, --midi -
activate midi-block in .ly file
-
--cp, --credit-page=N -
use <credit> information from page N to fill the fields of the \header block. Default is value 1
-
--transpose=TOPITCH -
set pitch to transpose by the interval between pitch 'c' and TOPITCH
-
--sd, --shift-durations=VALUE -
shift durations and time signatures by VALUE; for example, value
-1doubles all durations, and value 1 halves them
-
--sm, --shift-meter=BEATS/BEATTYPE -
ignored; use `--shift-duration` instead
-
--tc, --tab-clef=TABCLEFNAME -
switch between two versions of tab clefs ("tab" and "moderntab")
-
--sn, --string-numbers=t[rue]/f[alse] -
control output of string numbers; value f[alse] disables them. Default is t[rue]
-
--fb, --fretboards -
convert '<frame>' events to a separate FretBoards voice instead of markups
-
--book -
put top-level score into '\book'
-
--nt, --no-tagline -
don't emit a LilyPond tagline
History
- Arch Linux 2026-11-01: the text shown here
- Debian 13 (Trixie)
- Debian 12 (Bookworm)
- Debian 11 (Bullseye)
- Debian 10 (Buster)
- Debian 8 (Jessie)
- Debian 7 (Wheezy)
- Debian 6.0 (Squeeze)
- Debian 5.0 (Lenny)
- Debian 4.0 (Etch)
--absolute since Debian 6.0 (Squeeze);
--absolute-font-sizes since Arch Linux 2026-11-01;
--afs since Arch Linux 2026-11-01;
--book since Arch Linux 2026-11-01;
--compressed since Debian 6.0 (Squeeze);
--cp since Arch Linux 2026-11-01;
--credit-page since Arch Linux 2026-11-01;
--ds since Arch Linux 2026-11-01;
--dynamics-scale since Arch Linux 2026-11-01;
--fb since Debian 11 (Bullseye);
--fretboards since Debian 11 (Bullseye);
--language since Debian 6.0 (Squeeze);
--loglevel since Debian 8 (Jessie);
--lxml since Debian 5.0 (Lenny);
--midi since Debian 8 (Jessie);
--nb since Debian 11 (Bullseye);
--nd since Debian 6.0 (Squeeze);
--no-articulation-directions since Debian 6.0 (Squeeze);
--no-beaming since Debian 6.0 (Squeeze);
--no-page-breaks since Debian 11 (Bullseye);
--no-page-layout since Debian 7 (Wheezy);
--no-page-margins since Debian 11 (Bullseye);
--no-rest-positions since Debian 6.0 (Squeeze);
--no-stem-directions since Debian 11 (Bullseye);
--no-system-breaks since Debian 11 (Bullseye);
--no-tagline since Arch Linux 2026-11-01;
--npb since Debian 11 (Bullseye);
--npl since Debian 7 (Wheezy);
--npm since Debian 11 (Bullseye);
--nrp since Debian 6.0 (Squeeze);
--nsb since Debian 11 (Bullseye);
--nsd since Debian 11 (Bullseye);
--nt since Arch Linux 2026-11-01;
--oe since Arch Linux 2026-11-01;
--ottavas-end-early since Arch Linux 2026-11-01;
--relative since Debian 6.0 (Squeeze);
--sd since Arch Linux 2026-11-01;
--shift-durations since Arch Linux 2026-11-01;
--shift-meter since Arch Linux 2026-11-01;
--sm since Arch Linux 2026-11-01;
--sn since Arch Linux 2026-11-01;
--string-numbers since Arch Linux 2026-11-01;
--tab-clef since Arch Linux 2026-11-01;
--tc since Arch Linux 2026-11-01;
--transpose since Debian 11 (Bullseye);
-a since Debian 6.0 (Squeeze);
-l since Debian 6.0 (Squeeze);
-m since Debian 8 (Jessie);
-r since Debian 6.0 (Squeeze);
-z since Debian 6.0 (Squeeze).