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. For details, see the Contributors'
7 Guide, node Updating translation committishes..
11 @unnumbered Introduction
13 @divClass{column-center-top}
16 @imageFloat{flat-design,png,right}
18 LilyPond came about when two musicians wanted to go beyond the
19 soulless look of computer-printed sheet music. Musicians prefer
20 reading beautiful music, so why couldn't programmers write
21 software to produce elegant printed parts?
23 The result is a system which frees musicians from the details of
24 layout, allowing them to focus on making music. LilyPond works
25 with them to create publication-quality parts, crafted in the best
26 traditions of classical music engraving.
30 @divClass{column-left-top}
31 @subheading What LilyPond does
36 @ref{Features}: What can LilyPond do?
39 @ref{Examples}: I want to see some music!
42 @ref{Freedom}: LilyPond is Free Software.
45 @ref{Background}: Our computational aesthetics.
50 @divClass{column-right-top}
51 @subheading LilyPond in use
55 @ref{Productions}: Real-life use of LilyPond.
58 @ref{Reviews}: What do people say?
63 @divClass{column-center-bottom}
64 @subheading How LilyPond works
68 @ref{Text input}: You write music as @emph{text}?!
71 @ref{Easier editing}: Other ways of working with LilyPond.
76 @c TRANSLATORS, translations are not yet compiled in Info format, so
77 @c it's not worth translating the right column of the following
81 * Features:: What can LilyPond do?
82 * Examples:: I want to see some music!
83 * Freedom:: Freedom and the GPL.
84 * Background:: Computational aesthetics.
85 * Productions:: Real-life use of LilyPond.
86 * Reviews:: What do people say about it?
87 * Text input:: You write music as text?!
88 * Easier editing:: Other ways of working with LilyPond.
95 @unnumberedsec Features
96 @divClass{column-center-top}
100 @subsubheading Excellent classical engraving
102 @imageFloat{flat-design,png,right}
104 LilyPond allows musicians to produce elegant sheet music that is
105 easy to read. Its developer community has spent thousands of hours
106 developing powerful music engraving software that results in beautifully
107 engraved music. All of LilyPond's style settings, font designs and
108 algorithms have been inspired by the finest hand-engraved music.
109 LilyPond output has the same strong, balanced and elegant look as the
110 best-engraved classical scores. This is further explained in our
115 @subsubheading Effective layout choices
117 Spend less time with tweaking the output; LilyPond gets the
118 formatting correct right from the start. It determines spacing by
119 itself, and breaks lines and pages to provide a tight and uniform
120 layout. Clashes between lyrics, notes, and chords are resolved
121 and slurs and beams are sloped, automatically!
127 @subheading Ease of use
129 @imageFloat{lilypond-book,png,right}
131 @subsubheading Text-based input
133 LilyPond takes ASCII input, which you can produce in your favorite
134 text editor, quickly and comfortably. The input contains all the
135 information, so there is no need to remember complex command sequences:
136 simply save a file for later reference.
138 @subsubheading Mix music and text
140 Put fragments of music into texts without cutting and pasting
141 pictures. Integrate music into @LaTeX{} or HTML seamlessly, or add
142 music to OpenOffice.org with OOoLilyPond. Plugins are also available
143 to allow LilyPond code in various blogs and wikis, making online
144 collaboration possible.
147 @subsubheading Accessibility
149 Text-based input also makes score-writing possible for users with
150 severe physical disabilities. Dexterity-impaired users who are
151 unable to type or control a computer mouse can use
152 speech-recognition software to edit LilyPond files. Even users
153 who are totally blind can use screen-reading software to write
154 LilyPond files -- an impossible task in graphical-based
155 score-writing programs.
157 @subsubheading Extensible design
159 All settings can be changed to suit your personal typographical
160 taste. If that still is not enough, there is always the built-in
161 scripting language Scheme, a dialect of the powerful language
162 LISP. Settings, variables and functions are all documented in the
163 comprehensive program reference manual.
169 @subheading Environment
171 @imageFloat{frescobaldi-lilypond-editor-small,png,right}
173 @subsubheading Free software
175 LilyPond can be downloaded free of charge! Yep - It's free. Get
176 it from the download page.
178 It's also free (as in @qq{speech}) software. It comes with source
179 code, and permission to change and copy it. So, are you irritated
180 by a bug, or yearning for a feature? Simply add it yourself, or
181 pay someone else to do it.
184 @subsubheading Excellent support
186 LilyPond runs on all popular platforms: GNU/Linux, MacOS X, and
187 Windows. LilyPond comes with extensive documentation and hundreds
188 of example files. There is an active user community answering
189 questions on the lilypond-user mailing list, while the development
190 team makes sure that problems are solved quickly.
193 @subsubheading Enhanced editors
196 Several developers, themselves active LilyPond users, have also
197 written tools specifically aimed at making the process of editing
198 LilyPond files faster and more effective. For some examples, see
199 @ref{Easier editing}.
202 @divClass{column-center-bottom}
203 @subheading Where now?
205 Still not convinced? Look at some specific @ref{Examples}. If you've
206 already decided to try LilyPond, first read about our
213 @unnumberedsec Examples
215 LilyPond is a powerful and flexible tool for engraving tasks of
216 all kinds. Please browse our gallery of examples and be inspired!
220 @subsubheading Classical Music
222 This organ work by J.S. Bach is a fairly typical engraving project
225 @exampleImage{bach-bwv610}
229 @subsubheading Complex Notation
231 This example from @emph{Goyescas} by Enrique Granados shows some
232 of the more advanced features of typesetting, including kneed
233 beams, cross-staff stems, and voice-follow lines.
235 @exampleImage{granados}
239 @subsubheading Early Music
241 LilyPond also supports various types of ancient notation, such
242 as this passage of Gregorian chant.
244 @exampleImage{ancient-headword}
248 @subsubheading Modern Music
250 Contemporary composers find LilyPond well-suited to displaying
251 unusual notation. Here is an excerpt from Trevor Bača's
252 @emph{Čáry}, for unaccompanied bass flute.
259 @subsubheading Efficient, flexible creation of performance materials
261 Various performance materials can be created from the same source
262 code. This is an excerpt of @uref{http://nicolas.sceaux.free.fr/,
263 Nicolas Sceaux's} engraving of Handel's @emph{Giulio Cesare}, in
264 full score, piano-vocal reduction, and a violin part.
266 @exampleImage{sesto-full}
268 @exampleImage{sesto-piano}
270 @exampleImage{sesto-violin}
275 @subsubheading Tablature
277 LilyPond supports tablature notation, which can be customized to
278 suit any instrument that reads from tablature. The tablature
279 staff is generated automatically from notes entered for the 5-line
282 @exampleImage{tab-example}
286 @subsubheading Schenker Graphs
288 Standard output can be modified heavily. Here is an impressive
289 Schenkerian analysis, created by Kris Schaffer, for an article
290 in @uref{http://www.linuxjournal.com/article/8364 , Linux Journal.}.
291 The colors have been added for better visibility.
293 @exampleImage{bach-schenker}
297 @subsubheading Vocal Music
299 LilyPond is excellent for vocal music of all kinds, from sacred
300 hymns to opera. Here is a medieval motet with slightly unusual
301 requirements. The tenor voice is written in a different meter
302 than the others, but must line up as if it were in the same meter.
303 LilyPond handles this most elegantly. Note also the incipits with
304 Vaticana style clefs, the slashed stems indicating plicated notes,
305 and the ligature braces above certain groups of notes.
307 @exampleImage{aucun-snippet}
311 @subsubheading Educational Applications
313 LilyPond is perfectly suited for educational purposes as well.
314 Here is an example of a simple counterpoint exercise.
316 @exampleImage{theory}
320 @subsubheading Popular Music
322 It is simple to create pop lead sheets with melody, lyrics,
323 chord names, and fretboards. In this example you see some of the
324 predefined fretboard diagrams, but these can be heavily customized
325 to suit nearly any situation.
331 @subsubheading Large Projects
333 LilyPond is excellent for large projects like operas or works for
334 full symphony orchestra, as well. In addition, the text-based
335 input provides greater accessibility -- this example was
336 contributed by Hu Haipeng, a blind composer.
338 @exampleImage{orchestra}
342 @divClass{column-center-bottom}
343 @subheading Where now?
345 Still not convinced? LilyPond is Free software, granting you
346 @ref{Freedom}. If you've already decided to try LilyPond, first
347 read about our @ref{Text input}.
352 @unnumberedsec Freedom
354 @divClass{column-center-top}
355 @subheading Free Software
357 @uref{http://www.gnu.org/, GNU} LilyPond is written and maintained
358 by a community of enthusiasts. It is published under the
359 @ref{GPL, GNU General Public License} and the @ref{FDL, GNU Free
360 Documentation License}, giving everybody the freedom to fix,
361 modify, and extend the program. Creating beautiful music should
362 not require hundreds of dollars of software!
366 @c @divClass{column-left-top}
368 @divClass{keep-bullets}
369 @subheading What are the benefits to users?
374 No cost: download and try it out! What do you have to lose?
377 Sharing: if you like the program, give a copy to your friends,
378 teachers, students, and colleagues!
381 Source available: if you are curious about how LilyPond creates
382 some notation, you can see exactly how it is done.
385 Extendible: you can add features, fix bugs, and change the
386 functionality. If you are not a programmer, you can hire somebody
389 This may not seem appealing to casual musicians, but the ability
390 to extend software can be highly valuable to serious composers,
391 companies, and academics.
394 Future safety: if a commercial company goes bankrupt, what happens
395 to any electronic music which depends on their products? This is
396 not a concern with LilyPond; even if the entire development team
397 quits (extremely unlikely), the program will still be legally
398 available for copying, modifications, and distribution.
407 @c @divClass{column-right-top}
409 @divClass{keep-bullets}
410 @subheading Why do LilyPond developers @qq{give away} their work for free?
412 Most of us view LilyPond development as a hobby or volunteer work.
413 So this question is really asking @qq{why do people volunteer}?
418 Fun: working towards a goal can be enjoyable, especially when you
422 Shared goals: we all want beautiful sheet music, but few people
423 have the expertise (and nobody has the time!), to create a program
424 which can handle all situations. By working together -- one
425 person improves the automatic beaming code, another person
426 improves the shape of slurs, and a third person writes
427 documentation explaining how to use these features -- we can
428 achieve our goal with only a fraction of the individual effort.
431 @qq{Gift culture}: the Free Software (or @qq{Open Source})
432 movement has created many great software projects, such as
433 @uref{http://kernel.org/, GNU/Linux},
434 @uref{http://www.getfirefox.com/, Mozilla Firefox}, and
435 @uref{http://www.wesnoth.org/, Battle for Wesnoth}. Having
436 benefitted from these projects, some developers want to @qq{give
437 back} to the community.
440 Work experience: contributing to open-source projects is a great way to
441 practice programming, documentation writing, documentation translation,
442 or design. This experience has helped some developers gain job offers
452 @divClass{column-center-bottom}
453 @subheading Where now?
455 Still not convinced? Read our extensive essay about our engraving
456 philosophy in @ref{Background}. If you've already decided to try
457 LilyPond, first read about our @ref{Text input}.
462 @unnumberedsec Background
464 @divClass{column-center-top}
465 @subheading Background essay
467 We have an extensive essay describing computational aesthetics:
468 the art of creating beauty with a computer.
470 If you just want a quick introduction to LilyPond, the essay might
471 be too much material to read. If you would like to read it now,
472 please progress to @ref{Essay}.
475 @divClass{column-center-bottom}
476 @subheading Where now?
478 Still not convinced? Read about some of our users'
479 @ref{Productions} and sheet music. If you've already decided to
480 try LilyPond, first read about our @ref{Text input}.
485 @unnumberedsec Productions
487 @divClass{column-left-top}
490 LilyPond engravings have been used for performances around the world.
493 @divClass{keep-bullets}
497 @emph{Affaire étrangère}, an opera by
498 @uref{http://valentin.villenave.net/,Valentin Villenave}
499 to a French libretto by
500 @uref{http://en.wikipedia.org/wiki/Lewis_Trondheim, Lewis
501 Trondheim}, premiered February 1, 2009 at
502 @uref{http://www.orchestre-montpellier.com/, L'Opéra National de
503 Montpellier}, France.
506 @uref{http://www.mercurybaroque.org/02/02109.aspx, Mercury Baroque}'s
507 performance of Lully's @emph{Armide}, May 15-16, 2009, in Houston,
508 Texas (engraving by @uref{http://nicolas.sceaux.free.fr/,
512 Instrumental excerpts from Rameau's @emph{Hippolyte et Aricie} at
513 St. James's Church in Manhattan, May 8, 2009, by Frederick Renz
514 and his ensemble @uref{http://www.earlymusicny.org/, Early Music
515 New York} (engraving by Nicolas Sceaux).
523 @divClass{column-right-top}
524 @subheading Published sheet music
526 @divClass{keep-bullets}
530 @uref{http://www.mutopiaproject.org/index.html, Mutopia Project},
531 over 1500 pieces of classical sheet music for free download, and
532 the main showcase of LilyPond scores.
534 @c don't make this "Mutopia" a link, since that looks silly.
536 @uref{http://etudeapp.com, Etude}, @qq{sheet music on steroids} is
537 an iPhone app which displays piano music engraved with LilyPond,
538 including many pieces from Mutopia. The app includes a virtual
539 piano keyboard showing which keys to press to help beginners learn
540 how to read sheet music.
543 @uref{http://www.adoromusicpub.com/, Adoro Music Publishing},
544 high-quality scores of sacred music, available for immediate
545 download or in traditional paper format.
548 @uref{http://theshadylanepublishing.com/, The Shady Lane
550 a @qq{micro musical publishing house} whose goal is to promote a
551 new form of musical economy closer to the musicians and music
561 @divClass{column-center-bottom}
562 @subheading Where now?
564 Still not convinced? Read some of our users' @ref{Reviews}.
565 If you've already decided to try LilyPond, first read about our
569 @c TRANSLATORS, so far it's mostly from
570 @c http://lilypond.org/web/switch/testimonials
573 @unnumberedsec Reviews
575 @divClass{column-left-top}
576 @subheading Published articles
578 @divClass{keep-bullets}
584 The German LinuxUser magazine wrote an
585 @uref{http://www.linux-community.de/Internal/Artikel/Print-Artikel/LinuxUser/2009/10/Digitaler-Notenschluessel,
586 article about LilyPond}.
592 In @uref{http://www.musicbyandrew.ca/finale-lilypond-1.html,
593 articles on his personal site}, Andrew Hawryluk compares Finale
594 and LilyPond in general terms, and evaluates engraving
595 capabilities of both pieces of software in detail. The second
596 article is an instructive analysis of engraving issues in
597 Rachmaninoff's Piano Prelude No. 6, including comparisons with a
598 hand-engraved reference edition.
603 @uref{http://distrowatch.com,DistroWatch} awards LilyPond and
604 @uref{http://distrowatch.com/weekly.php?issue=20060605,writes}
605 @qq{Ladies and Gentleman, we are pleased to announce that, based
606 on readers' requests, the DistroWatch May 2006 donation has been
607 awarded to LilyPond (@euro{}190.00) and Lua (US$250.00).}
612 @uref{http://linuxjournal.com,Linux Journal} publishes an article
613 titled @uref{http://www.linuxjournal.com/article/8364, Make
614 Stunning Schenker Graphs with GNU LilyPond}. It is an in-depth
615 but hands-on feature article with crisp LilyPond graphics. Author
616 Kris Shaffer remarks @qq{GNU LilyPond generates beautiful graphics
617 that make commercial alternatives seem second-rate.}
622 The Belgian newspaper De Standaard investigates what drives Free
623 Software authors in an article titled
624 @uref{http://www.standaard.be/Artikel/Detail.aspx?artikelId=G42H5GD6,
625 Delen van KENNIS zonder WINSTBEJAG} (Non-profit sharing of
626 knowlegde) in its @q{DS2 bijlage}. LilyPond is used as an example
627 and the article is interspersed with quotes from an email
628 interview with Jan Nieuwenhuizen. This marks LilyPond's first
629 appearance in mainstream printed press.
634 A French article on the LilyPond 2.6 release appeared on
635 @uref{http://linuxfr.org/2005/06/27/19210.html, linuxfr.org}.
640 The editors of Computer!Totaal, a Dutch computer magazine,
641 @uref{http://lilypond.org/web/images/computer-totaal.jpeg,
642 describe LilyPond} in the October 2004 issue as: @qq{Wonderful
643 free (open source) software [..] The sheet music produced by
644 LilyPond is exceptionally pretty [..] a very powerful system that
645 can do almost anything.}
650 Dave Phillips wrote an introductory article for
651 @uref{http://linuxjournal.com,Linux Journal}: At
652 the sounding edge: LilyPond, parts
653 @uref{http://www.linuxjournal.com/article/7657, one} and
654 @uref{http://www.linuxjournal.com/article/7719, two}.
660 @uref{http://www.all-day-breakfast.com/cannam/linux-musician/lilypond.html,interviewed}
661 Han-Wen Nienhuys and Jan Nieuwenhuizen on linuxmusician.com
662 (original site defunct). This interview was also reviewed in a
663 @uref{http://slashdot.org/article.pl?sid=04/03/13/2054227&tid=,
669 Jazz singer Gail Selkirk writes about
670 @uref{http://www.songbirdofswing.com/editorial_page/lilypond/,
671 Diving into LilyPond}. @qq{... you can make lead sheets or full
672 orchestral parts, and the results can be stunning.}
673 @uref{http://www.computermusic.co.uk/, Computer Music Special},
682 @divClass{column-right-top}
683 @subheading User testimonials
685 @divClass{testimonial-item}
686 @imageFloat{carter-brey,jpg, right}
687 @subsubheading @uref{http://nyphil.org/meet/orchestra/index.cfm?page=profile&personNum=7, Carter Brey}, Principal Cellist, New York Philharmonic
689 @qq{@dots{} I've written a couple of encore pieces for solo cello
690 which I've printed with LilyPond and which I'm going to submit to
691 Schirmer for publication. I'll bet their engraved version wouldn't
692 look half as sharp as mine!}
696 @divClass{testimonial-item}
697 @imageFloat{orm-finnendahl,jpg, left}
698 @subsubheading @uref{http://icem-www.folkwang-hochschule.de/~finnendahl/, Orm Finnendahl}, professor of Composition, Musikhochschule Freiburg
700 @qq{Although I don't know [LilyPond] very well yet, I'm
701 @strong{*very} impressed. I used the program to input a motet of
702 Josquin Desprez in mensural notation and there's no doubt that
703 lilypond outscores all other notation programs easily concerning
704 speed, ease of use and look!}
708 @divClass{testimonial-item}
709 @imageFloat{darius-blasband,jpg, right}
710 @subsubheading Darius Blasband, composer (Brussels, Belgium)
712 @qq{[..after the first orchestra rehearsal] I got numerous
713 compliments about the quality of the scores. Even more
714 importantly, while LilyPond provides numerous hacks to improve the
715 way its scores look, what the orchestra got from me is basically
716 the raw, untouched output.}
720 @divClass{testimonial-item}
721 @subsubheading Kieren MacMillan, composer (Toronto, Canada)
723 @qq{thanks and kudos to the development team for their incredible
724 work. I've never seen anything approaching the output that I get
725 from LilyPond -- I'm totally confident that my music publishing
726 needs will be fulfilled beyond my expectations using this great
727 application. [..] basically untweaked LilyPond output [..] looks
728 better than most recent @q{professional} publications I've compared
729 it to (q.v., just about any Warner Bros. score, and even many of
730 the most recent by @q{the old houses}). [..]}
732 @qq{Beat that, Finale/Sibelius/Igor/whatever!!!}
736 @divClass{testimonial-item}
737 @subsubheading Chris Cannam, lead programmer of the @uref{http://www.rosegardenmusic.com/, RoseGarden} project
739 @qq{LilyPond is obviously the zillion-ton gorilla [of great music
744 @divClass{testimonial-item}
745 @subsubheading Chris Snyder, @uref{http://www.adoromusicpub.com/, Adoro Music Publishing}
747 @qq{The way that music is entered for LilyPond causes me to think in a
748 more musical way -- there have been times when I've been stumped as
749 to how to tell Lily to engrave something, only to realize that
750 even if I did get it exactly as the composer wanted, the music
751 would be confusing to read. LilyPond makes it much easier for me
752 to work in my dual editor+engraver role.}
754 @qq{I've been using LilyPond exclusively for my fledgling music
755 publishing business. Virtually without exception, every composer
756 has been blown away by the quality of the engraving when presented
757 with the proofs of their music about to be published. I deserve
758 some of the credit for this -- I spend a lot of time tweaking
759 output, especially ties (mainly in chords) -- but LilyPond gives
760 me an excellent starting point, a very intuitive interface, and
761 the ability to modify absolutely anything if I want to take the
762 time. I'm convinced that no commercial product can come close.}
766 @divClass{testimonial-item}
767 @subsubheading David Bobroff, Bass Trombone, Iceland Symphony Orchestra
769 @qq{I think LilyPond is great [..] The more I learn about LilyPond
774 @divClass{testimonial-item}
775 @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})
777 @qq{I am super impressed with LilyPond [..]}
779 @qq{THIS IS THE BEST PROGRAM EVER!!!}
781 @qq{Thank you all SO MUCH for your hard work and dedication!}
785 @divClass{testimonial-item}
786 @subsubheading @uref{http://nicolas.sceaux.free.fr/, Nicolas Sceaux}, @uref{http://www.mutopiaproject.org/, Mutopia} contributor
788 @qq{I had a kind of hate-passion relationship with it. Passion
789 because the first score I saw was so amazing! The description of
790 LilyPond lies about its beautifulness, it is too modest! [..] as
791 LilyPond is getting always better, and as I look closer how things
792 are done in scheme, I have less and less frustrations. Anyway,
793 what I mean is: thank you for providing LilyPond, it is really
798 @divClass{testimonial-item}
799 @subsubheading @uref{http://www.troff.org/whoswho.html#werner, Werner Lemberg}, Conductor at the Theatre in Koblenz, Germany and distinguished GNU Hacker
801 @qq{Anyway, LilyPond does an amazingly good job!}
805 @divClass{testimonial-item}
806 @subsubheading Paul Davis, developer of @uref{http://jackaudio.org/, JACK} and @uref{http://www.ardour.org/, Ardour}
808 @qq{I think [LilyPond is] an incredible program, and it produces
809 wonderful, wonderful output. when i read an interview about it
810 last year, i was raving to several friends of mine about its
816 @divClass{column-center-bottom}
817 @subheading Where now?
819 Read about our @ref{Text input}.
825 @unnumberedsec Text input
827 @c TRANSLATORS, so far it's mostly from
828 @c http://lilypond.org/web/switch/howto
830 @subheading @qq{Compiling} Music
832 @imageClickable{nereid-shot-small,png, (click to enlarge), nereid-shot,png, right}
834 LilyPond is a @emph{compiled} system: it is run on a text file
835 describing the music. The resulting output is viewed on-screen or
836 printed. In some ways, LilyPond is more similar to a programming
837 language than graphical score editing software.
839 You do not write music by dragging notes from a graphical toolbar
840 and placing them on a dynamically refreshing score; you write
841 music by typing text. This text is interpreted (or @qq{compiled})
842 by LilyPond, which produces beautifully engraved sheet music.
844 People accustomed to graphical user interfaces might need to learn
845 a new way of working, but the results are definitely worth it!
847 @warning{We present a quick overview of our text input -- it's not
848 as complicated as it sounds! Don't worry about understanding
849 every detail in these examples; our beginner documentation covers
850 everything at a much more gradual pace.}
853 @subsubheading It's as simple as A B C
855 Notes are encoded with letters and numbers. Special commands are
856 entered with backslashes.
858 @imageFloat{text-input-1-annotate,png,center}
859 @imageFloat{text-input-1-output,png,center}
861 Alterations are made with different names: add @code{-is} for
862 sharp, and @code{-es} for flat (these are Dutch note names, other
863 languages are available). LilyPond figures out where to put
866 @imageFloat{text-input-2-annotate,png,center}
867 @imageFloat{text-input-2-output,png,center}
870 @subsubheading Pop music
872 Put chords and lyrics together to get a lead sheet:
874 @imageFloat{text-input-pop-annotate,png,center}
875 @imageFloat{text-input-pop-output,png,center}
879 @subsubheading Orchestral parts
881 The input file contains the notes of piece of music. Score and
882 parts can be made from a single input file, so that changing a
883 note always affects the score and parts. To be able to include
884 the same music in multiple places, the music is assigned to a
885 @qq{variable} (a name).
887 @imageFloat{text-input-parts-both-annotate,png,center}
890 This variable is then used in a single part (here transposed, with
891 condensed rests spanning several measures):
893 @imageFloat{text-input-parts-single-annotate,png,center}
894 @imageFloat{text-input-parts-single-output,png,center}
897 The same variable is used in the full score (here in concert
900 @imageFloat{text-input-score-annotate,png,center}
901 @imageFloat{text-input-score-output,png,center}
904 @subsubheading Beginner Documentation
906 We realize that many users find this way of entering music a bit
907 odd. For this reason, we have written extensive documentation to
908 help new users, beginning with @ref{Learning}. The Learning
909 Manual is the best place to start, as many questions are answered
912 Please read the Learning Manual before complaining about bugs!
913 New users occasionally believe that LilyPond is not working
914 correctly, when in fact it is working precisely as designed.
916 More in-depth information is available in @ref{Manuals}.
919 @subsubheading Easier editing environments
921 @imageClickable{lilykde-screenshot-small,png,
922 (click to enlarge),lilykde-screenshot,png,right}
924 LilyPond is primarily concerned with producing top-quality
925 engraved sheet music; creating a Graphical User Interface (GUI)
926 would distract us from this goal. However, there are other
927 projects aimed at making it easier to create LilyPond input files.
929 Some editing environments include syntax highlighting, automatic
930 command completion, and pre-made templates. Other programs
931 actually provide a GUI which allows direct manipulation of a
932 graphical score. For more information, see @ref{Easier editing}.
936 @divClass{column-center-bottom}
937 @subheading Where now?
939 You are now ready to @ref{Download, Download LilyPond}. Still not
940 convinced? Read about @ref{Easier editing}.
946 @unnumberedsec Easier editing
949 @divClass{column-center-top}
950 @subheading LilyPondTool
952 @imageClickable{lilypondtool-2.12-screenshot-400wide,png,
953 (click to enlarge),lilypondtool-2.12-screenshot,png,right}
955 @sourceimage{logo-linux,,,}
956 @sourceimage{logo-freebsd,,,}
957 @sourceimage{logo-macosx,,,}
958 @sourceimage{logo-windows,,,}
960 @uref{http://lilypondtool.organum.hu}
962 Created as a plugin for the
963 @uref{http://www.jedit.org,jEdit} text editor,
964 LilyPondTool is one of the most feature-rich text-based tools for
965 editing LilyPond scores. Its features include a Document Wizard
966 with lyrics support to set up documents easier, and embedded PDF
967 viewer with advanced point-and-click support.
971 @divClass{column-center-top}
972 @subheading Frescobaldi
974 @imageClickable{frescobaldi-lilypond-editor-small,png,
975 (click to enlarge),frescobaldi-lilypond-editor,png,right}
977 @sourceimage{logo-linux,,,}
978 @sourceimage{logo-freebsd,,,}
980 @uref{http://www.frescobaldi.org}
982 Frescobaldi is a dedicated LilyPond music and text editor with a
983 built-in PDF previewer, a powerful score wizard and many editing
984 features. It is built on top of the KDE4 libraries and runs
985 currently on all flavours of Linux and other UNIX-like operating
990 @divClass{column-center-top}
993 @imageClickable{screenshot-denemo-small,png,
994 (click to enlarge),screenshot-denemo,png,right}
996 @sourceimage{logo-linux,,,}
997 @sourceimage{logo-windows,,,}
999 @uref{http://denemo.org}
1001 Denemo is a graphical editor which generates LilyPond source code,
1002 and also allows audio playback. It allows users to view the
1003 LilyPond source code in parallel to the graphical view. Extra
1004 LilyPond tweaks can be attached to notes, chords etc. and are stored
1005 with the Denemo file, so that users can continue to edit graphically.
1007 Moving the cursor in the LilyPond text moves the cursor in the graphical
1008 view, and any syntax errors in your LilyPond tweaks are highlighted in
1009 the text view when printed from there.
1011 @warning{Denemo officially supports an outdated Lilypond version 2.8.7,
1012 which lacks many of the features added since then. The Denemo developers
1013 are actively working to bring it up to our present stable version, 2.12.}
1016 @divClass{column-center-top}
1017 @subheading Text environment: Emacs and Vim
1019 @sourceimage{logo-linux,,,}
1020 @sourceimage{logo-freebsd,,,}
1021 @sourceimage{logo-macosx,,,}
1022 @sourceimage{logo-windows,,,}
1024 @uref{http://www.gnu.org/software/emacs/}
1026 Emacs is a text editor with language-sensitive capabilities for
1027 many different computer languages. Emacs is a highly extensible
1028 editor and can be used as an Integrated Development Environment.
1029 There is a @q{lilypond mode} which supplies the language
1030 definitions for working with LilyPond source files. As well, one of
1031 our developers has written @uref{http://nicolas.sceaux.free.fr/
1032 lilypond/lyqi.html,lyqi}, an Emacs major mode.
1034 @uref{http://www.vim.org}
1036 Vim is a minimal text editor and is an extension of the older Unix
1037 @command{vi} editor. It is also extensible and configurable.
1039 As a general rule, if you are not already familiar with Emacs or
1040 Vim, then you would probably prefer to use a different editor for
1041 writing LilyPond input files.
1043 More information on setting up Emacs and Vim can be found in
1044 @rprogram{Text editor support}.
1048 @ignore these may not need to be here at all, as they are purely
1051 @divClass{column-center-top}
1055 @subsubheading Text environment: TexShop
1057 @sourceimage{logo-macosx,,,}
1059 @uref{http://www.uoregon.edu/~koch/texshop}
1061 The TexShop editor for MacOS@tie{}X can be extended to run LilyPond,
1062 @command{lilypond-book} and @command{convert-ly} from within the editor,
1063 using the extensions available at:
1066 @uref{http://users.dimi.uniud.it/~nicola.vitacolonna/home/content/lilypond-scripts}
1069 @subsubheading TextMate
1071 @sourceimage{logo-macosx,,,}
1073 There is a LilyPond bundle for TextMate. It may be installed by
1077 mkdir -p /Library/Application\ Support/TextMate/Bundles
1078 cd /Library/Application\ Support/TextMate/Bundles
1079 svn co http://svn.textmate.org/trunk/Bundles/LilyPond.tmbundle/
1085 @divClass{column-center-top}
1086 @subheading Other programs can export LilyPond code
1089 @subsubheading Score, tab and MIDI editors:
1093 @uref{http://www.rosegardenmusic.com,Rosegarden}, an audio and
1094 MIDI sequencer, which also has a score editor for single-staff
1098 @uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml,NtEd},
1099 is based on the @uref{http://cairographics.org, Cairo} library and
1100 has experimental export for LilyPond.
1103 @uref{http://www.tuxguitar.com.ar/,TuxGuitar}, a multitrack
1104 tablature editor and player, provides a score view as well as tab,
1105 and can export to LilyPond.
1108 @uref{http://musescore.org,MuseScore} has incomplete LilyPond
1109 export but is being actively developed.
1112 @uref{http://canorus.org,Canorus} can also export to LilyPond, but
1113 is still beta-software. Testers are welcome, though.
1116 @uref{http://www.volny.cz/smilauer/rumor/rumor.html,Rumor}, a realtime
1117 monophonic MIDI to LilyPond converter.
1121 @subsubheading Algorithmic code generators
1126 @uref{http://strasheela.sourceforge.net, Strasheela} is @qq{a
1127 highly expressive constraint-based music composition system}.
1130 @uref{http://common-lisp.net/project/fomus/,FOMUS}, a LISP library
1131 to generate music notation from computer music software environments.
1136 @divClass{column-center-top}
1138 @subheading Other programs not being actively developed
1143 @uref{http://lilykde.googlecode.com/,LilyKDE} has been replaced by
1144 @uref{http://www.frescobaldi.org/,Frescobaldi}, and exists as
1145 LilyKDE3 for KDE 3.5 and lilypond-KDE4 for KDE 4.1 only.
1148 @uref{http://noteedit.berlios.de,NoteEdit}, which imported
1149 @uref{http://www.musicxml.com/xml.html,MusicXML}, has been forked
1151 @uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml,NtEd}
1152 and @uref{http://canorus.org,Canorus}.
1156 @uref{http://lilycomp.sourceforge.net, LilyComp} is a graphical
1157 note entry program, acting much like a number-pad which produces
1165 @divClass{column-center-bottom}
1166 @subheading Where now?
1168 You are now ready to @ref{Download, Download LilyPond}.
1170 Still not convinced? Many composers, musicians, and conductors
1171 have learned how to write music in our input format. Experienced
1172 users even report that they can enter a full score in LilyPond
1173 faster than with a piano keyboard or mouse+GUI! Perhaps you would
1174 like to review the @ref{Features}, @ref{Examples}, or the
1175 @ref{Freedom} that LilyPond provides, or read about users'
1176 @ref{Productions} and @ref{Reviews}. In addition, our
1177 approach to the computational aesthetics of classical engraving is
1178 explained in our @ref{Background}.
1181 @subheading Legalese
1184 All logos and product images are copyright and trademark