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.
12 @divClass{heading-center}
13 @heading Downloads for LilyPond @versionStable
17 @warning{LilyPond is a @strong{text-based} music engraver; it is
18 more similar to a programming language than a graphical score
19 editing program. Before downloading LilyPond, please read about
20 our @ref{Text input}.}
22 @divClass{column-left-top}
28 @c TODO: duplicate to avoid underlined refs in HTML? icky.
29 @ref{Unix, @sourceimage{logo-linux,,,}
30 @sourceimage{logo-freebsd,,,}}
31 @ref{Unix, Unix (Linux and FreeBSD)}
34 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
35 @ref{MacOS X, MacOS X}
38 @ref{Windows, @sourceimage{logo-windows,,,}}
39 @ref{Windows, Microsoft Windows}
45 @divClass{column-right-top}
46 @subheading For developers
58 @item @ref{Development}:
59 latest unstable version
65 @divClass{column-center-bottom}
67 @subheading Software License
69 LilyPond is published under the
70 @ref{GPL, GNU General Public License}.
78 Many thanks to @uref{http://www.vt.edu/, Virgina Tech} and
79 @uref{http://www.linuxaudio.org/, linuxaudio.org} for sponsoring
82 @sourceimage{VTlogo_ITF,,,}
83 @sourceimage{lao_banner_06_on_white_demo,,,}
88 All logos and product images are copyright and trademark
118 @divClass{column-center-top}
119 @subheading Generic Packages or Distribution-Specific Packages?
121 Many distributions include LilyPond in their normal package
122 system. These versions are easier to install and uninstall than
123 the generic packages, but they may be older. If you wish to use
124 our generic packages, please uninstall the official version from
125 your system using the normal package manager for your distribution.
126 See your distribution's documentation about how to use their
132 @divClass{column-left-top}
133 @subheading Generic Packages
135 @subsubheading Download
140 @sourceimage{logo-linux,,,}
141 @downloadStableLinuxNormal
142 (if in doubt, use this)
145 @sourceimage{logo-linux,,,}
146 @downloadStableLinuxBig
149 @sourceimage{logo-linux,,,}
150 @downloadStableLinuxPPC
153 @sourceimage{logo-freebsd,,,}
154 @downloadStableFreeBSDNormal
157 @sourceimage{logo-freebsd,,,}
158 @downloadStableFreeBSDBig
163 @subsubheading Install
168 cd PATH-TO-DOWNLOAD-DIRECTORY
169 sh lilypond-@versionStable{}-OS-TYPE.sh
172 @subsubheading Uninstall
183 @divClass{column-right-top}
184 @subheading Distribution-specific Packages
186 Please use your distribution's package manager to install or
187 upgrade to these versions.
192 @sourceimage{logo-fedora,,,}
193 @uref{https://admin.fedoraproject.org/pkgdb/packages/name/lilypond,
194 Fedora: LilyPond 2.12.0}
197 @sourceimage{logo-ubuntu,,,}
198 @uref{https://launchpad.net/ubuntu/+source/lilypond,
199 Ubuntu: LilyPond 2.12.1}
202 @sourceimage{logo-slackware,,,}
203 @uref{http://www.johannes-schoepfer.de/lilypond/,
204 Slackware: LilyPond 2.12.1}
207 @sourceimage{logo-debian,,,}
208 @uref{http://packages.debian.org/search?keywords=lilypond,
209 Debian: LilyPond 2.10.33}
212 @sourceimage{logo-suse,,,}
213 @uref{http://opensuse.org/?fixme=urg-no-lilypond-package-page,
214 openSUSE: LilyPond 2.10.33}
221 @divClass{column-center-bottom}
225 All logos and product images are copyright and trademark
237 @unnumberedsec MacOS X
239 @divClass{column-left-top}
242 @subsubheading Download
247 @sourceimage{logo-macosx,,,}
248 @downloadStableDarwinNormal
249 For Intel chips (if in doubt, use this).
252 @sourceimage{logo-macosx,,,}
253 @downloadStableDarwinPPC
254 For G3 and G4 CPUs (old Apple computers).
258 @subsubheading Install
260 Double-click the downloaded file, then drag it to wherever you
263 @subsubheading Uninstall
265 Delete the LilyPond.app folder.
270 @divClass{column-right-top}
271 @subheading Running on the command-line
273 @warning{If you are happy with the GUI, then please ignore these
277 FIXME: I had one report that we don't need this stuff; will delete
278 after confirmation. -gp
280 @subsubheading Using Python scripts on MacOS 10.3 or 10.4
282 LilyPond binaries for MacOS X do not provide Python, but Python 2.4 or
283 newer is required by @command{convert-ly}. Therefore, if you use MacOS
284 10.3 or 10.4, you must install a newer Python version from
285 @uref{http://python.org/download/}, then edit the first line of
286 @command{convert-ly} and @command{lilypond-book} as follows: if the
287 Python binary you just installed is in your @var{PATH}, the first line
291 #!/usr/bin/env python
295 otherwise it should be
298 #!@var{/path/to/newly_installed/python}
302 @subsubheading MacOS X on the command line
304 The most convenient way to run lilypond scripts is by setting up
305 @qq{helper} scripts of your own.
310 Create a directory to store these scripts,
319 Create a file called @command{lilypond} which contains
321 @help obvious css issue to be dealt with. :(
322 @c we need a small font here to fit. -gp
324 exec @var{DIR}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
327 @warning{@var{DIR} will generally be @code{/Applications/}}
331 Create similar files @command{lilypond-book},
332 @command{convert-ly}, and any other scripts you wish to use, by
333 replacing the @command{bin/lilypond} with @command{bin/convert-ly}
334 (or other program name).
338 Make the file executable,
346 Now, add this directory to your path. Modify (or create) a file
347 called @code{.profile} in your home directory such that it
351 export PATH=$PATH:~/bin
354 This file should end with a blank line.
359 @subsubheading Invoking individual scripts
361 The scripts --- such as @command{lilypond-book}, @command{convert-ly},
362 @command{abc2ly}, and even @command{lilypond} itself --- are included
363 inside the @code{.app} file for MacOS@tie{}X.
365 Scripts can also be run from the command line by invoking them
369 @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond
372 The same is true for all other scripts in that directory, such as
373 @command{lilypond-book} and @command{convert-ly}.
378 @divClass{column-center-bottom}
382 All logos and product images are copyright and trademark
393 @unnumberedsec Windows
395 @divClass{column-left-top}
398 @subsubheading Download
403 @sourceimage{logo-windows,,,}
404 @downloadStableWindows
405 For Windows ME, NT, 2000, XP, and Vista.
409 @subsubheading Install
414 Locate the downloaded file and double-click on it to start the
415 installer. You will be presented a window titled @qq{Open File -
416 Security Warning}, click on Run to continue.
419 You will be presented the License Agreement; read this carefully,
420 and click on the Next button if you accept it.
423 Preferably leave the destination folder to the default, else
424 browse to choose a different location, and click on the Next
428 Next is the Installation Options window, leave the three options
429 checked, as you will want to have all of these installed. Click
433 Installation now commences, wait a minute or less for installation
434 to complete. There is a Show Details button that when clicked on
435 will show all the files installed and where, nothing you
436 necessarily need to look at. Click on the Finish button.
439 Lilypond is now installed.
443 @subsubheading Uninstall
445 There are two uninstallation routes -
450 Choose Uninstall from the Lilypond menu from the start menu
453 Open your Install/Uninstall Applications on the Control Panel,
454 scroll down to Lilypond and click on the Uninstall buttom.
461 @divClass{column-right-top}
462 @subheading Running on the command-line
464 @warning{If you are happy with the GUI, then please ignore these
472 @divClass{column-center-bottom}
476 All logos and product images are copyright and trademark
487 @unnumberedsec Source
489 @warning{We @strong{do not} recommend that you attempt to build
490 LilyPond yourself; almost all user needs are better met with the
493 @divClass{column-left-bottom}
494 @subheading Source tarball
496 @downloadStableSource{}
498 For an extensive listing of all versions (old and new), see our
499 @uref{http://download.linuxaudio.org/lilypond/binaries/, download
504 @divClass{column-right-bottom}
505 @subheading Compiling instructions
507 Instructions are listed in @rcontrib{Compiling LilyPond}.
513 @unnumberedsec Old downloads
515 @divClass{column-center-top}
516 @subheading All versions
518 For an extensive listing of all versions (old and new), see our
519 @uref{http://download.linuxaudio.org/lilypond/binaries/, download
528 @divClass{column-center-top}
529 @subheading Software license
531 GNU LilyPond is published under the GNU General Public License.
532 An introduction to this license, and our reasons for choosing it,
533 is given in @ref{Freedom}.
537 @divClass{column-center-bottom}
538 @subheading GNU General Public License