1 \input texinfo @c -*-texinfo-*-
2 @setfilename installing.info
3 @settitle LilyPond on Windows
6 <!--- @@WEB-TITLE@@=Windows Installation --->
12 @chapter WINDOWS - Installing GNU LilyPond on Windows
14 This document explains how to install the binary release for windows on
15 a Microsoft Windows 95, 98, NT or 2000 machine. Please follow the
16 instructions carefully. If it doesn't work for you, please send a
17 bugreport, following the guidelines in the section on bugreports below.
20 @section Windows binary setup
22 If you run Windows NT, 2000 or XP, please become administrator first
23 (currently, installing as an ordinary user will not work). All the
24 software you need is installed by downloading and running
25 @uref{http://www.lilypond.org/gnu-windows/setup.exe, setup.exe}. You
26 will be asked some questions. If you are unsure just click "Next". Do
27 not change the default install directory @file{c:/cygwin}.
29 This installs LilyPond, and Cygwin, GUILE, Python, teTeX and GSView. If
30 you already have some of that software under @file{c:/cygwin}, then
31 don't worry: nothing will be installed twice.
33 If you want to install any of this software by hand, do this
34 @strong{before} you run @file{setup.exe}, otherwise your LilyPond setup
37 @section Testing LilyPond
39 Open a LilyPond shell (To open a a lilypond shell, click the "GNU
40 LilyPond" icon), and type
48 You should see something similar to
52 Usage: lilypond [OPTION]... [FILE]...
54 Typeset music and or play MIDI from FILE
56 LilyPond is a music typesetter. It produces beautiful sheet music
57 using a high level description file as input. LilyPond is part of
66 Then, prepare a file called @file{foo.ly}, by issuing
70 Enter the following into the file
73 \score @{ \notes @{ c4 ( ) c4 @} @}
76 Close the file and save it. Run the following command a few times (at
77 least three times) until it says @code{PS output to `foo.ps', DVI output
84 You can now view the file using the following command
91 If this works, then you can head to the
92 @uref{../../user/out-www/lilypond/Tutorial.html,Tutorial} to start using
97 @section Removing LilyPond
99 Start @file{setup.exe}, click Next, select "Install from Local
100 Directory". Then click next until you reach "Select packages to
101 install". Click "View". Now, for every package, click on the recycle
102 icon until it says "Uninstall". Then, click Next.
104 (If you find this too tedious, you can also simply remove
105 @file{c:/cygwin}. This also removes the @file{/home/} directories under
106 cygwin (i.e. @file{C:\CYGWIN\HOME}, so make sure that you bring
107 important files in safety first.)
109 @section Troubleshooting
111 For problems and solutions see
112 @uref{http://lilypond.org/wiki?TroubleshootingWindows,Troubleshooting
118 We can only help you with a problem if you give a full, detailed
119 bugreport. A bugreport includes
122 @item A @emph{precise} description of the problem.
123 @item A full description of your platform (machine type, operating
125 @item All version numbers of relevant software you run. Specifically, we
126 want to see the output of the following commands:
133 @item If ly2dvi fails, then please run it as follows and include the
136 ly2dvi --verbose MY-FILE
140 You can also check out
141 @uref{http://lilypond.org/wiki/?TroubleshootingWindows} for more
142 instructions on how to make a bug report.
144 @subsection Additional software
146 LilyPond needs a number of software packages to be really useful. These
147 are included in the binary setup program (see above).
149 If you choose to install this additional software yourself, make sure
150 you install LilyPond last, otherwise the LilyPond setup will be broken.
151 Also note that this means that you will probably need to fix some PATH
152 and TEX environment variables yourself. If you think you can handle
153 that, you may do so, but don't complain if it doesn't work.
155 These software packages are included in the LilyPond installation:
158 @item A full TeX installation.
160 As of LilyPond versions 1.4.11 (and 1.5.29), only Cygwin's teTeX
161 installation is supported (packages tetex-beta and texmf-base). It is
162 part of Cygwin and much more robust for use with LilyPond than MiKTeX.
163 See @file{/usr/doc/Cygwin/tetex-beta-20001218.README} and
164 @file{/usr/doc/Cygwin/texmf-20000804-2.README} for details.
169 You can use GSView-2.6. This old package has two advantages. It has
170 gsview and ghostscript bundeled, and it doesn't popup @emph{Register
171 Now|Cancel} windows all the time. It doesn't work together with Yap to
172 display PostScript specials.
174 Click @uref{ftp://ftp.cs.wisc.edu/ghost/ghostgum/gsv26w32.exe,here} to
175 install GSView-2.6 (GhostView for Windows), or visit
176 @uref{ftp://ftp.cs.wisc.edu/ghost/ghostgum,ftp.cs.wisc.edu}.
178 You can also use the newer versions GSView-3.6 and GhostScript-6.50 If
179 you install both these packages, Yap will display PostScript specials.
180 You get annoying @emph{Register Now|Cancel} popups, though.
182 Click @uref{ftp://ftp.cs.wisc.edu/ghost/ghostgum/gsv36w32.exe,here} for
184 Click @uref{ftp://mirror.cs.wisc.edu/pub/mirrors/ghost/AFPL/gs650/gs650w32.exe
185 ,here} for GhostScript.
186 @uref{ftp://ftp.cs.wisc.edu/ghost/ghostgum,ftp.cs.wisc.edu}.
188 @uref{http://www.cs.wisc.edu/~ghost/,Ghostscript, Ghostview and GSview site}.
194 * emacs-mode installation, figure out and describe proper
195 emacs-on-cygwin setup.
203 ERROR: Wrong type to apply: ("/usr/share/guile/site" /usr/share/guile/1.4.1")
209 Let's take this step by step.
211 It should not be critical which MikTeX version you use.
212 Let's first verify that your MikTeX works as it should.
213 Open a DOS window. Run the commands
215 Should produce some lines of output
217 Should display a three page document.
219 Next step; verify that the geometry package is in place.
220 Save the attached file to the directory where you run
221 your DOS window. Run the commands
222 >> latex geometrytest
224 This one you should get a single page document with some text
233 If you want to install more of cygwnTo expand on this minimal set,
234 @section If you already have MikTeX, GSView or
236 If you already have cygwin installed, don't worry: nothing will be
237 installed twice. To expand on this minimal set, click
238 @uref{http://sources.redhat.com/cygwin/setup.exe,here}, or visit a
239 Cygwin @uref{http://sources.redhat.com/cygwin/mirrors.html,mirror site}.
242 This will install the minimal set of cygwin tools needed to run
243 LilyPond. Make sure to install in the default place, @file{c:/cygwin},
244 and install everything.