Documentation/general/download.itexi

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @ignore
   3     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
   4
   5     When revising a translation, copy the HEAD committish of the
   6     version that you are working on.  See TRANSLATION for details.
   7 @end ignore
   8
   9 @node Download
  10 @unnumbered Download
  11
  12 @divClass{heading-center}
  13 @heading Downloads for LilyPond @versionStable
  14
  15 @divEnd
  16
  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}.}
  21
  22 @divClass{column-left-top}
  23 @subheading For users
  24
  25 @itemize
  26
  27 @item
  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)}
  32
  33 @item
  34 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
  35 @ref{MacOS X, MacOS X}
  36
  37 @item
  38 @ref{Windows, @sourceimage{logo-windows,,,}}
  39 @ref{Windows, Microsoft Windows}
  40
  41 @end itemize
  42
  43 @divEnd
  44
  45 @divClass{column-right-top}
  46 @subheading For developers
  47
  48 @itemize
  49
  50 @item
  51 @ref{Source}:
  52 for packagers
  53
  54 @item
  55 @ref{Old downloads}:
  56 old versions
  57
  58 @item @ref{Development}:
  59 latest unstable version
  60
  61 @end itemize
  62 @divEnd
  63
  64
  65 @divClass{column-center-bottom}
  66
  67 @subheading Software License
  68
  69 LilyPond is published under the
  70 @ref{GPL, GNU General Public License}.
  71 @divEnd
  72
  73
  74 @divClass{color1}
  75
  76 @subheading Sponsors
  77
  78 Many thanks to @uref{http://www.vt.edu/, Virgina Tech} and
  79 @uref{http://www.linuxaudio.org/, linuxaudio.org} for sponsoring
  80 our bandwidth.
  81
  82 @sourceimage{VTlogo_ITF,,,}
  83 @sourceimage{lao_banner_06_on_white_demo,,,}
  84
  85 @subheading Legalese
  86
  87 @divClass{legal}
  88 All logos and product images are copyright and trademark
  89 acknowledged.
  90
  91 @logoLegalLinux
  92
  93 @logoLegalFreeBSD
  94
  95 @logoLegalMacOSX
  96
  97 @logoLegalWindows
  98
  99 @divEnd
 100 @divEnd
 101
 102
 103 @divClass{hide}
 104 @menu
 105 * Unix::
 106 * MacOS X::
 107 * Windows::
 108 * Source::
 109 * Old downloads::
 110 * GPL::
 111 @end menu
 112 @divEnd
 113
 114
 115 @node Unix
 116 @unnumberedsec Unix
 117
 118 @divClass{column-center-top}
 119 @subheading Generic Packages or Distribution-Specific Packages?
 120
 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
 127 package manager.
 128
 129 @divEnd
 130
 131
 132 @divClass{column-left-top}
 133 @subheading Generic Packages
 134
 135 @subsubheading Download
 136
 137 @itemize
 138
 139 @item
 140 @sourceimage{logo-linux,,,}
 141 @uref{http://download.linuxaudio.org/lilypond/binaries/linux-x86/lilypond-@versionStable{}-1.linux-x86.sh,
 142 Linux x86: LilyPond @versionStable{}} (if in doubt, use this)
 143
 144 @item
 145 @sourceimage{logo-linux,,,}
 146 @uref{http://download.linuxaudio.org/lilypond/binaries/linux-64/lilypond-@versionStable{}-1.linux-64.sh,
 147 Linux 64-bit: LilyPond @versionStable{}}
 148
 149 @item
 150 @sourceimage{logo-linux,,,}
 151 @uref{http://download.linuxaudio.org/lilypond/binaries/linux-ppc/lilypond-@versionStable{}-1.linux-ppc.sh,
 152 Linux PPC: LilyPond @versionStable{}}
 153
 154 @item
 155 @sourceimage{logo-freebsd,,,}
 156 @uref{http://download.linuxaudio.org/lilypond/binaries/freebsd-x86/lilypond-@versionStable{}-1.freebsd-x86.sh,
 157 FreeBSD i386: LilyPond @versionStable{}}
 158
 159 @item
 160 @sourceimage{logo-freebsd,,,}
 161 @uref{http://download.linuxaudio.org/lilypond/binaries/freebsd-64/lilypond-@versionStable{}-1.freebsd-64.sh,
 162 FreeBSD amd64: LilyPond @versionStable{}}
 163
 164 @end itemize
 165
 166
 167 @subsubheading Install
 168
 169 In the shell, type:
 170
 171 @example
 172 cd PATH-TO-DOWNLOAD-DIRECTORY
 173 sh lilypond-@versionStable{}-OS-TYPE.sh
 174 @end example
 175
 176 @subsubheading Uninstall
 177
 178 In the shell, type:
 179
 180 @example
 181 uninstall-lilypond
 182 @end example
 183
 184 @divEnd
 185
 186
 187 @divClass{column-right-top}
 188 @subheading Distribution-specific Packages
 189
 190 Please use your distribution's package manager to install or
 191 upgrade to these versions.
 192
 193 @itemize
 194
 195 @item
 196 @sourceimage{logo-fedora,,,}
 197 @uref{https://admin.fedoraproject.org/pkgdb/packages/name/lilypond,
 198 Fedora: LilyPond 2.12.0}
 199
 200 @item
 201 @sourceimage{logo-ubuntu,,,}
 202 @uref{https://launchpad.net/ubuntu/+source/lilypond,
 203 Ubuntu: LilyPond 2.12.1}
 204
 205 @item
 206 @sourceimage{logo-slackware,,,}
 207 @uref{http://www.johannes-schoepfer.de/lilypond/,
 208 Slackware: LilyPond 2.12.1}
 209
 210 @item
 211 @sourceimage{logo-debian,,,}
 212 @uref{http://packages.debian.org/search?keywords=lilypond,
 213 Debian: LilyPond 2.10.33}
 214
 215 @item
 216 @sourceimage{logo-suse,,,}
 217 @uref{http://opensuse.org/?fixme=urg-no-lilypond-package-page,
 218 openSUSE: LilyPond 2.10.33}
 219
 220 @end itemize
 221
 222 @divEnd
 223
 224
 225 @divClass{column-center-bottom}
 226 @subheading Legalese
 227
 228 @divClass{legal}
 229 All logos and product images are copyright and trademark
 230 acknowledged.
 231
 232 @logoLegalLinux
 233
 234 @logoLegalFreeBSD
 235
 236 @divEnd
 237 @divEnd
 238
 239
 240 @node MacOS X
 241 @unnumberedsec MacOS X
 242
 243 @divClass{column-left-top}
 244 @subheading Packages
 245
 246 @subsubheading Download
 247
 248 @itemize
 249
 250 @item
 251 @sourceimage{logo-macosx,,,}
 252 @uref{
 253 http://download.linuxaudio.org/lilypond/binaries/darwin-x86/lilypond-@versionStable{}-1.darwin-x86.tar.bz2,
 254 lilypond-@versionStable{}.darwin-x86.tar.bz2}
 255 For Intel chips (if in doubt, use this).
 256
 257 @item
 258 @sourceimage{logo-macosx,,,}
 259 @uref{
 260 http://download.linuxaudio.org/lilypond/binaries/darwin-x86/lilypond-@versionStable{}-1.darwin-ppc.tar.bz2,
 261 lilypond-@versionStable{}.darwin-ppc.tar.bz2}
 262 For G3 and G4 CPUs (old Apple computers).
 263
 264 @end itemize
 265
 266 @subsubheading Install
 267
 268 Double-click the downloaded file, then drag it to wherever you
 269 want.
 270
 271 @subsubheading Uninstall
 272
 273 Delete the LilyPond.app folder.
 274
 275 @divEnd
 276
 277
 278 @divClass{column-right-top}
 279 @subheading Running on the command-line
 280
 281 @warning{If you are happy with the GUI, then please ignore these
 282 instructions.}
 283
 284 FIXME: once 2.12.4 is out, delete a bunch of this -- IIRC we now
 285 *do* provide Python, so this stuff gets much easier.
 286
 287 @subsubheading Using Python scripts on MacOS 10.3 or 10.4
 288
 289 LilyPond binaries for MacOS X do not provide Python, but Python 2.4 or
 290 newer is required by @command{convert-ly}.  Therefore, if you use MacOS
 291 10.3 or 10.4, you must install a newer Python version from
 292 @uref{http://python.org/download/}, then edit the first line of
 293 @command{convert-ly} and @command{lilypond-book} as follows: if the
 294 Python binary you just installed is in your @var{PATH}, the first line
 295 should be
 296
 297 @example
 298 #!/usr/bin/env python
 299 @end example
 300
 301 @noindent
 302 otherwise it should be
 303
 304 @example
 305 #!@var{/path/to/newly_installed/python}
 306 @end example
 307
 308
 309 @subsubheading MacOS X on the command line
 310
 311 The scripts --- such as @command{lilypond-book}, @command{convert-ly},
 312 @command{abc2ly}, and even @command{lilypond} itself --- are included
 313 inside the @code{.app} file for MacOS@tie{}X.  They can be run from
 314 the command line by invoking them directly, e.g.
 315
 316 @example
 317 @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond
 318 @end example
 319
 320 @noindent
 321 The same is true of the other scripts in that directory, including
 322 @command{lilypond-book}, @command{convert-ly}, @command{abc2ly}, etc.
 323
 324 Alternatively, you may create scripts which add the path
 325 automatically.  Create a directory to store these scripts,
 326
 327 @example
 328 mkdir -p ~/bin
 329 cd ~/bin
 330 @end example
 331
 332 Create a file called @code{lilypond} which contains
 333
 334 @example
 335 exec @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
 336 @end example
 337
 338 Create similar files @code{lilypond-book}, @code{convert-ly}, and
 339 any other helper programs you use (@code{abc2ly}, @code{midi2ly},
 340 etc).  Simply replace the @code{bin/lilypond} with
 341 @code{bin/convert-ly} (or other program name) in the above file.
 342
 343 Make the file executable,
 344
 345 @example
 346 chmod u+x lilypond
 347 @end example
 348
 349 Now, add this directory to your path.  Modify (or create)
 350 a file called @code{.profile} in your home directory such that it contains
 351
 352 @example
 353 export PATH=$PATH:~/bin
 354 @end example
 355
 356 @noindent
 357 This file should end with a blank line.
 358
 359 Note that @var{path/to} will generally be @code{/Usages/}.
 360
 361
 362
 363 @divEnd
 364
 365
 366 @divClass{column-center-bottom}
 367 @subheading Legalese
 368
 369 @divClass{legal}
 370 All logos and product images are copyright and trademark
 371 acknowledged.
 372
 373 @logoLegalMacOSX
 374
 375 @divEnd
 376 @divEnd
 377
 378
 379
 380 @node Windows
 381 @unnumberedsec Windows
 382
 383 @divClass{column-left-top}
 384 @subheading Packages
 385
 386 @subsubheading Download
 387
 388 @itemize
 389
 390 @item
 391 @sourceimage{logo-windows,,,}
 392 @uref{
 393 http://download.linuxaudio.org/lilypond/binaries/mingw/lilypond-@versionStable{}-1.mingw.exe,
 394 lilypond-@versionStable{}.mingw-exe}
 395 For Windows ME, NT, 2000, XP, and Vista.
 396
 397 @end itemize
 398
 399 @subsubheading Install
 400
 401 @enumerate
 402
 403 @item
 404 Locate the downloaded file and double-click on it to start the
 405 installer. You will be presented a window titled @qq{Open File -
 406 Security Warning}, click on Run to continue.
 407
 408 @item
 409 You will be presented the License Agreement; read this carefully,
 410 and click on the Next button if you accept it.
 411
 412 @item
 413 Preferably leave the destination folder to the default, else
 414 browse to choose a different location, and click on the Next
 415 button.
 416
 417 @item
 418 Next is the Installation Options window, leave the three options
 419 checked, as you will want to have all of these installed. Click
 420 on the Next button.
 421
 422 @item
 423 Installation now commences, wait a minute or less for installation
 424 to complete. There is a Show Details button that when clicked on
 425 will show all the files installed and where, nothing you
 426 necessarily need to look at. Click on the Finish button.
 427
 428 @item
 429 Lilypond is now installed.
 430
 431 @end enumerate
 432
 433 @subsubheading Uninstall
 434
 435 There are two uninstallation routes -
 436
 437 @enumerate
 438
 439 @item
 440 Choose Uninstall from the Lilypond menu from the start menu
 441
 442 @item
 443 Open your Install/Uninstall Applications on the Control Panel,
 444 scroll down to Lilypond and click on the Uninstall buttom.
 445
 446 @end enumerate
 447
 448 @divEnd
 449
 450
 451 @divClass{column-right-top}
 452 @subheading Running on the command-line
 453
 454 @warning{If you are happy with the GUI, then please ignore these
 455 instructions.}
 456
 457 @help{don't know}
 458
 459 @divEnd
 460
 461
 462 @divClass{column-center-bottom}
 463 @subheading Legalese
 464
 465 @divClass{legal}
 466 All logos and product images are copyright and trademark
 467 acknowledged.
 468
 469 @logoLegalWindows
 470
 471 @divEnd
 472 @divEnd
 473
 474
 475
 476 @node Source
 477 @unnumberedsec Source
 478
 479 @warning{We @strong{do not} recommend that you attempt to build
 480 LilyPond yourself; almost all user needs are better met with the
 481 pre-built version.}
 482
 483 @divClass{column-left-bottom}
 484 @subheading Source tarball
 485
 486 FIXME link @uref{http://download.linuxaudio.org/lilypond/sources/v2.12/lilypond-@versionStable{}.tar.gz,
 487 lilypond-@versionStable{}-source.tar.bz2}
 488
 489 For an extensive listing of all versions (old and new), see our
 490 @uref{http://download.linuxaudio.org/lilypond/binaries/, download
 491 site}.
 492
 493 @divEnd
 494
 495 @divClass{column-right-bottom}
 496 @subheading Compiling instructions
 497
 498 Instructions are listed in @rcontrib{Compiling LilyPond}.
 499
 500 @divEnd
 501
 502
 503 @node Old downloads
 504 @unnumberedsec Old downloads
 505
 506 @divClass{column-center-top}
 507 @subheading All versions
 508
 509 For an extensive listing of all versions (old and new), see our
 510 @uref{http://download.linuxaudio.org/lilypond/binaries/, download
 511 site}.
 512
 513 @divEnd
 514
 515
 516 @node GPL
 517 @unnumberedsec GPL
 518
 519 @divClass{column-center-top}
 520 @subheading Software license
 521
 522 GNU LilyPond is published under the GNU General Public License.
 523 An introduction to this license, and our reasons for choosing it,
 524 is given in @ref{Freedom}.
 525
 526 @divEnd
 527
 528 @divClass{column-center-bottom}
 529 @subheading GNU General Public License version 2
 530
 531 @include gpl-2.0.itexi
 532
 533 @divEnd
 534
 535
 536