Scroll to navigation



musicxml2ly - manual page for musicxml2ly (LilyPond) 2.22.1


musicxml2ly [OPTION]... FILE.xml


Convert MusicXML from FILE.xml to LilyPond input. If the given filename is -, musicxml2ly reads from the command line.


show this help and exit
show version number and exit
be verbose
use lxml.etree; uses less memory and cpu time
input file is a compressed MusicXML file (by default, activate if file extension is .mxl)
convert pitches in relative mode (default)
convert pitches in absolute mode
use LANG for pitch names, e.g. 'deutsch' for note names in German
Print log messages according to LOGLEVEL (NONE, ERROR, WARNING, PROGRESS (default), DEBUG)
do not convert directions (^, _ or -) for articulations, dynamics, etc.
do not convert exact vertical positions of rests
ignore system breaks
ignore page breaks
ignore page margins
do not convert the exact page layout and breaks (shortcut for "--nsb --npb --npm" options)
ignore stem directions from MusicXML, use lilypond's automatic stemming instead
do not convert beaming information, use lilypond's automatic beaming instead
set output filename to FILE, stdout if -
activate midi-block in .ly file
set pitch to transpose by the interval between pitch 'c' and TOPITCH
change the length|duration of notes as a function of a given time signature to make the score look faster or slower, (eg. '4/4' or '2/2')
switch between two versions of tab clefs ("tab" and "moderntab")
deactivate string number stencil with --string-numbers f[alse]. Default is t[rue]
converts '<frame>' events to a separate FretBoards voice instead of markups


Report bugs via


Copyright © 2005--2021 by

Han-Wen Nienhuys <>, Jan Nieuwenhuizen <> and Reinhold Kainhofer <> Patrick L. Schmidt <>

This program is free software. It is covered by the GNU General Public License and you are welcome to change it and/or distribute copies of it under certain conditions. Invoke as `lilypond --warranty' for more information.


The full documentation for musicxml2ly is maintained as a Texinfo manual. If the info and musicxml2ly programs are properly installed at your site, the command

info musicxml2ly

should give you access to the complete manual.

September 2021 musicxml2ly (LilyPond) 2.22.1