---
name: "convert-ly"
section: "1"
platform: "linux"
package: "lilypond"
version: "1:2.26.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/convert-ly"
---

# convert-ly(1)

manual page for convert-ly 2.26.0

## NAME

convert-ly - manual page for convert-ly 2.26.0

## SYNOPSIS

**convert-ly** \[*OPTION*\]... *FILE*

## DESCRIPTION

Update LilyPond input to newer version.  By default, update from the version taken from the \\version command, to the current LilyPond version. If FILE is \`-', read from standard input.

## OPTIONS

- **--version**

  show version number and exit

- **-h**, **--help**

  show this help and exit

- **-f**, **--from**=*VERSION*

  start from VERSION \[default: \\version found in file\]

- **-e**, **--edit**

  edit in place

- **-l**, **--loglevel**=*LOGLEVEL*

  Print log messages according to LOGLEVEL (NONE, ERROR, WARN, PROGRESS (default), DEBUG)

- **-n**, **--no-version**

  do not add \\version command if missing

- **-c**, **--current-version**

  force updating \\version number to 2.26.0

- **-d**, **--diff-version-update**

  only update \\version number if file is modified

- **-s**, **--show-rules**

  show rules \[default: **-f** 0, **-t** 2.26.0\]

- **-t**, **--to**=*VERSION*

  convert to VERSION \[default: 2.26.0\]

- **-b**, **--backup-numbered**

  make a numbered backup \[default: filename.ext~\]

- **-v**, **--verbose**

  print rule descriptions during conversion

- **-w**, **--warranty**

  show warranty and copyright

## EXAMPLES

-

  `$ convert-ly -e old.ly`\
   `$ convert-ly --from=2.3.28 --to=2.5.21 foobar.ly > foobar-new.ly`

## REPORTING BUGS

Report bugs via bug-lilypond@gnu.org

## SEE ALSO

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

-

  **info convert-ly**

should give you access to the complete manual.