lilypond-book [OPTION]... FILE


Process LilyPond snippets in hybrid HTML, LaTeX, texinfo or DocBook document.


-F, --filter=FILTER

pipe snippets through FILTER [default: `convert-ly -n -']

-f, --format=FORMAT

use output format FORMAT (texi [default], texi-html, latex, html, docbook)

-h, --help

show this help and exit

-I, --include=DIR

add DIR to include path


format Texinfo output so that Info will look for images of music in DIR


pad left side of music to align music inspite of uneven bar numbers (in mm)


Print lilypond log messages according to LOGLEVEL


write lily-XXX files to DIR, link into --output dir


Load the additional python PACKAGE (containing e.g. a custom output format)

-l, --loglevel=LOGLEVEL

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

-o, --output=DIR

write output to DIR

-P, --process=COMMAND

process ly_files using COMMAND FILE...


Redirect the lilypond output

-s, --safe

Compile snippets in safe mode


do not fail if no lilypond output is found


do not fail if no PNG images are found for EPS files


write snippet output files with the same base name as their source file

-V, --verbose

be verbose


show version number and exit

-w, --warranty

show warranty and copyright

Options only for the latex and texinfo backends:


run executable PROG instead of latex, or in case --pdf option is set instead of pdflatex


run executable PROG instead of texi2pdf


create PDF files for use with PDFTeX


  • $ lilypond-book --filter="tr '[a-z]' '[A-Z]'" BOOK

    $ lilypond-book -F "convert-ly --no-version --from=2.0.0 -" BOOK

    $ lilypond-book --process='lilypond -I include' BOOK


Report bugs via

RELATED TO lilypond-book…

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

  • info lilypond-book

should give you access to the complete manual.