1 @c -*- coding: utf-8; mode: texinfo; -*-
3 Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. See TRANSLATION for details.
10 @unnumbered Introduction
12 @divClass{column-center-top}
15 @imageFloat{flat-design.png,right}
17 The inspiration for LilyPond came when two musicians became
18 annoyed with the bland and boring look of computer-printed
19 sheet music. All musicians prefer reading beautiful music, so why
20 couldn't programmers write software to produce better printed
23 This software just does that: it prints music in the best
24 traditions of classical engraving with minimum fuss. Don't waste
25 time on tuning spacing, moving around symbols, or shaping slurs.
26 Impress friends and colleagues with sharp sheet music!
29 @divClass{column-left-top}
30 @subheading Why use LilyPond?
35 @ref{Features}: What can LilyPond do?
38 @ref{Examples}: I want to see some music!
41 @ref{Freedom}: LilyPond is Free Software.
46 @divClass{column-right-top}
47 @subheading Who uses it?
52 @ref{Productions}: Real-life use of LilyPond.
55 @ref{Testimonials}: What do people say?
60 @divClass{column-center-bottom}
61 @subheading Why not use LilyPond?
66 @ref{Text input}: You write music as @emph{text}?!
75 * Features:: What can LilyPond do?
76 * Examples:: I want to see some music!
77 * Freedom:: Freedom and the GPL.
78 * Productions:: Real-life use of LilyPond.
79 * Testimonials:: What do people say about it?
80 * Text input:: You write music as text?!
87 @unnumberedsec Features
89 @help{hoping to delegate this. Desired: an enthusiastic
90 attempt to sway people towards trying lilypond. The warnings
91 about writing music as text come in Crash Course, not here. Maybe
93 http://lilypond.org/web/about/features
95 http://lilypond.org/web/switch/tour
97 http://lilypond.org/web/switch/advantages
100 @subheading Why switch to LilyPond?
103 @subsubheading Excellent classical engraving
105 @imageFloat{flat-design.png,right}
107 The point of using LilyPond is to produce elegant sheet music that
108 is easy to read. LilyPond's developer community has spent
109 thousands of hours developing powerful music engraving software
110 that results in beautifully engraved music. All of LilyPond's
111 style settings, font designs and algorithms have been inspired by
112 the finest hand-engraved music. LilyPond output has the same
113 strong, balanced and elegant look as the best-engraved classical
117 @subsubheading No fiddling
119 Don't waste time with tweaking the output; LilyPond gets the
120 formatting correct right from the start. It determines spacing by
121 itself, and breaks lines and pages to provide a tight and uniform
122 layout. Clashes between lyrics, notes, and chords are resolved
123 and slurs and beams are sloped, automatically!
126 @subsubheading Text-based input
128 LilyPond takes ASCII input, which you can produce in your favorite
129 text editor, quickly and comfortably. No more futzing with the
130 mouse. The input contains all the information, so there is no
131 need to remember complex command sequences. Simply save an input
135 @subsubheading Mix music and text
137 @imageFloat{lilypond-book.png,right}
139 Put fragments of music into texts without cutting and pasting
140 pictures. Integrate music into LaTeX or HTML seamlessly, or add
141 music to OpenOffice.org with ooolilypond.
145 @subsubheading Free software
147 LilyPond can be downloaded free of charge! Yep - It's free. Get
148 it from the download page.
150 It's also free (as in @qq{speech}) software. It comes with source
151 code, and permission to change and copy it. So, are you irritated
152 by a bug, or yearning for a feature? Simply add it yourself, or
153 pay someone else to do it.
156 @subsubheading Extensible design
158 All settings can be changed to suit your personal
159 typographical taste. If that still is not enough, there is always
160 the built-in scripting language, a dialect of the powerful
161 language LISP. Settings, variables and functions are all
162 documented in the comprehensive program reference manual.
165 @subsubheading Excellent support
167 LilyPond runs on all popular platforms: Linux, MacOS X, and
168 Windows. LilyPond comes with extensive documetation and hundreds
169 of example files. There is an active user community answering
170 questions on the Lilypond user mailing list, while the development
171 team makes sure that problems are solved quickly.
175 @divClass{column-center-bottom}
176 @subheading Where now?
178 Still not convinced? Look at some neat @ref{Examples}. If you've
179 already decided to try LilyPond, first read about our
186 @unnumberedsec Examples
188 Lilypond is a powerful and flexible tool for engraving tasks of
189 all kinds. Please browse our gallery of examples and be inspired!
192 Here is a passage from Franz Liszt's solo piano transcription
193 of the Overture to Wagner's @emph{Tannhäuser}. The spacing
194 in this example was all performed by Lilypond's formatting
195 algorithms, without tweaks of any kind. It
196 handles cross-staff beaming gracefully and puts the system brace
197 perfectly around all three staves.
199 @imageClickable{examples/liszt-wagner-small.png, (click to enlarge), examples/liszt-wagner.png, center}
203 @subsubheading Classical Music
204 This organ work by J.S. Bach is a fairly typical engraving project
207 @imageClickable{examples/bach-bwv610-small.png, (click to enlarge), examples/bach-bwv610.png, center}
211 @subsubheading Complex Notation
213 This example from @emph{Goyescas} by Enrique Granados shows some
214 of the more advanced features of typesetting, including kneed
215 beams, cross-staff stems, and voice-follow lines.
217 @imageClickable{examples/granados-small.png, (click to enlarge), examples/granados.png, center}
221 @subsubheading Early Music
222 Lilypond also supports various types of ancient notation, such
223 as this passage of Gregorian chant.
225 @imageClickable{examples/ancient-headword-small.png, (click to enlarge), examples/ancient-headword.png, center}
229 @subsubheading Modern Music
230 Contemporary composers find Lilypond well-suited to displaying
231 unusual notation. Here is an excerpt from Trevor Bača's
232 @emph{Čáry}, for unaccompanied bass flute.
234 @imageClickable{examples/cary-small.png, (click to enlarge), examples/cary.png, center}
239 @subsubheading Efficient, flexible creation of performance materials
240 Various performance materials can be created from the same source
241 code. This is an excerpt of @uref{http://nicolas.sceaux.free.fr/,
242 Nicolas Sceaux's} engraving of Handel's @emph{Giulio Cesare}, in
243 full score, piano-vocal reduction, and a violin part.
245 @imageClickable{examples/sesto-small.png, (click to enlarge), examples/sesto.png, center}
247 @imageClickable{examples/sesto-1-small.png, (click to enlarge), examples/sesto-1.png, center}
249 @imageClickable{examples/sesto-2-small.png, (click to enlarge), examples/sesto-2.png, center}
253 @help NEED BETTER TABLATURE EXAMPLE!!
256 @subsubheading Tablature
257 Lilypond supports tablature notation, which can be customized to
258 suit any instrument that reads from tablature. Here is a passage
259 from a Bach Lute Suite, with tablature generated automatically
260 from the notes entered for the traditional staff.
262 @imageClickable{examples/bach-tab-example-small.png, (click to enlarge), examples/bach-tab-example.png, center}
266 @subsubheading Schenker Graphs
267 Standard output can be modified heavily. Here someone has created
268 an impressive Schenkerian analysis.
270 @imageClickable{examples/bach-schenker-small.png, (click to enlarge), examples/bach-schenker.png, center}
274 @subsubheading Vocal Music
275 Lilypond is excellent for vocal music of all kinds, from sacred
276 hymns to opera. Here is a medieval motet with slightly unusual
277 requirements. The tenor voice is written in a different meter
278 than the others, but must line up as if it were in the same meter.
279 Lilypond handles this most elegantly. Note also the incipits with
280 Vaticana style clefs, the slashed stems indicating plicated notes,
281 and the ligature braces above certain groups of notes.
283 @imageClickable{examples/aucun-snippet-small.png, (click to enlarge), examples/aucun-snippet.png, center}
287 @subsubheading Educational Applications
288 Lilypond is perfectly suited for educational purposes as well.
289 Here is an example of a simple counterpoint exercise.
291 @imageClickable{examples/theory-small.png, (click to enlarge), examples/theory.png, center}
294 @help NEED BETTER POP EXAMPLE!! Also a better theory example would be nice.
297 @subsubheading Popular Music
298 It is simple to create pop lead sheets with melody, lyrics,
299 chord names, and fretboards. In this example you see some of the
300 predefined fretboard diagrams, but these can be heavily customized
301 to suit nearly any situation.
303 @imageClickable{examples/chart-small.png, (click to enlarge), examples/chart.png, center}
306 @help NEED DIFFERENT ORCHESTRAL OR OPERA EXAMPLE?!
309 @subsubheading Large Projects
310 Lilypond is excellent for large projects like operas or works for
311 full symphony orchestra, as well. Score, parts, piano reductions,
312 and conductors' scores can be produced from the same source files.
314 @imageClickable{examples/orchestral-small.png, (click to enlarge), examples/orchestral.png, center}
318 @divClass{column-center-bottom}
319 @subheading Where now?
321 Still not convinced? LilyPond is Free software, granting you
322 @ref{Freedom}. If you've already decided to try LilyPond, first
323 read about our @ref{Text input}.
328 @unnumberedsec Freedom
330 @divClass{column-center-top}
331 @subheading Free Software
333 @uref{http://www.gnu.org/, GNU} LilyPond is written and maintained
334 by a community of enthusiasts. It is published under the
335 @ref{GPL, GNU General Public License} and the @ref{FDL, GNU Free
336 Documentation License}, giving everybody the freedom to fix,
337 modify, and extend the program. Creating beautiful music should
338 not require hundreds of dollars of software!
342 @c @divClass{column-left-top}
344 @divClass{keep-bullets}
345 @subheading What are the benefits to users?
350 No cost: download and try it out! What do you have to lose?
353 Sharing: if you like the program, give a copy to your friends,
354 teachers, students, and colleagues!
357 Source available: if you are curious about how LilyPond creates
358 some notation, you can see exactly how it is done.
361 Extendible: you can add features, fix bugs, and change the
362 functionality. If you are not a programmer, you can hire somebody
365 This may not seem appealing to casual musicians, but the ability
366 to extend software can be highly valuable to serious composers,
367 companies, and academics.
370 Future safety: if a commercial company goes bankrupt, what happens
371 to any electronic music which depends on their products? This is
372 not a concern with LilyPond; even if the entire development team
373 quits (extremely unlikely), the program will still be legally
374 available for copying, modifications, and distribution.
383 @c @divClass{column-right-top}
385 @divClass{keep-bullets}
386 @subheading Why do LilyPond developers @qq{give away} their work for free?
388 Most of us view LilyPond development as a hobby or volunteer work.
389 So this question is really asking @qq{why do people volunteer}?
394 Fun: working towards a goal can be enjoyable, especially when you
398 Shared goals: we all want beautiful sheet music, but few people
399 have the expertise (and nobody has the time!), to create a program
400 which can handle all situations. By working together -- one
401 person improves the automatic beaming code, another person
402 improves the shape of slurs, and a third person writes
403 documentation explaining how to use these features -- we can
404 achieve our goal with only a fraction of the individual effort.
407 @qq{Gift culture}: the Free Software (or @qq{Open Source})
408 movement has created many great software projects, such as
409 @uref{http://kernel.org/, GNU/Linux},
410 @uref{http://www.getfirefox.com/, Mozilla Firefox}, and
411 @uref{http://www.wesnoth.org/, Battle for Wesnoth}. Having
412 benefitted from these projects, some developers want to @qq{give
413 back} to the community.
416 Work experience: contributing to open-source projects is a great
417 way to practice programming, documentation writing, or design.
418 This experience has helped some developers gain job offers or
428 @divClass{column-center-bottom}
429 @subheading Where now?
431 Still not convinced? Read about some of our users'
432 @ref{Productions} and sheet music. If you've already decided to
433 try LilyPond, first read about our @ref{Text input}.
438 @unnumberedsec Productions
440 @help{more references to publishers who use lilypond}
442 @divClass{column-left-top}
445 Lilypond engravings have been used for performances around the world.
448 @divClass{keep-bullets}
452 @emph{Affaire Étrangère}, an opera by Valentin Villenave, with
453 libretto by Lewis Trondheim, premiered February 1, 2009, by
454 @uref{http://www.orchestre-montpellier.com/, L'Opéra Montpellier}.
457 @uref{http://www.mercurybaroque.org/02/02109.aspx, Mercury Baroque}'s
458 performance of Lully's @emph{Armide}, May 15-16, 2009, in Houston,
459 Texas (engraving by @uref{http://nicolas.sceaux.free.fr/,
463 Instrumental excerpts from Rameau's @emph{Hippolyte et Aricie} at
464 St. James's Church in Manhattan, May 8, 2009, by Frederick Renz
465 and his ensemble @uref{http://www.earlymusicny.org/, Early Music
466 New York} (engraving by Nicolas Sceaux).
474 @divClass{column-right-top}
475 @subheading Published sheet music
477 @divClass{keep-bullets}
481 @uref{http://www.adoromusicpub.com/, Adoro Music Publishing},
482 high-quality scores of sacred music, available for immediate
483 download or in traditional paper format.
490 @divClass{column-center-bottom}
491 @subheading Where now?
493 Still not convinced? Read some of our users' @ref{Testimonials}.
494 If you've already decided to try LilyPond, first read about our
500 @unnumberedsec Testimonials
502 @divClass{testimonial-item}
503 @imageFloat{carter-brey.jpg, right}
504 @subsubheading @uref{http://nyphil.org/meet/orchestra/index.cfm?page=profile&personNum=7, Carter Brey}, Principal Cellist, New York Philharmonic
506 @qq{... I've written a couple of encore pieces for solo cello
507 which I've printed with LilyPond and which I'm going to submit to
508 Schirmer for publication. I'll bet their engraved version wouldn't
509 look half as sharp as mine!}
513 @divClass{testimonial-item}
514 @imageFloat{orm-finnendahl.jpg, left}
515 @subsubheading @uref{http://icem-www.folkwang-hochschule.de/~finnendahl/, Orm Finnendahl}, professor of Composition, Musikhochschule Freiburg
517 @qq{Although I don't know [LilyPond] very well yet, I'm *very*
518 impressed. I used the program to input a motet of Josquin Desprez
519 in mensural notation and there's no doubt that lilypond outscores
520 all other notation programs easily concerning speed, ease of use
525 @divClass{testimonial-item}
526 @imageFloat{darius-blasband.jpg, right}
527 @subsubheading Darius Blasband, composer (Brussels, Belgium)
529 @qq{[..after the first orchestra rehearsal] I got numerous
530 compliments about the quality of the scores. Even more
531 importantly, while Lilypond provides numerous hacks to improve the
532 way its scores look, what the orchestra got from me is basically
533 the raw, untouched output.}
538 @divClass{testimonial-item}
539 @subsubheading Kieren MacMillan, composer (Toronto, Canada)
541 @qq{thanks and kudos to the development team for their incredible
542 work. I've never seen anything approaching the output that I get
543 from Lilypond -- I'm totally confident that my music publishing
544 needs will be fulfilled beyond my expectations using this great
545 application. [..] basically untweaked Lilypond output [..] looks
546 better than most recent "professional" publications I've compared
547 it to (q.v., just about any Warner Bros. score, and even many of
548 the most recent by "the old houses"). [..]}
550 @qq{Beat that, Finale/Sibelius/Igor/whatever!!!}
554 @divClass{testimonial-item}
555 @subsubheading Chris Cannam, lead programmer of the @uref{http://www.rosegardenmusic.com/, RoseGarden} project.
557 @qq{Lilypond is obviously the zillion-ton gorilla [of great music
562 @divClass{testimonial-item}
563 @subsubheading Chris Snyder, @uref{http://www.adoromusicpub.com/, Adoro Music Publishing}
565 @qq{The way that music is entered for LilyPond causes me to think in a
566 more musical way -- there have been times when I've been stumped as
567 to how to tell Lily to engrave something, only to realize that
568 even if I did get it exactly as the composer wanted, the music
569 would be confusing to read. LilyPond makes it much easier for me
570 to work in my dual editor+engraver role.}
572 @qq{I've been using LilyPond exclusively for my fledgling music
573 publishing business. Virtually without exception, every composer
574 has been blown away by the quality of the engraving when presented
575 with the proofs of their music about to be published. I deserve
576 some of the credit for this -- I spend a lot of time tweaking
577 output, especially ties (mainly in chords) -- but LilyPond gives
578 me an excellent starting point, a very intuitive interface, and
579 the ability to modify absolutely anything if I want to take the
580 time. I'm convinced that no commercial product can come close.}
584 @divClass{testimonial-item}
585 @subsubheading David Bobroff, Bass Trombone, Iceland Symphony Orchestra
587 @qq{I think Lilypond is great [..] The more I learn about LilyPond
592 @divClass{testimonial-item}
593 @subsubheading Vaylor Trucks, Electric guitar player (Yes, @uref{http://www.allmanbrothersband.com/modules.php?op=modload&name=userpage&file=content&page_id=12, related to})
595 @qq{I am super impressed with LilyPond [..]}
597 @qq{THIS IS THE BEST PROGRAM EVER!!!}
599 @qq{Thank you all SO MUCH for your hard work and dedication!}
603 @divClass{testimonial-item}
604 @subsubheading @uref{http://nicolas.sceaux.free.fr/, Nicolas Sceaux}, @uref{http://www.mutopiaproject.org/, Mutopia} contributor
606 @qq{I had a kind of hate-passion relationship with it. Passion
607 because the first score I saw was so amazing! The description of
608 LilyPond lies about its beautifulness, it is too modest! [..] as
609 LilyPond is getting always better, and as I look closer how things
610 are done in scheme, I have less and less frustrations. Anyway,
611 what I mean is: thank you for providing LilyPond, it is really
616 @divClass{testimonial-item}
617 @subsubheading @uref{http://www.troff.org/whoswho.html#werner, Werner Lemberg}, Conductor at the Theatre in Koblenz, Germany and distinguished GNU Hacker.
619 @qq{Anyway, LilyPond does an amazingly good job!}
623 @divClass{testimonial-item}
624 @subsubheading Paul Davis, developer of @uref{http://jackaudio.org/, JACK} and @uref{http://www.ardour.org/, Ardour}.
626 @qq{I think [LilyPond is] an incredible program, and it produces
627 wonderful, wonderful output. when i read an interview about it
628 last year, i was raving to several friends of mine about its
633 @divClass{column-center-bottom}
634 @subheading Where now?
636 Read about our @ref{Text input}.
642 @unnumberedsec Text input
644 @c TRANSLATORS: so far it's mostly from
645 @c http://lilypond.org/web/switch/howto
647 @subheading @qq{Compiling} Music
649 @imageClickable{examples/nereid-shot-small.png, (click to enlarge), examples/nereid-shot.png, right}
651 LilyPond is a @emph{compiled} system: it is run on a text file
652 containing the notes. The resulting output is viewed on-screen or
653 printed. In some ways, LilyPond is more similar to a programming
654 language than graphical score editing software.
656 You do not write music by dragging notes from a graphical toolbar
657 and placing them on a dynamically refreshing score; you write
658 music by typing text. This text is interpreted (or @qq{compiled})
659 by LilyPond, which produces beautifully engraved sheet music.
661 People accustomed to graphical user interfaces might need to learn
662 a new way of working, but the results are definitely worth it!
664 @warning{We present a quick overview of our text input -- it's not
665 as complicated as it sounds! Don't worry about understanding
666 every detail in these examples; our beginner documentation covers
667 everything at a much more gradual pace.}
670 @subsubheading It's as simple as A B C
672 Notes are encoded with letters and numbers. Special commands are
673 entered with backslashes.
675 @imageFloat{text-input-1-annotate.png,center}
676 @imageFloat{text-input-1-output.png,center}
678 Alterations are made with different names: add @code{-is} for
679 sharp, and @code{-es} for flat (these are Dutch note names, other
680 languages are available). LilyPond figures out where to put
683 @imageFloat{text-input-2-annotate.png,center}
684 @imageFloat{text-input-2-output.png,center}
687 @subsubheading Pop music
689 Put chords and lyrics together to get a lead sheet:
691 @help{change the lyrics. svg available}
693 @imageFloat{text-input-pop-annotate.png,center}
694 @imageFloat{text-input-pop-output.png,center}
698 @subsubheading Orchestral parts
700 The input file contains the notes of piece. Score and parts can
701 be made from a single input file. So, changing a note always
702 affects both parts and score. To share the notes, the music is
703 assigned to a variable:
705 @imageFloat{text-input-parts-both-annotate.png,center}
708 This variable is then used in a single part (here transposed, with
709 condensed multi rests):
711 @imageFloat{text-input-parts-single-annotate.png,center}
712 @imageFloat{text-input-parts-single-output.png,center}
715 The same variable is used in the full score (here in concert
718 @imageFloat{text-input-score-annotate.png,center}
719 @imageFloat{text-input-score-output.png,center}
722 @subsubheading Beginner Documentation
724 We realize that many users find this way of entering music a bit
725 odd. For this reason, we have written extensive documentation to
726 help new users, beginning with @ref{Learning}.
728 Please read the Learning Manual before complaining about bugs!
729 New users occasionally believe that LilyPond is not working
730 correctly, when in fact it is working precisely as designed.
732 @help{any suggestions for a picture here?}
735 @subsubheading Easier editing environments
737 LilyPond is primarily concerned with producing top-quality
738 engraved sheet music; creating a Graphical User Interface (GUI)
739 would distract us from this goal. However, there are other
740 projects aimed at making it easier to create LilyPond input files.
742 Some editing environments include syntax highlighting, automatic
743 command completion, and pre-made templates. Other programs
744 actually provide a GUI which allows direct manipulation of a
745 graphical score. For more information, see our documentation
746 about @@ref@{FIXME alternate editing environments@}.
749 @divClass{column-center-bottom}
750 @subheading Where now?
752 You are now ready to @ref{Download, Download LilyPond}.
754 Still not convinced? Many composers, musicians, and conductors
755 have learned how to write music in our input format. Experienced
756 users even report that they can enter a full score in LilyPond
757 faster than with a piano keyboard or mouse+GUI! Perhaps you would
758 like to review the @ref{Features}, @ref{Examples}, or
759 @ref{Freedom} that LilyPond provides, or read about users'
760 @ref{Productions} and @ref{Testimonials}.