Installing Gregorio under MAC OS

The TeX distribution

The first step to make Gregorio work is to have a TeX distribution: MacTeX or TeXLive. See the official site for instructions.

The installer

An installer has been created for some Mac systems. It is available from the download page, meant for systems running OS X versions 10.5 or later.

Compiling from sources

Development environment installation

To be able to compile Gregorio, you must first install an installation environment. Here are the main guidelines:

  1. download XCode (free) from the Apple Mac App Store
  2. lauch it, it will first want to install a device manager, install it
  3. under Preferences, click on Downloads and install the Command Line Tools
  4. download and install MacPorts (free)
  5. once installed, in the TERMINAL, do sudo port selfupdate to get the latest sources packages
  6. do sudo port install libtool autoconf automake flex bison libxml2.

Once all this is done, you should be able to compile Gregorio.

If you want to compile fonts (to modify them), do sudo port install fontforge.

Source downloading

First thing is to create a place to put the Gregorio files, e.g., ~/Documents/gregorio:

$ mkdir -p ~/Documents/gregorio $ cd ~/Documents/gregorio

You have a choice between versions of Gregorio. To obtain the sources of the stable version, you just need to download the sources from the download page, and decompress the archive.

To get the SVN version, that is, the version in development (more functionalities, but might contain more bugs), you will have to create a local copy of the subversion repository of the project, with the command:

$ svn co svn:// gregorio-svn $ cd gregorio-svn


Once the sources are downloaded, carry out the following commands in the directory containing the source files:

$ autoreconf -f -i (if you have the svn version)
$ ./configure CFLAGS='-I/opt/local/include' CPPFLAGS='-I/opt/local/include' LDFLAGS='-L/opt/local/lib'
$ make
$ sudo make install
$ cd fonts
$ sudo make install


To update your svn version, you just need to go in the directory containing the source files, run svn up and recompile with the same instructions as the previous Compilation section.
Last modification: 19 June 2013.


This document and the design of this site (by Patrick Roux) are under GPL.