GNU LilyPond

Infobox Software
latest_release_version = 2.10.33
latest_release_date = Release date and age|2007|09|20
latest_preview_version = 2.11.62 (2.12 Beta)
latest_preview_date = Release date and age|2008|10|11
operating_system = Cross-platform
genre = Music engraving
license = GNU General Public License
website = http://lilypond.org/

GNU LilyPond is a computer program for music engraving. One of LilyPond's major goals is to produce scores that are engraved with traditional layout rules, reflecting the era when scores were engraved by hand.

Unlike some commercial, proprietary music engraving software, such as Finale and Sibelius, LilyPond does not contain its own graphical user interface for the creation of scores. It does, however, have the same aim of producing output comparable to professionally-engraved scores. Some graphical music notation programs, such as Rosegarden, NoteEdit and Canorus, can export files directly to LilyPond format. LilyPond can also automatically generate MIDI files from music specified in the LilyPond format. The Mutopia project, which distributes free content sheet music, uses LilyPond to typeset its music, as does Musipedia, a collaborative music encyclopedia. , a MediaWiki interface, supports editing LilyPond notation directly in wiki articles.

LilyPond is cross-platform, and is available for several common operating systems; released under the terms of the GNU General Public License, LilyPond is free software.

Design

LilyPond is written in C++ and assembled by a Scheme library (GNU Guile) which allows for user customization and extension. ["LilyPond is linked to GUILE, GNU's Scheme library for extension programming. The Scheme library provides the glue that holds together the low-level routines and separate modules which are written in C++." [http://www.lilypond.org/doc/v1.6/Documentation/user/out-www/lilypond/Advanced-Topics.html] ] It uses a simple text notation for music, which is then compiled into PDF (via PostScript) or other formats.

Example of LilyPond input file

Text after a percent sign (%) is a comment.

In LilyPond, notes are entered in note, pitch and length format; pitch is represented with series of single quotes or commas, each representing an octave up or down from the base. For example, a'4 is an A, one octave up from the base, of quarter note length. As a curious syntactical rule, "all" other modifiers - even ones containing parentheses, which by usual writing rules should go "before" the note - are added "after" the note, so d8 [ c] is an eighth-note pair with a beam as signified by the brackets.

LilyPond has two modes of entering the note pitches: Absolute and relative. In absolute mode, note pitches are always given, for each note, relative to the base; in relative mode, when the melody stays within limits, notes with unspecified pitch are assumed to be "near" the last note, and pitch markers are used only when the interval from the preceding note is more than a fourth. This example uses the relative mode.

The only character encoding that LilyPond understands is UTF-8. This allows for the combination of Danish, Hebrew, Korean, etc. in the same file. The first line in the file tells emacs that this file should always be read and written as UTF-8. If one uses other editors than emacs, it is necessary to make sure that they use UTF-8 too; otherwise anything but ASCII will break.

#!lilypond firebreathers.ly -*- coding: utf-8; -*-% Theme to "Fire Breathers", a homebrew NES game perpetually % under development. Composed by Urpo Lankinen.

% Note: The composer has made this source code available % under the GFDL license. Some previous versions of this% code may also be available under CC BY-SA license.

% This file uses Finnish note names (for example, where % Americans use "F#" and "Bb", Finns use "Fis" and "B"). % Dutch note names are used by default.include "suomi.ly"

% Optional language upgrade helper.version "2.6.0"

% The header block defines the titles and texts.header { title = "Theme to ``Fire Breathers!" instrument = "For the 2A03 or SID" composer = "Urpo Lankinen" enteredby = "Urpo Lankinen" updatedby = "Jan Nieuwenhuizen" date = "June 2005"}

Melody = elative c" { clef treble ime 3/4 key a minor

% The piece starts with a quarter-note partial bar, "partial 4" % tells so to LilyPond. partial 4 a4 | e'4.( d8 [ c] ) r8 | d4.( c8 [ h] ) r8 | a2. | e2 a4 | e'4.( d8 [ c] ) r8 | d4.( e8 [ f] ) r8 | e2. | r2 e4 | f4.( e8 [ d] ) r8 | d4.( c8 [ h] ) r8 | a2. | e2 a4 | e'4.( d8 [ c] ) r8 | d4.( c8 [ h] ) r8 | a2. ~ a2 r4 | ar "|."}

% This is the second voice.SecondVoice = elative c { clef bass ime 3/4 key a minor

partial 4 r4 | e2. | d2. | a2. | e2 a4 | e'2. | d2 f4 | e2. | r2.
f2. | d2. | a2. | e2 a4 | e'2. | d2 h4 | a2. ~ a2 r4 | ar "|."}

% Melodies, lyrics and chords can be assigned to a variable and then% be *reused* elsewhere. Here are three different accompaniment% patterns, which are used throughout the accompaniment melody.AccompA = elative c { a4 e'8 a, e' a, | }AccompB = elative c { g4 d'8 g, d' g, | }AccompC = elative c { e,4 h'8 e, h' e, | }

Accompaniment = { clef bass ime 3/4 key a minor

partial 4 r4 | AccompA AccompB AccompA AccompA AccompA AccompB AccompA AccompA AccompC AccompC AccompA AccompA AccompA AccompB AccompA | a2 r4 | ar "|."}

% The top level music definition.<< ew Staff Melody ew Staff Accompaniment ew Staff SecondVoice>>

Corresponding output

See also

* Denemo
* NoteEdit
* Rosegarden
* Karaoke
* GUIDO music notation

References

External links

* [http://lilypond.org/ Official LilyPond website]
* [http://www.lilypond.org/web/images/xivcim.pdf "Lilypond, a system for automated music engraving"] -(by Han-Wen Nienhuys, Jan Nieuwenhuizen; PDF)
* [http://www.nabble.com/Gnu---Lilypond-f1718.html LilyPond forum]
* [http://lilypondwiki.tuxfamily.org/ The LilyPond Wiki]