User Tools

Site Tools



The Gregowiki is a central location for all Gregorio users to find:

  • Tips and Hints
  • Code Snippets
  • Installation Procedures
  • Links
  • And anything else!

What is Gregorio?

Gregorio is an open-source project offering software tools for typesetting (engraving) Gregorian chant scores. In particular, Gregorio is an add-on package for the typesetting system LaTeX, so it requires an installation of TeXLive.

Gregorio and LaTeX together produce PDF output suitable for printing.

The input to Gregorio is a notation called GABC, which combines the syllables of a chant text with a simple notation indicating the position and shape of each note.

For most users, it's not necessary to install Gregorio on your own computer. Instead you can access it using one of the on-line Gregorio web interfaces listed below.

On-line Tools

Running Gregorio on-line

There are two web sites that have versions of the Gregorio software installed. They offer interfaces where a user can enter GABC code, make selections about the output format, and receive a PDF file with the score produced by the Gregorio (and LaTeX) software:

Tools for preparing text

Since GABC code assigns notes to syllables of the sung text, this tool can be useful in breaking up a text into syllables:

Some users like to add hyphens whenever a word has more than one syllable, but be aware that it's not a requirement. Here are tools for that purpose:

If you prefer, it's fine to let Gregorio insert hyphens automatically where they are needed for formatting.

Tools for producing GABC code

Ben Bloomfield's on-line tools can apply melodic formulas to hymn texts, psalm verses, and scripture texts:

Tutorials And Guides



  • TexLive TeXLive is a package for installing LaTeX typesetting software. It is updated annually and includes a reasonably current version of Gregorio, so if you need to install the software on your computer in order to undertake a highly customized and automated project, TeXLive is the foundation to start with.
  • Latest features of Gregorio not yet integrated in the documentation
  • Notatio Antiqua - a GUI .gabc editor and compiler.
  • Greg - a desktop GUI application for Gregorio. It assists in compiling gabc files (windows only) and can also play them as midi files
  • gabc2tk, that supersedes the unmaintained gabc2mid - a CLI python script to convert gabc files into midi. Tested and working under linux and windows, should work on osX ; under windows, you could prefer using Greg.
  • Gregorio comes with a compilation script called gprocess which is a perl script designed to instantly show the result of a gabc file using your system's pdf viewer.
  • gly - “Gabc with separate LYrics” or “Gabc for liLYponders”
  • lygre - ruby gem providing script grely.rb which converts gabc to simple lilypond. Currently the conversion is possible only to modern notation, with great information loss.

Text editor tools for gabc files

  • gregorio-mode.el A Gregorio mode configuration for the Emacs editor; it performs automatic syntax highlighting. Instructions are here.
  • gabc-mode.el One (actually two) more, much simpler, Emacs mode; syntax highlighting + some quick-code-insertion shortcuts.
  • - A Gregorio mode configration for the Notepad++ editor, for use with .gabc files. (Documentation and tutorials on Notepad++ syntax colour files are available here.
  • There are also several syntax-colouring files that come with your Gregorio installation. Look in your Gregorio's application folder under “contrib”. (Or look in the same folder at github.) There are files for BBEdit, TextWrangler, Scribus, Gedit, Kedit, Emacs, Vim, and Texshop (Mac OSX).


Developer notes

Technical support

Mailing lists

Bug reports

Works produced with Gregorio

Several published books and smaller works have been produced using Gregorio.

Helping to build this site

If you wish to contribute to the gregowiki, contact us through the gregorio-users mailing list. – administrators rac, bgm, and pierre

  • Wiki Tips - helpful hints for using this wiki.
start.txt · Last modified: 2023/08/30 15:11 by pcouderc