3.4.1 Command line options for convert-ly

convert-ly always converts up to the last syntax change handled by it. This means that the \version number left in the file is usually lower than the version of convert-ly itself.

To upgrade LilyPond fragments in texinfo files, use

convert-ly --from=... --to=... --no-version *.itely

To see the changes in the LilyPond syntax between two versions, use

convert-ly --from=... --to=... -s

To upgrade many files at once, combine convert-ly with standard UNIX commands. This example will upgrade all .ly files in the current directory

for f in *.ly; do convert-ly -e $f; done;

In general, the program is invoked as follows:

convert-ly [option]… file

The following options can be given:


Do an inline edit of the input file. Overrides --output.


Set the version to convert from. If this is not set, convert-ly will guess this, on the basis of \version strings in the file.


Normally, convert-ly adds a \version indicator to the output. Specifying this option suppresses this.

-s, --show-rules

Show all known conversions and exit.


Set the goal version of the conversion. It defaults to the latest available version.

-h, --help

Print usage help.

Other languages: espaƱol, deutsch.

Application Usage