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.
44 @ref{Background}: Our computational aesthetics.
49 @divClass{column-right-top}
50 @subheading Who uses it?
55 @ref{Productions}: Real-life use of LilyPond.
58 @ref{Testimonials}: What do people say?
63 @divClass{column-center-bottom}
64 @subheading Why not use LilyPond?
69 @ref{Text input}: You write music as @emph{text}?!
72 @ref{Easier editing}: Other ways of working with LilyPond.
77 @c TRANSLATORS, translations are not yet compiled in Info format, so
78 @c it's not worth translating the right column of the following
82 * Features:: What can LilyPond do?
83 * Examples:: I want to see some music!
84 * Freedom:: Freedom and the GPL.
85 * Background:: Computational aesthetics.
86 * Productions:: Real-life use of LilyPond.
87 * Testimonials:: What do people say about it?
88 * Text input:: You write music as text?!
89 * Easier editing:: Other ways of working with LilyPond.
96 @unnumberedsec Features
98 @help{hoping to delegate this. Desired: an enthusiastic
99 attempt to sway people towards trying lilypond. The warnings
100 about writing music as text come in Crash Course, not here.}
102 Maybe draw inspiration from
103 @uref{http://lilypond.org/web/about/features} and
104 @uref{http://lilypond.org/web/switch/tour} and
105 @uref{http://lilypond.org/web/switch/advantages}
109 @subheading Why switch to LilyPond?
112 @subsubheading Excellent classical engraving
114 @imageFloat{flat-design,png,right}
116 The point of using LilyPond is to produce elegant sheet music that is
117 easy to read. Its developer community has spent thousands of hours
118 developing powerful music engraving software that results in beautifully
119 engraved music. All of LilyPond's style settings, font designs and
120 algorithms have been inspired by the finest hand-engraved music.
121 LilyPond output has the same strong, balanced and elegant look as the
122 best-engraved classical scores. This is further explained in our
126 @subsubheading Less fiddling
128 Spend less time with tweaking the output; LilyPond gets the
129 formatting correct right from the start. It determines spacing by
130 itself, and breaks lines and pages to provide a tight and uniform
131 layout. Clashes between lyrics, notes, and chords are resolved
132 and slurs and beams are sloped, automatically!
135 @subsubheading Text-based input
137 LilyPond takes ASCII input, which you can produce in your favorite
138 text editor, quickly and comfortably. No more futzing with the
139 mouse. The input contains all the information, so there is no
140 need to remember complex command sequences. Simply save an input
144 @subsubheading Accessibility
146 Text-based input also makes score-writing possible for users with
147 severe physical disabilities. Dexterity-impaired users who are
148 unable to type or control a computer mouse can use
149 speech-recognition software to edit LilyPond files. Even users
150 who are totally blind can use screen-reading software to write
151 LilyPond files -- an impossible task in graphical-based
152 score-writing programs.
155 @subsubheading Mix music and text
157 @imageFloat{lilypond-book,png,right}
159 Put fragments of music into texts without cutting and pasting
160 pictures. Integrate music into @LaTeX{} or HTML seamlessly, or add
161 music to OpenOffice.org with OOoLilyPond.
165 @subsubheading Free software
167 LilyPond can be downloaded free of charge! Yep - It's free. Get
168 it from the download page.
170 It's also free (as in @qq{speech}) software. It comes with source
171 code, and permission to change and copy it. So, are you irritated
172 by a bug, or yearning for a feature? Simply add it yourself, or
173 pay someone else to do it.
176 @subsubheading Extensible design
178 All settings can be changed to suit your personal typographical
179 taste. If that still is not enough, there is always the built-in
180 scripting language Scheme, a dialect of the powerful language
181 LISP. Settings, variables and functions are all documented in the
182 comprehensive program reference manual.
185 @subsubheading Excellent support
187 LilyPond runs on all popular platforms: GNU/Linux, MacOS X, and
188 Windows. LilyPond comes with extensive documentation and hundreds
189 of example files. There is an active user community answering
190 questions on the Lilypond user mailing list, while the development
191 team makes sure that problems are solved quickly.
195 @divClass{column-center-bottom}
196 @subheading Where now?
198 Still not convinced? Look at some neat @ref{Examples}. If you've
199 already decided to try LilyPond, first read about our
206 @unnumberedsec Examples
208 Lilypond is a powerful and flexible tool for engraving tasks of
209 all kinds. Please browse our gallery of examples and be inspired!
212 Here is a passage from Franz Liszt's solo piano transcription
213 of the Overture to Wagner's @emph{Tannhäuser}. The spacing
214 in this example was all performed by Lilypond's formatting
215 algorithms, without tweaks of any kind. It
216 handles cross-staff beaming gracefully and puts the system brace
217 perfectly around all three staves.
219 @exampleImage{liszt-wagner}
223 @subsubheading Classical Music
225 This organ work by J.S. Bach is a fairly typical engraving project
228 @exampleImage{bach-bwv610}
232 @subsubheading Complex Notation
234 This example from @emph{Goyescas} by Enrique Granados shows some
235 of the more advanced features of typesetting, including kneed
236 beams, cross-staff stems, and voice-follow lines.
238 @exampleImage{granados}
242 @subsubheading Early Music
244 Lilypond also supports various types of ancient notation, such
245 as this passage of Gregorian chant.
247 @exampleImage{ancient-headword}
251 @subsubheading Modern Music
253 Contemporary composers find Lilypond well-suited to displaying
254 unusual notation. Here is an excerpt from Trevor Bača's
255 @emph{Čáry}, for unaccompanied bass flute.
262 @subsubheading Efficient, flexible creation of performance materials
264 Various performance materials can be created from the same source
265 code. This is an excerpt of @uref{http://nicolas.sceaux.free.fr/,
266 Nicolas Sceaux's} engraving of Handel's @emph{Giulio Cesare}, in
267 full score, piano-vocal reduction, and a violin part.
269 @exampleImage{sesto-full}
271 @exampleImage{sesto-piano}
273 @exampleImage{sesto-violin}
278 @subsubheading Tablature
280 Lilypond supports tablature notation, which can be customized to
281 suit any instrument that reads from tablature. The tablature
282 staff is generated automatically from notes entered for the 5-line
285 @exampleImage{tab-example}
289 @subsubheading Schenker Graphs
291 Standard output can be modified heavily. Here someone has created
292 an impressive Schenkerian analysis.
294 @exampleImage{bach-schenker}
298 @subsubheading Vocal Music
300 Lilypond is excellent for vocal music of all kinds, from sacred
301 hymns to opera. Here is a medieval motet with slightly unusual
302 requirements. The tenor voice is written in a different meter
303 than the others, but must line up as if it were in the same meter.
304 Lilypond handles this most elegantly. Note also the incipits with
305 Vaticana style clefs, the slashed stems indicating plicated notes,
306 and the ligature braces above certain groups of notes.
308 @exampleImage{aucun-snippet}
312 @subsubheading Educational Applications
314 Lilypond is perfectly suited for educational purposes as well.
315 Here is an example of a simple counterpoint exercise.
317 @exampleImage{theory}
321 @subsubheading Popular Music
323 It is simple to create pop lead sheets with melody, lyrics,
324 chord names, and fretboards. In this example you see some of the
325 predefined fretboard diagrams, but these can be heavily customized
326 to suit nearly any situation.
332 @subsubheading Large Projects
334 Lilypond is excellent for large projects like operas or works for
335 full symphony orchestra, as well. In addition, the text-based
336 input provides greater accessibility -- this example was
337 contributed by Hu Haipeng, a blind composer.
339 @exampleImage{orchestra}
343 @divClass{column-center-bottom}
344 @subheading Where now?
346 Still not convinced? LilyPond is Free software, granting you
347 @ref{Freedom}. If you've already decided to try LilyPond, first
348 read about our @ref{Text input}.
353 @unnumberedsec Freedom
355 @divClass{column-center-top}
356 @subheading Free Software
358 @uref{http://www.gnu.org/, GNU} LilyPond is written and maintained
359 by a community of enthusiasts. It is published under the
360 @ref{GPL, GNU General Public License} and the @ref{FDL, GNU Free
361 Documentation License}, giving everybody the freedom to fix,
362 modify, and extend the program. Creating beautiful music should
363 not require hundreds of dollars of software!
367 @c @divClass{column-left-top}
369 @divClass{keep-bullets}
370 @subheading What are the benefits to users?
375 No cost: download and try it out! What do you have to lose?
378 Sharing: if you like the program, give a copy to your friends,
379 teachers, students, and colleagues!
382 Source available: if you are curious about how LilyPond creates
383 some notation, you can see exactly how it is done.
386 Extendible: you can add features, fix bugs, and change the
387 functionality. If you are not a programmer, you can hire somebody
390 This may not seem appealing to casual musicians, but the ability
391 to extend software can be highly valuable to serious composers,
392 companies, and academics.
395 Future safety: if a commercial company goes bankrupt, what happens
396 to any electronic music which depends on their products? This is
397 not a concern with LilyPond; even if the entire development team
398 quits (extremely unlikely), the program will still be legally
399 available for copying, modifications, and distribution.
408 @c @divClass{column-right-top}
410 @divClass{keep-bullets}
411 @subheading Why do LilyPond developers @qq{give away} their work for free?
413 Most of us view LilyPond development as a hobby or volunteer work.
414 So this question is really asking @qq{why do people volunteer}?
419 Fun: working towards a goal can be enjoyable, especially when you
423 Shared goals: we all want beautiful sheet music, but few people
424 have the expertise (and nobody has the time!), to create a program
425 which can handle all situations. By working together -- one
426 person improves the automatic beaming code, another person
427 improves the shape of slurs, and a third person writes
428 documentation explaining how to use these features -- we can
429 achieve our goal with only a fraction of the individual effort.
432 @qq{Gift culture}: the Free Software (or @qq{Open Source})
433 movement has created many great software projects, such as
434 @uref{http://kernel.org/, GNU/Linux},
435 @uref{http://www.getfirefox.com/, Mozilla Firefox}, and
436 @uref{http://www.wesnoth.org/, Battle for Wesnoth}. Having
437 benefitted from these projects, some developers want to @qq{give
438 back} to the community.
441 Work experience: contributing to open-source projects is a great
442 way to practice programming, documentation writing, or design.
443 This experience has helped some developers gain job offers or
453 @divClass{column-center-bottom}
454 @subheading Where now?
456 Still not convinced? Read our extensive essay about our engraving
457 philosophy in @ref{Background}. If you've already decided to try
458 LilyPond, first read about our @ref{Text input}.
462 @c Frankly, a node just for redirecting the reader just after a reading
463 @c direction paragraph is a bit dense, I'd really like to merge this
464 @c node into the previous paragraph. -JM
466 @unnumberedsec Background
468 @divClass{column-center-top}
469 @subheading Background essay
471 We have an extensive essay describing computational aesthetics:
472 the art of creating beauty with a computer.
474 If you just want a quick introduction to LilyPond, the essay might
475 be too much material to read. If you would like to read it now,
476 please progress to @ref{Essay}.
479 @divClass{column-center-bottom}
480 @subheading Where now?
482 Still not convinced? Read about some of our users'
483 @ref{Productions} and sheet music. If you've already decided to
484 try LilyPond, first read about our @ref{Text input}.
489 @unnumberedsec Productions
491 @divClass{column-left-top}
494 Lilypond engravings have been used for performances around the world.
497 @divClass{keep-bullets}
501 @emph{Affaire Étrangère}, an opera by Valentin Villenave, with
502 libretto by Lewis Trondheim, premiered February 1, 2009, by
503 @uref{http://www.orchestre-montpellier.com/, L'Opéra Montpellier}.
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.
535 @uref{http://www.adoromusicpub.com/, Adoro Music Publishing},
536 high-quality scores of sacred music, available for immediate
537 download or in traditional paper format.
540 @uref{http://theshadylanepublishing.com/, The Shady Lane
542 a @qq{micro musical publishing house} whose goal is to promote a
543 new form of musical economy closer to the musicians and music
553 @divClass{column-center-bottom}
554 @subheading Where now?
556 Still not convinced? Read some of our users' @ref{Testimonials}.
557 If you've already decided to try LilyPond, first read about our
561 @c TRANSLATORS, so far it's mostly from
562 @c http://lilypond.org/web/switch/testimonials
565 @unnumberedsec Testimonials
567 @divClass{testimonial-item}
568 @imageFloat{carter-brey,jpg, right}
569 @subsubheading @uref{http://nyphil.org/meet/orchestra/index.cfm?page=profile&personNum=7, Carter Brey}, Principal Cellist, New York Philharmonic
571 @qq{@dots{} I've written a couple of encore pieces for solo cello
572 which I've printed with LilyPond and which I'm going to submit to
573 Schirmer for publication. I'll bet their engraved version wouldn't
574 look half as sharp as mine!}
578 @divClass{testimonial-item}
579 @imageFloat{orm-finnendahl,jpg, left}
580 @subsubheading @uref{http://icem-www.folkwang-hochschule.de/~finnendahl/, Orm Finnendahl}, professor of Composition, Musikhochschule Freiburg
582 @qq{Although I don't know [LilyPond] very well yet, I'm
583 @strong{*very} impressed. I used the program to input a motet of
584 Josquin Desprez in mensural notation and there's no doubt that
585 lilypond outscores all other notation programs easily concerning
586 speed, ease of use and look!}
590 @divClass{testimonial-item}
591 @imageFloat{darius-blasband,jpg, right}
592 @subsubheading Darius Blasband, composer (Brussels, Belgium)
594 @qq{[..after the first orchestra rehearsal] I got numerous
595 compliments about the quality of the scores. Even more
596 importantly, while Lilypond provides numerous hacks to improve the
597 way its scores look, what the orchestra got from me is basically
598 the raw, untouched output.}
602 @divClass{testimonial-item}
603 @subsubheading Kieren MacMillan, composer (Toronto, Canada)
605 @qq{thanks and kudos to the development team for their incredible
606 work. I've never seen anything approaching the output that I get
607 from Lilypond -- I'm totally confident that my music publishing
608 needs will be fulfilled beyond my expectations using this great
609 application. [..] basically untweaked Lilypond output [..] looks
610 better than most recent @q{professional} publications I've compared
611 it to (q.v., just about any Warner Bros. score, and even many of
612 the most recent by @q{the old houses}). [..]}
614 @qq{Beat that, Finale/Sibelius/Igor/whatever!!!}
618 @divClass{testimonial-item}
619 @subsubheading Chris Cannam, lead programmer of the @uref{http://www.rosegardenmusic.com/, RoseGarden} project
621 @qq{Lilypond is obviously the zillion-ton gorilla [of great music
626 @divClass{testimonial-item}
627 @subsubheading Chris Snyder, @uref{http://www.adoromusicpub.com/, Adoro Music Publishing}
629 @qq{The way that music is entered for LilyPond causes me to think in a
630 more musical way -- there have been times when I've been stumped as
631 to how to tell Lily to engrave something, only to realize that
632 even if I did get it exactly as the composer wanted, the music
633 would be confusing to read. LilyPond makes it much easier for me
634 to work in my dual editor+engraver role.}
636 @qq{I've been using LilyPond exclusively for my fledgling music
637 publishing business. Virtually without exception, every composer
638 has been blown away by the quality of the engraving when presented
639 with the proofs of their music about to be published. I deserve
640 some of the credit for this -- I spend a lot of time tweaking
641 output, especially ties (mainly in chords) -- but LilyPond gives
642 me an excellent starting point, a very intuitive interface, and
643 the ability to modify absolutely anything if I want to take the
644 time. I'm convinced that no commercial product can come close.}
648 @divClass{testimonial-item}
649 @subsubheading David Bobroff, Bass Trombone, Iceland Symphony Orchestra
651 @qq{I think Lilypond is great [..] The more I learn about LilyPond
656 @divClass{testimonial-item}
657 @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})
659 @qq{I am super impressed with LilyPond [..]}
661 @qq{THIS IS THE BEST PROGRAM EVER!!!}
663 @qq{Thank you all SO MUCH for your hard work and dedication!}
667 @divClass{testimonial-item}
668 @subsubheading @uref{http://nicolas.sceaux.free.fr/, Nicolas Sceaux}, @uref{http://www.mutopiaproject.org/, Mutopia} contributor
670 @qq{I had a kind of hate-passion relationship with it. Passion
671 because the first score I saw was so amazing! The description of
672 LilyPond lies about its beautifulness, it is too modest! [..] as
673 LilyPond is getting always better, and as I look closer how things
674 are done in scheme, I have less and less frustrations. Anyway,
675 what I mean is: thank you for providing LilyPond, it is really
680 @divClass{testimonial-item}
681 @subsubheading @uref{http://www.troff.org/whoswho.html#werner, Werner Lemberg}, Conductor at the Theatre in Koblenz, Germany and distinguished GNU Hacker
683 @qq{Anyway, LilyPond does an amazingly good job!}
687 @divClass{testimonial-item}
688 @subsubheading Paul Davis, developer of @uref{http://jackaudio.org/, JACK} and @uref{http://www.ardour.org/, Ardour}
690 @qq{I think [LilyPond is] an incredible program, and it produces
691 wonderful, wonderful output. when i read an interview about it
692 last year, i was raving to several friends of mine about its
697 @divClass{column-center-bottom}
698 @subheading Where now?
700 Read about our @ref{Text input}.
706 @unnumberedsec Text input
708 @c TRANSLATORS, so far it's mostly from
709 @c http://lilypond.org/web/switch/howto
711 @subheading @qq{Compiling} Music
713 @imageClickable{nereid-shot-small,png, (click to enlarge), nereid-shot,png, right}
715 LilyPond is a @emph{compiled} system: it is run on a text file
716 describing the music. The resulting output is viewed on-screen or
717 printed. In some ways, LilyPond is more similar to a programming
718 language than graphical score editing software.
720 You do not write music by dragging notes from a graphical toolbar
721 and placing them on a dynamically refreshing score; you write
722 music by typing text. This text is interpreted (or @qq{compiled})
723 by LilyPond, which produces beautifully engraved sheet music.
725 People accustomed to graphical user interfaces might need to learn
726 a new way of working, but the results are definitely worth it!
728 @warning{We present a quick overview of our text input -- it's not
729 as complicated as it sounds! Don't worry about understanding
730 every detail in these examples; our beginner documentation covers
731 everything at a much more gradual pace.}
734 @subsubheading It's as simple as A B C
736 Notes are encoded with letters and numbers. Special commands are
737 entered with backslashes.
739 @imageFloat{text-input-1-annotate,png,center}
740 @imageFloat{text-input-1-output,png,center}
742 Alterations are made with different names: add @code{-is} for
743 sharp, and @code{-es} for flat (these are Dutch note names, other
744 languages are available). LilyPond figures out where to put
747 @imageFloat{text-input-2-annotate,png,center}
748 @imageFloat{text-input-2-output,png,center}
751 @subsubheading Pop music
753 Put chords and lyrics together to get a lead sheet:
755 @imageFloat{text-input-pop-annotate,png,center}
756 @imageFloat{text-input-pop-output,png,center}
760 @subsubheading Orchestral parts
762 The input file contains the notes of piece of music. Score and
763 parts can be made from a single input file, so that changing a
764 note always affects the score and parts. To be able to include
765 the same music in multiple places, the music is assigned to a
766 @qq{variable} (a name).
768 @imageFloat{text-input-parts-both-annotate,png,center}
771 This variable is then used in a single part (here transposed, with
772 condensed rests spanning several measures):
774 @imageFloat{text-input-parts-single-annotate,png,center}
775 @imageFloat{text-input-parts-single-output,png,center}
778 The same variable is used in the full score (here in concert
781 @imageFloat{text-input-score-annotate,png,center}
782 @imageFloat{text-input-score-output,png,center}
785 @subsubheading Beginner Documentation
787 We realize that many users find this way of entering music a bit
788 odd. For this reason, we have written extensive documentation to
789 help new users, beginning with @ref{Learning}.
791 Please read the Learning Manual before complaining about bugs!
792 New users occasionally believe that LilyPond is not working
793 correctly, when in fact it is working precisely as designed.
796 @subsubheading Easier editing environments
798 @imageClickable{lilykde-screenshot-small,png,
799 (click to enlarge),lilykde-screenshot,png,right}
801 LilyPond is primarily concerned with producing top-quality
802 engraved sheet music; creating a Graphical User Interface (GUI)
803 would distract us from this goal. However, there are other
804 projects aimed at making it easier to create LilyPond input files.
806 Some editing environments include syntax highlighting, automatic
807 command completion, and pre-made templates. Other programs
808 actually provide a GUI which allows direct manipulation of a
809 graphical score. For more information, see @ref{Easier editing}.
812 @divClass{column-center-bottom}
813 @subheading Where now?
815 You are now ready to @ref{Download, Download LilyPond}. Still not
816 convinced? Read about @ref{Easier editing}.
822 @unnumberedsec Easier editing
824 @divClass{column-center-top}
825 @subheading Graphical environment: Denemo
827 @imageClickable{screenshot-denemo-small,png,
828 (click to enlarge),screenshot-denemo,png,right}
830 @sourceimage{logo-linux,,,}
831 @sourceimage{logo-windows,,,}
833 @uref{http://denemo.org}
835 Denemo is graphical editor which generates LilyPond source code
836 and also allows audio playback. It is currently in development
837 and generates code for older versions of LilyPond (V2.8.7). It
838 allows users to view the LilyPond source code in parallel to the
842 Import: LilyPond, MIDI
844 Export: Lilypond, MIDI, ABC, CSound Score File, PDF
849 @divClass{column-center-top}
850 @subheading Mixed environment: LilyPondTool
852 @imageClickable{lilypondtool-2.12-screenshot-400wide,png,
853 (click to enlarge),lilypondtool-2.12-screenshot,png,right}
855 @sourceimage{logo-linux,,,}
856 @sourceimage{logo-freebsd,,,}
857 @sourceimage{logo-macosx,,,}
858 @sourceimage{logo-windows,,,}
860 @uref{http://lilypondtool@/.organum@/.hu}
862 Created as a plugin for the
863 @uref{http://@/www@/.jedit@/.org@/,jEdit} text editor,
864 LilyPondTool is one of the most feature-rich text-based tool for
865 editing LilyPond scores. Its features include a Document Wizard
866 with lyrics support to set up documents easier, and embedded PDF
867 viewer with advanced point-and-click support.
871 @divClass{column-center-top}
872 @subheading Mixed environment: Frescobaldi
874 @imageClickable{frescobaldi-lilypond-editor-small,png,
875 (click to enlarge),frescobaldi-lilypond-editor,png,right}
877 @sourceimage{logo-linux,,,}
878 @sourceimage{logo-freebsd,,,}
880 @uref{http://www.frescobaldi.org}
882 Frescobaldi is a dedicated LilyPond music and text editor with
883 built-in PDF previewer, a powerful score wizard and many editing
884 features. It is built on top of the KDE4 libraries and runs
885 currently on all flavours of Linux and other UNIX-like operating
890 @divClass{column-center-top}
891 @subheading Text environment: Emacs and Vim
893 @sourceimage{logo-linux,,,}
894 @sourceimage{logo-freebsd,,,}
895 @sourceimage{logo-macosx,,,}
896 @sourceimage{logo-windows,,,}
898 @uref{http://www.gnu.org/software/emacs/}
900 Emacs is a text editor with language-sensitive capabilities for
901 many different computer languages. Emacs is a highly extensible
902 editor and can be used as an Integrated Development Environment.
903 There is a @q{lilypond mode} which supplies the language
904 definitions for working with Lilypond source files.
906 @uref{http://www.vim.org}
908 Vim is a minimal text editor and is an extension of the older Unix
909 @command{vi} editor. It is also extensible and configurable.
911 As a general rule, if you are not already familiar with Emacs or
912 Vim, then you would probably prefer to use a different editor for
913 writing LilyPond input files.
917 @divClass{column-center-top}
920 @help insert text and a graphic(s)
922 @subsubheading Mixed environment: LilyKDE
924 @imageClickable{lilykde-screenshot-small,png,
925 (click to enlarge),lilykde-screenshot,png,right}
927 @sourceimage{logo-linux,,,}
928 @sourceimage{logo-freebsd,,,}
930 @uref{http://lilykde.googlecode.com/}
932 LilyKDE is a plugin for KDE's text editor
933 @uref{http://kate-editor.org/,Kate}. It has a powerful Score
934 Wizard to quickly setup a LilyPond document and an embedded
937 LilyKDE can use @uref{http://www.volny.cz/smilauer/rumor/,Rumor},
938 so music can entered by playing on a MIDI keyboard.
940 Other features are lyric hyphenation and running LilyPond on
941 multiple files at once from within the KDE file manager.
943 @subsubheading Text environment: TexShop
945 @sourceimage{logo-macosx,,,}
947 @uref{http://@/www@/.uoregon@/.edu/~koch/texshop}
949 The TexShop editor for MacOS@tie{}X can be extended to run LilyPond,
950 @command{lilypond-book} and @command{convert-ly} from within the editor,
951 using the extensions available at
952 @uref{http://@/www@/.dimi@/.uniud@/.it/vitacolo/freesoftware@/.html#desktoppub}.
955 TODO: ask somebody to sponsor/check these. -gp
957 @subsubheading TextMate
959 @sourceimage{logo-macosx,,,}
961 There is a LilyPond bundle for TextMate. It may be installed by
965 mkdir -p /Library/Application\ Support/TextMate/Bundles
966 cd /Library/Application\ Support/TextMate/Bundles
967 svn co http://svn.textmate.org/trunk/Bundles/LilyPond.tmbundle/
973 @divClass{column-center-top}
974 @subheading Other programs can export LilyPond code
977 TODO: change url back to full adress, to make it readable in printouts -ch
980 @help clean up this list, check links, etc.
982 @subsubheading Graphical environments:
986 @uref{http://@/noteedit@/.berlios@/.de,NoteEdit}
987 which imports @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}
989 @uref{http://@/www@/.rosegardenmusic@/.com,Rosegarden},
992 @uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml,NtEd},
993 has experimental export for LilyPond.
995 @uref{http://www.tuxguitar.com.ar/,TuxGuitar}, can export to LilyPond.
997 @uref{http://musescore.org,MuseScore} can export to LilyPond.
999 @uref{http://canorus.org,Canorus} can also export to LilyPond, but is still
1000 beta-software. Testers welcome though.
1003 @subsubheading Command Line Tools:
1007 @uref{http://www@/.volny@/.cz/smilauer/rumor/rumor@/.html,Rumor}, a realtime
1008 monophonic MIDI to LilyPond converter.
1010 @uref{http://nicolas@/.sceaux@/.free@/.fr/lilypond/lyqi@/.html,lyqi}, an
1013 @uref{http://@/common-lisp@/.net/project/fomus/,FOMUS},
1014 a LISP library to generate music notation
1019 @divClass{column-center-bottom}
1020 @subheading Where now?
1022 You are now ready to @ref{Download, Download LilyPond}.
1024 Still not convinced? Many composers, musicians, and conductors
1025 have learned how to write music in our input format. Experienced
1026 users even report that they can enter a full score in LilyPond
1027 faster than with a piano keyboard or mouse+GUI! Perhaps you would
1028 like to review the @ref{Features}, @ref{Examples}, or the
1029 @ref{Freedom} that LilyPond provides, or read about users'
1030 @ref{Productions} and @ref{Testimonials}. In addition, our
1031 approach to the computational aesthetics of classical engraving is
1032 explained in our @ref{Background}.
1035 @subheading Legalese
1038 All logos and product images are copyright and trademark