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.
9 @macro warningTextBased
10 @warning{LilyPond is a @strong{text-based} music engraver; it is
11 more similar to a programming language than a graphical score
12 editing program. Before downloading LilyPond, please read about
13 our @ref{Text input}.}
19 @divClass{heading-center}
20 @heading Downloads for LilyPond @versionStable
26 @divClass{column-left-top}
32 @c TODO: duplicate to avoid underlined refs in HTML? icky.
33 @ref{Unix, @sourceimage{logo-linux,,,}
34 @sourceimage{logo-freebsd,,,}}
35 @ref{Unix, Unix (Linux and FreeBSD)}
38 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
39 @ref{MacOS X, MacOS X}
42 @ref{Windows, @sourceimage{logo-windows,,,}}
43 @ref{Windows, Microsoft Windows}
49 @divClass{column-right-top}
50 @subheading For developers
62 @item @ref{Development}:
63 latest unstable version
69 @divClass{column-center-bottom}
71 @subheading Software License
73 LilyPond is published under the
74 @ref{GPL, GNU General Public License}.
82 Many thanks to @uref{http://www.vt.edu/, Virgina Tech} and
83 @uref{http://www.linuxaudio.org/, linuxaudio.org} for sponsoring
86 @sourceimage{VTlogo_ITF,,,}
87 @sourceimage{lao_banner_06_on_white_demo,,,}
92 All logos and product images are copyright and trademark
122 @divClass{heading-center}
126 @divClass{column-center-top}
127 @subheading Generic Packages or Distribution-Specific Packages?
129 Many distributions include LilyPond in their normal package
130 system. These versions are easier to install and uninstall than
131 the generic packages, but they may be older. If you wish to use
132 our generic packages, please uninstall the official version from
133 your system using the normal package manager for your distribution.
134 See your distribution's documentation about how to use their
140 @divClass{column-left-top}
141 @subheading Generic Packages
143 @subsubheading Download
148 @sourceimage{logo-linux,,,}
149 @downloadStableLinuxNormal
150 (if in doubt, use this)
153 @sourceimage{logo-linux,,,}
154 @downloadStableLinuxBig
157 @sourceimage{logo-linux,,,}
158 @downloadStableLinuxPPC
161 @sourceimage{logo-freebsd,,,}
162 @downloadStableFreeBSDNormal
165 @sourceimage{logo-freebsd,,,}
166 @downloadStableFreeBSDBig
171 @subsubheading Install
176 cd PATH-TO-DOWNLOAD-DIRECTORY
177 sh lilypond-@versionStable{}-OS-TYPE.sh
180 @subsubheading Uninstall
191 @divClass{column-right-top}
192 @subheading Distribution-specific Packages
194 Please use your distribution's package manager to install or
195 upgrade to these versions.
200 @sourceimage{logo-fedora,,,}
201 @uref{http://koji.fedoraproject.org/koji/packageinfo?packageID=2447,
202 Fedora: LilyPond 2.12.2}
205 @sourceimage{logo-ubuntu,,,}
206 @uref{http://packages.ubuntu.com/search?keywords=lilypond,
207 Ubuntu: LilyPond 2.12.2}
210 @sourceimage{logo-slackware,,,}
211 @uref{http://www.johannes-schoepfer.de/lilypond/,
212 Slackware: LilyPond 2.12.2}
215 @sourceimage{logo-debian,,,}
216 @uref{http://packages.debian.org/search?keywords=lilypond,
217 Debian: LilyPond 2.12.2}
220 @sourceimage{logo-suse,,,}
221 @uref{http://download.opensuse.org/repositories/openSUSE:/Factory:/Contrib/standard/,
222 openSUSE: LilyPond 2.12.2}
229 @divClass{column-center-bottom}
233 All logos and product images are copyright and trademark
245 @unnumberedsec MacOS X
247 @divClass{heading-center}
251 @divClass{column-left-top}
254 @subsubheading Download
259 @sourceimage{logo-macosx,,,}
260 @downloadStableDarwinNormal
261 For Intel chips (if in doubt, use this).
264 @sourceimage{logo-macosx,,,}
265 @downloadStableDarwinPPC
266 For G3 and G4 CPUs (old Apple computers).
270 @subsubheading Install
272 Double-click the downloaded file, then drag it to wherever you
275 @subsubheading Uninstall
277 Delete the LilyPond.app folder.
282 @divClass{column-right-top}
283 @subheading Running on the command-line
285 @warning{If you are happy with the GUI, then please ignore these
289 FIXME: I had one report that we don't need this stuff; will delete
290 after confirmation. -gp
292 @subsubheading Using Python scripts on MacOS 10.3 or 10.4
294 LilyPond binaries for MacOS X do not provide Python, but Python 2.4 or
295 newer is required by @command{convert-ly}. Therefore, if you use MacOS
296 10.3 or 10.4, you must install a newer Python version from
297 @uref{http://python.org/download/}, then edit the first line of
298 @command{convert-ly} and @command{lilypond-book} as follows: if the
299 Python binary you just installed is in your @var{PATH}, the first line
303 #!/usr/bin/env python
307 otherwise it should be
310 #!@var{/path/to/newly_installed/python}
314 @subsubheading MacOS X on the command line
316 The most convenient way to run lilypond scripts is by setting up
317 @qq{helper} scripts of your own.
322 Create a directory to store these scripts,
331 Create a file called @command{lilypond} which contains
333 @help obvious css issue to be dealt with. :(
334 @c we need a small font here to fit. -gp
336 exec @var{DIR}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
339 @warning{@var{DIR} will generally be @code{/Applications/}}
343 Create similar files @command{lilypond-book},
344 @command{convert-ly}, and any other scripts you wish to use, by
345 replacing the @command{bin/lilypond} with @command{bin/convert-ly}
346 (or other program name).
350 Make the file executable,
358 Now, add this directory to your path. Modify (or create) a file
359 called @code{.profile} in your home directory such that it
363 export PATH=$PATH:~/bin
366 This file should end with a blank line.
371 @subsubheading Invoking individual scripts
373 The scripts --- such as @command{lilypond-book}, @command{convert-ly},
374 @command{abc2ly}, and even @command{lilypond} itself --- are included
375 inside the @code{.app} file for MacOS@tie{}X.
377 Scripts can also be run from the command line by invoking them
381 @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond
384 The same is true for all other scripts in that directory, such as
385 @command{lilypond-book} and @command{convert-ly}.
390 @divClass{column-center-bottom}
394 All logos and product images are copyright and trademark
405 @unnumberedsec Windows
407 @divClass{heading-center}
411 @divClass{column-left-top}
414 @subsubheading Download
419 @sourceimage{logo-windows,,,}
420 @downloadStableWindows
421 For Windows ME, NT, 2000, XP, Vista, and Windows 7.
425 @subsubheading Install
430 Locate the downloaded file and double-click on it to start the
431 installer. Follow the instructions given to you by the installer;
432 we recommend that you leave all the install options checked and
433 use the default installation location. Click the @q{Finish} button
434 when the installer has completed. Lilypond is now installed.
438 @subsubheading Uninstall
440 To uninstall Lilypond either:
445 Locate the Lilypond folder from the @q{Start} menu and click on the
446 @q{Uninstall} icon. Click the @q{Finish} button when the uninstaller
450 Or from witin the Control Panel,locate and select Lilypond and then
451 choose the option to uninstall/remove the software. Click the @q{Finish}
452 button when the uninstaller has completed.
459 @divClass{column-right-top}
460 @subheading Running on the command-line
462 @warning{If you are happy with the GUI, then please ignore these
470 @divClass{column-center-bottom}
474 All logos and product images are copyright and trademark
485 @unnumberedsec Source
487 @divClass{heading-center}
491 @warning{We @strong{do not} recommend that you attempt to build
492 LilyPond yourself; almost all user needs are better met with the
495 @divClass{column-left-bottom}
496 @subheading Source tarball
498 @downloadStableSource{}
500 For an extensive listing of all versions (old and new), see our
501 @uref{http://download.linuxaudio.org/lilypond/binaries/, download
506 @divClass{column-right-bottom}
507 @subheading Compiling instructions
509 Instructions are listed in @rcontrib{Compiling LilyPond}.
515 @unnumberedsec Old downloads
517 @divClass{heading-center}
521 @divClass{column-center-top}
522 @subheading All versions
524 For an extensive listing of all versions (old and new), see our
525 @uref{http://download.linuxaudio.org/lilypond/binaries/, download
534 @divClass{column-center-top}
535 @subheading Software license
537 GNU LilyPond is published under the GNU General Public License.
538 An introduction to this license, and our reasons for choosing it,
539 is given in @ref{Freedom}.
543 @divClass{column-center-bottom}
544 @subheading GNU General Public License