.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.4.
.TH MUSICXML2LY "1" "June 2026" "musicxml2ly (LilyPond) 2.26.0" "User Commands"
.SH NAME
musicxml2ly \- manual page for musicxml2ly (LilyPond) 2.26.0
.SH SYNOPSIS
.B musicxml2ly
[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR
.SH DESCRIPTION
Convert FILE with MusicXML data to a LilyPond input file.
.PP
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).
.PP
If FILE cannot be found, 'FILE.xml', 'FILE.musicxml', and 'FILE.mxl' are
also tried as input files.
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help and exit
.TP
\fB\-\-version\fR
show version number and exit
.TP
\fB\-v\fR, \fB\-\-verbose\fR
be verbose
.TP
\fB\-\-lxml\fR
obsolete
.TP
\fB\-z\fR, \fB\-\-compressed\fR
input file is a compressed MusicXML file (by default,
activate if file extension is .mxl)
.TP
\fB\-r\fR, \fB\-\-relative\fR
convert pitches in relative mode (default)
.TP
\fB\-a\fR, \fB\-\-absolute\fR
convert pitches in absolute mode
.TP
\fB\-l\fR, \fB\-\-language\fR=\fI\,LANG\/\fR
use LANG for pitch names, e.g., 'deutsch' for note
names in German
.TP
\fB\-\-loglevel\fR=\fI\,LOGLEVEL\/\fR
Print log messages according to LOGLEVEL (NONE, ERROR,
WARN, PROGRESS (default), DEBUG)
.TP
\fB\-\-oe\fR, \fB\-\-ottavas\-end\-early\fR=\fI\,t[rue]\/\fR/f[alse]
expect <octave\-shift> end elements before the
associated <note> (as in Finale). Default is f[alse]
.TP
\fB\-\-nd\fR, \fB\-\-no\-articulation\-directions\fR
do not convert directions (^, _ or \-) for
articulations, dynamics, etc.
.TP
\fB\-\-nrp\fR, \fB\-\-no\-rest\-positions\fR
do not convert exact vertical positions of rests
.TP
\fB\-\-nsb\fR, \fB\-\-no\-system\-breaks\fR
ignore system breaks
.TP
\fB\-\-npb\fR, \fB\-\-no\-page\-breaks\fR
ignore page breaks
.TP
\fB\-\-npm\fR, \fB\-\-no\-page\-margins\fR
ignore page margins
.TP
\fB\-\-npl\fR, \fB\-\-no\-page\-layout\fR
do not convert the exact page layout and breaks
(shortcut for "\-\-nsb \fB\-\-npb\fR \fB\-\-npm\fR" options)
.TP
\fB\-\-nsd\fR, \fB\-\-no\-stem\-directions\fR
ignore stem directions from MusicXML, use lilypond's
automatic stemming instead
.TP
\fB\-\-ds\fR, \fB\-\-dynamics\-scale\fR=\fI\,FACTOR\/\fR
scale <dynamics> elements by a non\-negative FACTOR;
value 0 means to use lilypond's standard size for
dynamics
.TP
\fB\-\-afs\fR, \fB\-\-absolute\-font\-sizes\fR
use absolute font sizes in markup (default is to use
font sizes based on score size)
.TP
\fB\-\-nb\fR, \fB\-\-no\-beaming\fR
do not convert beaming information, use lilypond's
automatic beaming instead
.TP
\fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR
set output filename to FILE, stdout if \-
.TP
\fB\-m\fR, \fB\-\-midi\fR
activate midi\-block in .ly file
.TP
\fB\-\-cp\fR, \fB\-\-credit\-page\fR=\fI\,N\/\fR
use <credit> information from page N to fill the
fields of the \eheader block. Default is value 1
.TP
\fB\-\-transpose\fR=\fI\,TOPITCH\/\fR
set pitch to transpose by the interval between pitch
\&'c' and TOPITCH
.TP
\fB\-\-sd\fR, \fB\-\-shift\-durations\fR=\fI\,VALUE\/\fR
shift durations and time signatures by VALUE; for
example, value \fB\-1\fR doubles all durations, and value 1
halves them
.TP
\fB\-\-sm\fR, \fB\-\-shift\-meter\fR=\fI\,BEATS\/\fR/BEATTYPE
ignored; use `\-\-shift\-duration` instead
.TP
\fB\-\-tc\fR, \fB\-\-tab\-clef\fR=\fI\,TABCLEFNAME\/\fR
switch between two versions of tab clefs ("tab" and
"moderntab")
.TP
\fB\-\-sn\fR, \fB\-\-string\-numbers\fR=\fI\,t[rue]\/\fR/f[alse]
control output of string numbers; value f[alse]
disables them. Default is t[rue]
.TP
\fB\-\-fb\fR, \fB\-\-fretboards\fR
convert '<frame>' events to a separate FretBoards
voice instead of markups
.TP
\fB\-\-book\fR
put top\-level score into '\ebook'
.TP
\fB\-\-nt\fR, \fB\-\-no\-tagline\fR
don't emit a LilyPond tagline
.SH "REPORTING BUGS"
Report bugs via bug\-lilypond@gnu.org
.SH COPYRIGHT
Copyright \(co 2005\-\-2026 by
.IP
Han\-Wen Nienhuys <hanwen@xs4all.nl>,
Jan Nieuwenhuizen <janneke@gnu.org>,
Reinhold Kainhofer <reinhold@kainhofer.com>,
Patrick L. Schmidt <pls@philomelos.net>, and
Werner Lemberg <wl@gnu.org>
.PP
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 \fB\-\-warranty\fR' for more
information.
.SH "SEE ALSO"
The full documentation for
.B musicxml2ly
is maintained as a Texinfo manual.  If the
.B info
and
.B musicxml2ly
programs are properly installed at your site, the command
.IP
.B info musicxml2ly
.PP
should give you access to the complete manual.