<!-- header_tag --> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd"> <html> <!-- Copyright C 1999-2009 by the authors Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections. A copy of the license is included in the section entitled "GNU Free Documentation License". --> <!-- Created on December 15, 2009 by texi2html 1.82 texi2html was written by: Lionel Cons <Lionel.Cons@cern.ch> (original author) Karl Berry <karl@freefriends.org> Olaf Bachmann <obachman@mathematik.uni-kl.de> and many others. Maintained by: Many creative people. Send bugs and suggestions to <texi2html-bug@nongnu.org> --> <head> <title>GNU LilyPond program usage: 1.2.2 Requirements</title> <meta name="description" content="GNU LilyPond program usage: 1.2.2 Requirements"> <meta name="keywords" content="GNU LilyPond program usage: 1.2.2 Requirements"> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="texi2html 1.82"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <link href="index.es.html#Top" rel="start" title="GNU LilyPond — Application Usage"> <link href="LilyPond-index.es.html#LilyPond-index" rel="index" title="B. LilyPond index"> <link href="index_toc.es.html#SEC_Contents" rel="contents" title="Table of Contents"> <link href="index_abt.es.html#SEC_About" rel="help" title="About This Document"> <link href="Compiling-from-source.es.html#Compiling-from-source" rel="up" title="1.2 Compiling from source"> <link href="LilyPond-index.es.html#LilyPond-index" rel="next" title="B. LilyPond index"> <link href="Downloading-source-code.es.html#Downloading-source-code" rel="previous" title="1.2.1 Downloading source code"> <link rel="stylesheet" type="text/css" title="Patrick McCarty's design" href="lilypond-mccarty.css"> <link rel="alternate stylesheet" type="text/css" href="lilypond.css" title="Andrew Hawryluk's design"> <link rel="alternate stylesheet" type="text/css" href="lilypond-blue.css" title="Kurt Kroon's blue design"> <!--[if lte IE 7]> <link href="lilypond-ie-fixes.css" rel="stylesheet" type="text/css"> <![endif]--> </head> <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000"> <div id="main"> <a name="Requirements"></a> <table class="nav_table"> <tr><td valign="middle" align="left" colspan="1">[<a href="Install.es.html#Install" title="Beginning of this chapter or previous chapter"> << Install </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.es.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.es.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="LilyPond-index.es.html#LilyPond-index" title="Index" rel="index">Index</a>][<a href="index_abt.es.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Setup.es.html#Setup" title="Next chapter"> Setup >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="Downloading-source-code.es.html#Downloading-source-code" title="Previous section in reading order" accesskey="p" rel="previous"> < Downloading source code </a>]</td><td valign="middle" align="center" colspan="1">[<a href="Compiling-from-source.es.html#Compiling-from-source" title="Up section" accesskey="u" rel="up"> Up : Compiling from source </a>]</td><td valign="middle" align="right" colspan="2">[<a href="#Requirements" title="Next section in reading order" accesskey="n" rel="next"> > </a>]</td></tr></table> <a name="Requirements"></a> <h3 class="subsection">1.2.2 Requirements</h3> <hr size="6"> <a name="Requirements"></a> <table class="nav_table"> <tr><td valign="middle" align="left" colspan="1">[<a href="Install.es.html#Install" title="Beginning of this chapter or previous chapter"> << Install </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.es.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.es.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="LilyPond-index.es.html#LilyPond-index" title="Index" rel="index">Index</a>][<a href="index_abt.es.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Setup.es.html#Setup" title="Next chapter"> Setup >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="#Requirements" title="Previous section in reading order" accesskey="p" rel="previous"> < Requirements </a>]</td><td valign="middle" align="center" colspan="1">[<a href="#Requirements" title="Up section" accesskey="u" rel="up"> Up : Requirements </a>]</td><td valign="middle" align="right" colspan="2">[<a href="#Requirements" title="Next section in reading order" accesskey="n" rel="next"> > </a>]</td></tr></table> <h4 class="unnumberedsubsubsec">Compilation</h4> <p>In addition to the packages needed for running LilyPond (see below), you need the following extra packages for building. </p> <p>When installing a binary package FOO, you may need to install the FOO-devel, libFOO-dev or FOO-dev package too. </p> <ul> <li> <a href="http://fontforge.sf.net/">FontForge</a> 20060125 or newer. </li><li> <a href="http://metafont.tutorial.free.fr/">MetaFont</a> (mf-nowin, mf, mfw or mfont binaries) and <a href="http://cm.bell-labs.com/who/hobby/MetaPost.html">MetaPost</a> (mpost binary), usually packaged with a LaTeX distribution like tetex or texlive. </li><li> <a href="http://www.lcdf.org/~eddietwo/type/#t1utils">t1utils</a> (version 1.33 or newer recommended). </li><li> New Century Schoolbook fonts, as PFB files. These are shipped with X11 and Ghostscript, and are named ‘<tt>c059033l.pfb</tt>’ ‘<tt>c059036l.pfb</tt>’, ‘<tt>c059013l.pfb</tt>’ and ‘<tt>c059016l.pfb</tt>’. </li><li> <a href="http://www.gnu.org/software/guile/guile.html">GUILE</a> (version 1.8.2 or newer). If you are installing binary packages, you may need to install guile-devel or guile-dev or libguile-dev too. </li><li> <a href="ftp://ftp.gnu.org/gnu/texinfo/">Texinfo</a> (version 4.11 or newer). </li><li> <a href="http://gcc.gnu.org/">The GNU c++ compiler</a> (version 3.4 or newer. 4.x is strongly recommended). </li><li> <a href="http://www.python.org">Python</a> (version 2.4 or newer) </li><li> <a href="ftp://ftp.gnu.org/gnu/make/">GNU Make</a> (version 3.78 or newer). </li><li> <a href="http://www.gnu.org/software/gettext/gettext.html">gettext</a> (version 0.17 or newer). </li><li> <a href="http://www.gnu.org/software/flex/">Flex</a>. </li><li> <a href="http://www.perl.org/">Perl</a>. </li><li> <a href="http://www.gnu.org/software/bison/">GNU Bison</a>. </li><li> All packages required for running, including development packages with header files and libraries. </li></ul> <hr size="6"> <a name="Requirements"></a> <table class="nav_table"> <tr><td valign="middle" align="left" colspan="1">[<a href="Install.es.html#Install" title="Beginning of this chapter or previous chapter"> << Install </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.es.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.es.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="LilyPond-index.es.html#LilyPond-index" title="Index" rel="index">Index</a>][<a href="index_abt.es.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Setup.es.html#Setup" title="Next chapter"> Setup >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="#Requirements" title="Previous section in reading order" accesskey="p" rel="previous"> < </a>]</td><td valign="middle" align="center" colspan="1">[<a href="#Requirements" title="Up section" accesskey="u" rel="up"> Up : Requirements </a>]</td><td valign="middle" align="right" colspan="2">[<a href="#Requirements" title="Next section in reading order" accesskey="n" rel="next"> > </a>]</td></tr></table> <h4 class="unnumberedsubsubsec">Running requirements</h4> <p>Running LilyPond requires proper installation of the following software </p> <ul> <li> <a href="http://www.freetype.org/">Freetype</a> (version 2.1.10 or newer). </li><li> <a href="http://fontconfig.org/">FontConfig</a> (version 2.2 or newer). </li><li> <a href="http://www.pango.org/">Pango</a> (version 1.12 or newer). </li><li> <a href="http://www.gnu.org/software/guile/guile.html">GUILE</a> (version 1.8.2 or newer), or patch 1.8.1 with <a href="http://lilypond.org/vc/gub.darcs/patches/guile-1.8-rational.patch">http://lilypond.org/vc/gub.darcs/patches/guile-1.8-rational.patch</a>. </li><li> <a href="http://www.python.org">Python</a> (version 2.4 or newer). </li><li> <a href="http://www.ghostscript.com">Ghostscript</a> (version 8.15 or newer. 8.60 recommended) </li><li> Dejaview. (This is normally installed by default) </li></ul> <p>International fonts are required to create music with international text or lyrics. </p> <hr size="6"> <a name="Requirements"></a> <table class="nav_table"> <tr><td valign="middle" align="left" colspan="1">[<a href="Install.es.html#Install" title="Beginning of this chapter or previous chapter"> << Install </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.es.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.es.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="LilyPond-index.es.html#LilyPond-index" title="Index" rel="index">Index</a>][<a href="index_abt.es.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Setup.es.html#Setup" title="Next chapter"> Setup >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="#Requirements" title="Previous section in reading order" accesskey="p" rel="previous"> < </a>]</td><td valign="middle" align="center" colspan="1">[<a href="#Requirements" title="Up section" accesskey="u" rel="up"> Up : Requirements </a>]</td><td valign="middle" align="right" colspan="2">[<a href="Building-LilyPond.es.html#Building-LilyPond" title="Next section in reading order" accesskey="n" rel="next"> Building LilyPond > </a>]</td></tr></table> <h4 class="unnumberedsubsubsec">Requirements for building documentation</h4> <p>You can view the documentation online at <a href="http://lilypond.org/doc/">http://lilypond.org/doc/</a>, but you can also build it locally. This process requires a successful compile of LilyPond, and some additional tools and packages: </p> <ul> <li> The <a href="http://netpbm.sourceforge.net/">netpbm utilities</a> </li><li> ImageMagick </li><li> International fonts (see input/regression/utf-8.ly for hints about which font packages are necessary for your platform) </li><li> Ghostscript 8.60 or newer, or 8.50 with the patch from <a href="http://bugs.ghostscript.com/show_bug.cgi?id=688154">http://bugs.ghostscript.com/show_bug.cgi?id=688154</a> and the patch from <a href="http://bugs.ghostscript.com/show_bug.cgi?id=688017">http://bugs.ghostscript.com/show_bug.cgi?id=688017</a>. </li><li> <a href="http://www.nongnu.org/texi2html/">Texi2HTML</a> 1.80 or newer </li><li> rsync </li></ul> <hr size="6"> <table class="nav_table"> <tr><td valign="middle" align="left" colspan="1">[<a href="Install.es.html#Install" title="Beginning of this chapter or previous chapter"> << Install </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.es.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.es.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="LilyPond-index.es.html#LilyPond-index" title="Index" rel="index">Index</a>][<a href="index_abt.es.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Setup.es.html#Setup" title="Next chapter"> Setup >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="#Requirements" title="Previous section in reading order" accesskey="p" rel="previous"> < </a>]</td><td valign="middle" align="center" colspan="1">[<a href="#Requirements" title="Up section" accesskey="u" rel="up"> Up : Requirements </a>]</td><td valign="middle" align="right" colspan="2">[<a href="Building-LilyPond.es.html#Building-LilyPond" title="Next section in reading order" accesskey="n" rel="next"> Building LilyPond > </a>]</td></tr></table> <!-- footer_tag --> <div class="footer"> <p class="footer_version"> This page is for LilyPond-2.12.3 (stable-branch). </p> <p class="footer_report"> Your <a href="http://lilypond.org/web/devel/participating/documentation-adding">suggestions for the documentation</a> are welcome, please report errors to our <a href="http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs">bug list</a>. </p> </div> <!-- FOOTER --> <!-- end div#main here --> </div> <div id="tocframe"> <p class="toc_uplink"><a href="../index.es.html" title="Documentation Index"><< Back to Documentation Index</a></p> <h4 class="toc_header"> <a href="index.es.html#Top" title="Start of the manual">Application Usage</a></h4> <div class="contents"> <ul class="toc"> <li class="toc_current"><a name="toc-Install-1" href="Install.es.html#Install">1. Install</a> <ul class="toc"> <li><a name="toc-Precompiled-binaries-1" href="Precompiled-binaries.es.html#Precompiled-binaries">1.1 Precompiled binaries</a> </li> <li class="toc_current"><a name="toc-Compiling-from-source-1" href="Compiling-from-source.es.html#Compiling-from-source">1.2 Compiling from source</a> <ul class="toc"> <li><a name="toc-Downloading-source-code-1" href="Downloading-source-code.es.html#Downloading-source-code">1.2.1 Downloading source code</a> </li> <li class="toc_current"><a name="toc-Requirements-1" href="Requirements.es.html#Requirements">1.2.2 Requirements</a> <ul class="toc"> <li class="toc_current"><a name="toc-Compilation" href="Requirements.es.html#Requirements">Compilation</a> </li> <li class="toc_current"><a name="toc-Running-requirements" href="Requirements.es.html#Requirements">Running requirements</a> </li> <li class="toc_current"><a name="toc-Requirements-for-building-documentation" href="Requirements.es.html#Requirements">Requirements for building documentation</a> </li> </ul> </li> <li><a name="toc-Building-LilyPond-1" href="Building-LilyPond.es.html#Building-LilyPond">1.2.3 Building LilyPond</a> </li> <li><a name="toc-Building-documentation-1" href="Building-documentation.es.html#Building-documentation">1.2.4 Building documentation</a> </li> <li><a name="toc-Testing-LilyPond-1" href="Testing-LilyPond.es.html#Testing-LilyPond">1.2.5 Testing LilyPond</a> </li> <li><a name="toc-Problems-1" href="Problems.es.html#Problems">1.2.6 Problems</a> </li> </ul> </li> </ul> </li> <li><a name="toc-Setup-1" href="Setup.es.html#Setup">2. Setup</a> <ul class="toc"> <li><a name="toc-Setup-for-specific-Operating-Systems-1" href="Setup-for-specific-Operating-Systems.es.html#Setup-for-specific-Operating-Systems">2.1 Setup for specific Operating Systems</a> </li> <li><a name="toc-Text-editor-support-1" href="Text-editor-support.es.html#Text-editor-support">2.2 Text editor support</a> </li> <li><a name="toc-Point-and-click-1" href="Point-and-click.es.html#Point-and-click">2.3 Point and click</a> </li> </ul> </li> <li><a name="toc-Running-LilyPond-1" href="Running-LilyPond.es.html#Running-LilyPond">3. Running LilyPond</a> <ul class="toc"> <li><a name="toc-Normal-usage-1" href="Normal-usage.es.html#Normal-usage">3.1 Normal usage</a> </li> <li><a name="toc-Command_002dline-usage-1" href="Command_002dline-usage.es.html#Command_002dline-usage">3.2 Command-line usage</a> </li> <li><a name="toc-Error-messages-1" href="Error-messages.es.html#Error-messages">3.3 Error messages</a> </li> <li><a name="toc-Updating-files-with-convert_002dly-1" href="Updating-files-with-convert_002dly.es.html#Updating-files-with-convert_002dly">3.4 Updating files with <code>convert-ly</code></a> </li> <li><a name="toc-Reporting-bugs-1" href="Reporting-bugs.es.html#Reporting-bugs">3.5 Reporting bugs</a> </li> </ul> </li> <li><a name="toc-lilypond_002dbook_003a-Integrating-text-and-music" href="LilyPond_002dbook.es.html#LilyPond_002dbook">4. <code>lilypond-book</code>: Integrating text and music</a> <ul class="toc"> <li><a name="toc-An-example-of-a-musicological-document-1" href="An-example-of-a-musicological-document.es.html#An-example-of-a-musicological-document">4.1 An example of a musicological document</a> </li> <li><a name="toc-Integrating-music-and-text-1" href="Integrating-music-and-text.es.html#Integrating-music-and-text">4.2 Integrating music and text</a> </li> <li><a name="toc-Music-fragment-options-1" href="Music-fragment-options.es.html#Music-fragment-options">4.3 Music fragment options</a> </li> <li><a name="toc-Invoking-lilypond_002dbook-1" href="Invoking-lilypond_002dbook.es.html#Invoking-lilypond_002dbook">4.4 Invoking <code>lilypond-book</code></a> </li> <li><a name="toc-Filename-extensions-1" href="Filename-extensions.es.html#Filename-extensions">4.5 Filename extensions</a> </li> <li><a name="toc-Alternative-methods-of-mixing-text-and-music" href="Alternate-methods-of-mixing-text-and-music.es.html#Alternate-methods-of-mixing-text-and-music">4.6 Alternative methods of mixing text and music</a> </li> </ul> </li> <li><a name="toc-Converting-from-other-formats-1" href="Converting-from-other-formats.es.html#Converting-from-other-formats">5. Converting from other formats</a> <ul class="toc"> <li><a name="toc-Invoking-midi2ly-1" href="Invoking-midi2ly.es.html#Invoking-midi2ly">5.1 Invoking <code>midi2ly</code></a> </li> <li><a name="toc-Invoking-musicxml2ly-1" href="Invoking-musicxml2ly.es.html#Invoking-musicxml2ly">5.2 Invoking <code>musicxml2ly</code></a> </li> <li><a name="toc-Invoking-abc2ly-1" href="Invoking-abc2ly.es.html#Invoking-abc2ly">5.3 Invoking <code>abc2ly</code></a> </li> <li><a name="toc-Invoking-etf2ly-1" href="Invoking-etf2ly.es.html#Invoking-etf2ly">5.4 Invoking <code>etf2ly</code></a> </li> <li><a name="toc-Generating-LilyPond-files-1" href="Generating-LilyPond-files.es.html#Generating-LilyPond-files">5.5 Generating LilyPond files</a> </li> </ul> </li> <li><a name="toc-GNU-Free-Documentation-License-1" href="GNU-Free-Documentation-License.es.html#GNU-Free-Documentation-License">A. GNU Free Documentation License</a> </li> <li><a name="toc-LilyPond-index-1" href="LilyPond-index.es.html#LilyPond-index">B. LilyPond index</a> </li> </ul> </div> </div> </body> </html>