![]() |
GNU LilyPondWindows Installation |
||||||||||||||||||||||||||
|
WINDOWS - Installing GNU LilyPond on WindowsThis document explains how to install the binary release for windows on a Microsoft Windows 95, 98, ME, NT, 2000 or XP machine. Please follow the instructions carefully. If it doesn't work for you, please send a bugreport, following the guidelines in the section on bugreports below. QuickInstallClick Install Lily now, run the
installer ( If you have any problems, please read the rest of this page. Windows binary setupThe binary LilyPond setup for Windows is in fact a Cygwin installation, including the LilyPond package for Cygwin. If you run Windows NT, 2000 or XP, please become administrator first;
installing as an ordinary user does not seem to work on certain
Windows-NT variants. Download and run
setup.exe. You will be asked some
questions. If you are unsure just click "Next". Do not change the
default install directory In the Package View dialogue window, click on the Publishing section to view the available publishing software for Cygwin. Make sure that LilyPond is selected. If this is a new or first installation, click on Skip to select. This installs LilyPond, and Cygwin, GUILE, Python, teTeX (MikTeX is not
supported). If you already have some of that software under
Additional softwareIf you install the Cygwin's XFree86 X11 window system, tetex-x11 and
ghostscript-x11 packages too, you can view the LilyPond needs a PostScript/PDF viewer to be really useful. At this time (Sun Aug 11 2002), such software is not available in Cygwin, so you must use native Windows software instead.
Note: ftp.cs.wisc.edu has moved the ghostscript/ghostview distribution to a rather unreliable server. Testing LilyPondOpen a LilyPond shell (To open a a lilypond shell, click the "GNU LilyPond" or "Cygwin" icon), and type lilypond --help You should see something similar to GNU LilyPond 1.6.0 Usage: lilypond [OPTION]... FILE... Typeset music and or play MIDI from FILE LilyPond is a music typesetter. It produces beautiful sheet music using a high level description file as input. LilyPond is part of the GNU Project. Options: -h,--help this help [..] Then, prepare a file called notepad foo.ly Enter the following into the file \score { \notes { c4 ( ) c4 } } Close the editor and save the file. Then run the following command. ly2dvi -p foo At the end, it should say DVI output to `foo.dvi'... PS output to `foo.ps'... PDF output to `foo.pdf'... If you install the Cygwin's XFree86 X11 window system, tetex-x11 and
ghostscript-x11 packages too, you can view the startx xdvi test.dvi If you have installed a PostScript/PDF viewer,
such as gsview32 foo.ps If this works, then you can head to the Tutorial (local copy) to start using LilyPond. Removing LilyPondStart (If you find this too tedious, you can also simply remove
TroubleshootingFor problems and solutions see Troubleshooting Windows If you have a problem running LilyPond, you should first make sure that you are running the latest version. Chances are, that your problem was already reported and fixed in a newer release. Click Update Lily now to check if new software is available. If you subscribe to the cygwin-announce (archives) mailing list, see Cygwin mailing lists, bottom of page. You'll be notified of new and updated software for Cygwin, including LilyPond. Chances are, that a problem you experience has been noted by others. Cygwin specific problems will be reported to the cygwin-user (archives) mailing list (Cygwin mailing lists, bottom of page). LilyPond specific problems, also concering Cygwin/Windows, are reported and discussed on the lilypond-user (archives) mailing list. Setup.exe does not run at allMake sure that you run this latest setup.exe. This will also work if you were using a setup.exe you donwloaded before from lilypond.org before. If you're sure that you have the very latest version, and it doesn't work, and the cygwin-user archives do not mention the problem, write to cygwin@cygwin.com. Setup is under heavy development, so you may have been unlucky and have dowloaded a buggy version. ly2dvi:error: filename should not contain spacesI don't seem to be able to either change this "default" or to point Lilypond to another directory which does not have the space.Best is to create a new home directory. Start the Cygwin or LilyPond shell, and do:ly2dvi:error: filename should not contain spaces: `/usr/bin/Ralph Whedon/foo' HOME=/home/ralph mkdir -p $HOME cd To go there automatically, each time you log in, edit the file /etc/passwd # windows name: c:\cygwin\etc\passwd using vim or wordpad, and change the `/usr/bin/Ralph Whedon/' to `/home/ralph'. What's this Bash/Cygwin shell?The bash shell is a basic UNIX-like console that we use for the Windows release. Using such an intercompatible shell makes it easier to maintain the Windows release reasonably, notably because it works the same as the normal UNIX setup. Keep in mind that none of the developers are using Windows. Also it is possible to build LilyPond from source with a complete Cygwin install, see Compiling LilyPond on Windows. Bash is not very different from the MS-DOS shell, you'll just have to (re-)learn a few commands needed to browse through your hard-drive. Here are some commands you'll definitely be needing. To change folders, the usual cd ../.. # If you type this at startup, you should be in the root # directory. Better do: cd / You'll notice that file names in Bash are written with the slash (/), and not the backslash (\) bar as in MS-DOS and Windows. C:\Win98\Bureau\ ---> /cygdrive/c/Win98/Bureau The equivalent of the MS-DOS dir command is ls -l : ls -l #You'll get the listing of the current folder. To copy a file, use the cp command: cp srcfile destfile For more information, see the DOS/Windows to Linux HOWTO. Requirements and DLLsTeTeX and LilyPond depend on a number of library packages, but as it seems, they sometimes do not get selected automagically.
Also, the more general info on missing DLLs may be helpful: http://cygwin.com/faq/faq_4.html#SEC32 http://cygwin.com/ml/cygwin/2002-01/msg01619.html Why don't you fix this?Well, we've tried several times, but we can't reproduce the problem ('It works for me'). If you're experiencing DLL problems, you're much invited to help us find the bug and fix it. You can install the binutils package, and use objdump to find which executable depends on the missing dll. objdump -x <path to download dir>/setup.exe | grep -i dll objdump -x /usr/bin/awk.exe | grep -i dll objdump -x /usr/bin/python.exe | grep -i dll Of course, you should check what version of the offending package you
have installed (see Check your TeX installationStart a LilyPond shell and run latex sample2e This should print a few lines of information and produce a file
dvips sample2e which produces a sample2e.ps, which you can view using When this works correctly, you could resume your attempts with LilyPond. BugreportsSo you have checked by running Update Lily now that you run the latest version, and Troubleshooting Windows nor cygwin-user (archives) or lilypond-user (archives) mentions your problem. It looks like you found a bug. We can only help you with a problem if you give a full, detailed bugreport. A bugreport includes
If you have trouble using bug-lilypond-cygwin, you must gather this information by hand. Specifically, we want to see the output of the following commands:
The file Be sure to turn off HTML email. It is very annoying. For reasons unknown to man, most Windows email clients have that turned on by default. If you are using Microsoft Outlook (Express), you can send normal plain text messages by clicking through the menus Tools/Options/Send/Mail Sending Format/Plain Text, with options: Set Message format as MIME, set "Encode text using:" to None. Set Automatically wrap text at 70, and > is used to indent original text. Easy instructions for various email clients can be found at helpdesk.rootsweb.com. |
||||||||||||||||||||||||||
Go back to index of LilyPond.
Please send GNU LilyPond questions and comments to lilypond-user@gnu.org. Please send comments on these web pages to (address unknown) Copyright (c) 1997--2002 Han-Wen Nienhuys and Jan Nieuwenhuizen. Verbatim copying and distribution of this entire article is permitted in any medium, provided this notice is preserved. |
This page was built from LilyPond-1.7.14 (development-branch) by