Reference

musicxml2ly(1)

manual page for musicxml2ly (LilyPond) 2.26.0

NAME

musicxml2ly - manual page for musicxml2ly (LilyPond) 2.26.0

SYNOPSIS

musicxml2ly [OPTION]... FILE

DESCRIPTION

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 -1 doubles 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

REPORTING BUGS

Report bugs via [email protected]

COPYRIGHT

Copyright © 2005--2026 by

Han-Wen Nienhuys <[email protected]>, Jan Nieuwenhuizen <[email protected]>, Reinhold Kainhofer <[email protected]>, Patrick L. Schmidt <[email protected]>, and Werner Lemberg <[email protected]>

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.

SEE ALSO

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.

History

--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).