Note: LilyPond is a text-based music engraver; it is more similar to a programming language than a graphical score editing program. Before downloading LilyPond, please read about our Text input.
- Windows: LilyPond 2.16.2-1 For Windows 2000, XP, Vista, Windows 7 and 8.
- Locate the downloaded file and double-click on it to start the installer. Follow the instructions given to you by the installer; we recommend that you leave all the install options checked and use the default installation location. Click the ‘Finish’ button when the installer has completed. LilyPond is now installed.
To uninstall LilyPond either:
- Locate the LilyPond folder from the ‘Start’ menu and click on the ‘Uninstall’ icon. Click the ‘Finish’ button when the uninstaller has completed.
- Or from within the Control Panel, locate and select LilyPond and then choose the option to uninstall/remove the software. Click the ‘Finish’ button when the uninstaller has completed.
Compiling a file
Note: These instructions assume that you are using the built-in LilyPad editor. If you are using any of the programs described in Easier editing, please consult the documentation for those programs if you have any problems compiling a file.
Step 1. Create your ‘.ly’ file
Double-click the LilyPond icon on your desktop, an example file will open.
From the menus that appear along the top of the example file,
File > Save as. Do not use the
File > Save
for the example file as this will not work until you have given it a
valid LilyPond file name.
Choose a name for your file, for example ‘test.ly’.
Step 2a. Compile (with drag-and-drop)
Depending on what you prefer, to compile your file either:
Drag-and-drop the file directly onto the LilyPond icon.
Right-click on the file and from the pop-up context menu choose
Open with > LilyPond.
Step 2b. Compile (with double-clicking)
Or simply double-click the ‘test.ly’.
Step 3. View output
During the compilation of the ‘test.ly’ file, a command window will, very briefly open and then close. Three additional files will have been created during this process.
The PDF file contains the engraved ‘test.ly’ file.
To create a new file, begin by selecting
File > New from
within any previously created file.
File > Open to open and edit any files you have saved
You must save any new edits you make before you compile it and if the PDF file is not created, check the log file that will have been created during the compilation attempt, for any errors.
This log file is overwritten each time you compile your LilyPond file.
The PS file is used internally by LilyPond to create the PDF file and can be ignored. It also gets overwritten each time you compile your file.
If you are viewing your file in a PDF viewer, then you must close the PDF if you wish to make a new compilation as it may fail to create the new PDF while it is still being viewed.
Running on the command-line
Note: If you are happy with the GUI, then please ignore these instructions.
Windows on the command line
The most convenient way to run LilyPond is by adding the folder which contains LilyPond executable files to the environmental variable “Path”.
- Open your “System” on the Control Panel, select Advanced tab and click Environmental Variables button.
Select the Variable “Path” from Environmental variables list
and click the Edit button.
You will be presented a window titled “Edit System Variable”;
append to “Variable value” the name of the folder
which contains LilyPond executable files like this:
Note: DIR will generally be
and click “OK” button to close the window.
Invoking individual executable files
LilyPond executable files – such as lilypond, lilypond-book, convert-ly, and so on – can be run from the command-line by invoking them: