CONVERT-LY(1)

📦
version 2.26.0 · 9 versions
, in alpine 3.24

🌸 NAME 🌸

Hey bestie 💖 welcome to the manual page for convert-ly — that’s the convert-ly(1) page, iykyk. This whole adorable page is for convert-ly 2.26.0, and it’s literally here to explain the vibe.

✨ SYNOPSIS ✨

convert-ly [OPTION]... FILE

🦋 DESCRIPTION 🦋

Okay so convert-ly updates LilyPond input to a newer version. Glow-up for your LilyPond files, no cap ✨. By default, it updates from the version taken from the \version command to the current LilyPond version.

And bestie, if FILE is -, it reads from standard input. Iconic behavior, honestly 💅.

🎀 OPTIONS 🎀

  • --version — shows the version number and exits. Bye 👋
  • -h, --help — shows this help and exits. Very helpful queen behavior.
  • -f, --from=VERSION — starts from VERSION. The default is the \version found in the file.
  • -e, --edit — edits in place. Main-character move: it changes the file itself.
  • -l, --loglevel=LOGLEVEL — prints log messages according to LOGLEVEL: NONE, ERROR, WARN, PROGRESS (the default), DEBUG.
  • -n, --no-version — does not add a \version command if it’s missing.
  • -c, --current-version — forces updating the \version number to 2.26.0.
  • -d, --diff-version-update — only updates the \version number if the file is modified.
  • -s, --show-rules — shows rules. Default is -f 0, -t 2.26.0.
  • -t, --to=VERSION — converts to VERSION. Default is 2.26.0.
  • -b, --backup-numbered — makes a numbered backup. Default is filename.ext~.
  • -v, --verbose — prints rule descriptions during conversion.
  • -w, --warranty — shows 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 💌. Please be nice, bestie.

🧚 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. Slay 📚✨.

Sign-off time, bestie 💋: this page is from convert-ly 2.26.0, dated May 2026. Love u, bye! 🌈💖

📦 where this page comes from