| 1 |
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.4. |
| 2 |
.TH LILYPOND "1" "December 2025" "LilyPond 2.24.4 (running Guile 3.0)" "User Commands" |
| 3 |
.SH NAME |
| 4 |
LilyPond \- manual page for LilyPond 2.24.4 (running Guile 3.0) |
| 5 |
.SH SYNOPSIS |
| 6 |
.B lilypond |
| 7 |
[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR... |
| 8 |
.SH DESCRIPTION |
| 9 |
Typeset music and/or produce MIDI from FILE. |
| 10 |
.PP |
| 11 |
LilyPond produces beautiful music notation. |
| 12 |
For more information, see https://lilypond.org |
| 13 |
.SH OPTIONS |
| 14 |
.TP |
| 15 |
\fB\-f\fR, \fB\-\-formats\fR=\fI\,FORMATs\/\fR |
| 16 |
dump FORMAT,... Also as separate options: |
| 17 |
.TP |
| 18 |
\fB\-\-pdf\fR |
| 19 |
generate PDF files (default) |
| 20 |
.TP |
| 21 |
\fB\-\-svg\fR |
| 22 |
generate SVG files |
| 23 |
.TP |
| 24 |
\fB\-\-png\fR |
| 25 |
generate PNG files |
| 26 |
.TP |
| 27 |
\fB\-\-ps\fR |
| 28 |
generate PostScript files |
| 29 |
.TP |
| 30 |
\fB\-E\fR, \fB\-\-eps\fR |
| 31 |
generate Encapsulated PostScript files |
| 32 |
.TP |
| 33 |
\fB\-O\fR, \fB\-\-pspdfopt\fR=\fI\,KEY\/\fR |
| 34 |
set ps/pdf optimization to KEY, which is either |
| 35 |
\&'size' (default), 'TeX', or 'TeX\-GS' |
| 36 |
.TP |
| 37 |
\fB\-d\fR, \fB\-\-define\-default=SYM\fR[=\fI\,VAL\/\fR] |
| 38 |
set Scheme option SYM to VAL (default: '#t') |
| 39 |
.TP |
| 40 |
\fB\-d\fR, \fB\-\-define\-default\fR=\fI\,no\-SYM\/\fR |
| 41 |
set Scheme option SYM to '#f' |
| 42 |
.TP |
| 43 |
\fB\-d\fR, \fB\-\-define\-default\fR=\fI\,help\/\fR |
| 44 |
show help for Scheme options |
| 45 |
.TP |
| 46 |
\fB\-e\fR, \fB\-\-evaluate\fR=\fI\,EXPR\/\fR |
| 47 |
evaluate scheme code |
| 48 |
.TP |
| 49 |
\fB\-h\fR, \fB\-\-help\fR |
| 50 |
show this help and exit |
| 51 |
.TP |
| 52 |
\fB\-H\fR, \fB\-\-header\fR=\fI\,FIELD\/\fR |
| 53 |
dump \eheader field FIELD to file |
| 54 |
named BASENAME.FIELD |
| 55 |
.TP |
| 56 |
\fB\-I\fR, \fB\-\-include\fR=\fI\,DIR\/\fR |
| 57 |
append DIR to search path |
| 58 |
.TP |
| 59 |
\fB\-i\fR, \fB\-\-init\fR=\fI\,FILE\/\fR |
| 60 |
use FILE as init file |
| 61 |
.TP |
| 62 |
\fB\-j\fR, \fB\-\-jail\fR=\fI\,USER\/\fR,GROUP,JAIL,DIR |
| 63 |
chroot to JAIL, become USER:GROUP |
| 64 |
and cd into DIR |
| 65 |
.TP |
| 66 |
\fB\-l\fR, \fB\-\-loglevel\fR=\fI\,LOGLEVEL\/\fR |
| 67 |
print log messages according to LOGLEVEL, |
| 68 |
which is either NONE, ERROR, WARNING, |
| 69 |
BASIC, PROGRESS, INFO (default), or DEBUG |
| 70 |
.TP |
| 71 |
\fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR |
| 72 |
write output to FILE (suffix will be added) |
| 73 |
or to FOLDER, in which case the file name |
| 74 |
will be taken from the input file. |
| 75 |
.TP |
| 76 |
\fB\-\-relocate\fR |
| 77 |
(ignored) |
| 78 |
.TP |
| 79 |
\fB\-s\fR, \fB\-\-silent\fR |
| 80 |
no progress, only error messages |
| 81 |
(equivalent to \fB\-\-loglevel\fR=\fI\,ERROR\/\fR) |
| 82 |
.TP |
| 83 |
\fB\-v\fR, \fB\-\-version\fR |
| 84 |
show version number and exit |
| 85 |
.TP |
| 86 |
\fB\-V\fR, \fB\-\-verbose\fR |
| 87 |
be verbose (equivalent to \fB\-\-loglevel\fR=\fI\,DEBUG\/\fR) |
| 88 |
.TP |
| 89 |
\fB\-w\fR, \fB\-\-warranty\fR |
| 90 |
show warranty and copyright |
| 91 |
.PP |
| 92 |
You found a bug? Please read https://lilypond.org/bug\-reports.html |
| 93 |
.SH COPYRIGHT |
| 94 |
Copyright \(co 1996\-\-2023 by |
| 95 |
.IP |
| 96 |
Han\-Wen Nienhuys <[email protected]> |
| 97 |
Jan Nieuwenhuizen <[email protected]> |
| 98 |
and others. |
| 99 |
.PP |
| 100 |
This program is free software. It is covered by the GNU General Public |
| 101 |
License and you are welcome to change it and/or distribute copies of it |
| 102 |
under certain conditions. Invoke as `lilypond \fB\-\-warranty\fR' for more |
| 103 |
information. |
| 104 |
.SH "SEE ALSO" |
| 105 |
The full documentation for |
| 106 |
.B LilyPond |
| 107 |
is maintained as a Texinfo manual. If the |
| 108 |
.B info |
| 109 |
and |
| 110 |
.B LilyPond |
| 111 |
programs are properly installed at your site, the command |
| 112 |
.IP |
| 113 |
.B info LilyPond |
| 114 |
.PP |
| 115 |
should give you access to the complete manual. |