3 WINDOWS - compiling and installing GNU LilyPond on Windows
4 **********************************************************
6 This document is a supplement to INSTALL.txt, you may want to read
12 You can get the latest version of LilyPond at
13 ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/
14 (ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/).
16 Windows build requirements
17 ==========================
19 You need the following packages to compile Lilypond on Windows.
21 `The GNU + Cygnus tools, 1.1.7 or newer.'
22 Check out the Cygwin webpage (http://sources.redhat.com/cygwin).
23 You can get the latest version of the GNU + Cygnus tools from
24 cygnus mirror site (http://sources.redhat.com/cygwin/mirrors.html).
25 Install everything, including tetex.
27 `GUILE 1.4, or newer.'
28 Check out the GUILE webpage
29 (http://www.gnu.org/software/guile.html). You may need the patch
30 `guile-1.4-gnu-windows.patch' included in LilyPond's source
33 Windows precompiled binaries
34 ============================
38 (http://appel.lilypond.org/lilypond/gnu-windows/setup.exe) to
39 install LilyPond, or visit LilyPond on Windows
40 (http://appel.lilypond.org/lilypond/gnu-windows).
42 This will install the minimal set of cygwin tools needed to run
43 LilyPond. If you already have cygwin installed, don't worry:
44 nothing will be installed twice. To expand on this minimal set,
45 click here (http://sources.redhat.com/cygwin/setup.exe), or visit
47 (http://sources.redhat.com/cygwin/mirrors.html).
49 Note that none of the developers uses Windows, of course. In fact,
50 we recommend you to use GNU/Linux for running LilyPond. We provide
51 these binaries anyway, because it saves us the trouble of helping
52 Windows users trying to compile LilyPond themselves.
54 These binaries are cross compiled for Windows on a GNU/Linux box.
55 You may want to check out the cross compilation scripts
56 (http://appel.lilypond.org/lilypond/gnu-windows/cross-1.1.8.tar.gz).
58 Windows running requirements
59 ============================
61 GNU LilyPond does use a lot of resources. For operation you need the
65 Included in binary installation.
68 A full TeX installation. Click here
69 (http://prdownloads.sourceforge.net/miktex/miktex-2.0-lvl-1.zip)
70 to install basic MiKTeX commands, or visit www.miktex.org
71 (http://www.miktex.org).
76 This old package has two advantages. It has gsview and
77 ghostscript bundeled, and it doesn't popup _Register
78 Now|Cancel_ windows all the time. It doesn't work together
79 with Yap to display PostScript specials.
82 (ftp://ftp.cs.wisc.edu/ghost/ghostgum/gsv26w32.exe) to
83 install GSView-2.6 (GhostView for Windows), or visit
84 ftp.cs.wisc.edu (ftp://ftp.cs.wisc.edu/ghost/ghostgum).
86 `GSView-3.6 and GhostScript-6.50'
87 If you install both these packages, Yap will display
88 PostScript specials. You get annoying _Register Now|Cancel_
92 (ftp://ftp.cs.wisc.edu/ghost/ghostgum/gsv36w32.exe) for
94 (ftp://mirror.cs.wisc.edu/pub/mirrors/ghost/AFPL/gs650/gs650w32.exe)
95 for GhostScript. ftp.cs.wisc.edu
96 (ftp://ftp.cs.wisc.edu/ghost/ghostgum). or visit the
97 Ghostview and GSview site.
100 Click here (http://www.python.org/ftp/python/win32/py152.exe) to
101 install Python-1.5.2, or visit www.python.org
102 (http://www.python.org).
104 Python > 1.5.2 has ugly licensing issues, so we only used and
107 Windows running setup
108 =====================
110 If you're lucky, after running `setup.exe' you're all set up.
112 Open a LilyPond shell (or any bash shell), and type
115 If you don't see something similar to
116 Usage: lilypond [OPTION]... [FILE]...
118 Typeset music and or play MIDI from FILE
120 LilyPond is a music typesetter. It produces beautiful sheet music
121 using a high level description file as input. LilyPond is part of
128 you should try adding `/usr/lilypond-x.y.z/bin' to your PATH, do:
129 PATH=/usr/lilypond-1.3.147/bin:$PATH
135 * politely ask windows users not to complain but rather send
136 instructive bug reports along with patches.
138 * emacs-mode installation, figure out and describe proper
139 emacs-on-cygwin setup.
141 * talk about /etc/profile.d/lilypond-profile.sh
143 * GUILE errors, simple guile test
145 * (La)TEX errors, simple tex test