gregowiki

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

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

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.

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:

• Illuminare online score editor
• run.gregoriochant.org Chant Engraver
• demo video from Corpus Christi Watershed, using run.gregoriochant.org

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

• Syllabifier for Latin text

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:

• Hyphen-la for liturgical Latin
• Hyphenator for English text

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

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

• GABC generator for hymns
• GABC generator for propers with Rossini psalm-tones. You can get a Chrome app for it here.
• GABC generator for psalm texts with psalm tones
• GABC generator for scripture readings

• gabc Tutorial
• Gregorio gabc Code Reference
• Gregorio gabc Header Reference
• Gregorio Tex Code Reference for Gregorio.
• Tweaking Your Chant Output
• Using Macros in your gabc
• Working With Fonts
• Common Unicode Characters used in chant notation (Reference)
• Troubleshooting
• Latest features
• Video demo of run.gregoriochant.org web interface (Note: the video references an old name for the web site)
• Video demo of Illuminare Score Editor (Note: the editor web site has moved to a new URL since this video was made)

• GregoBase - database of gabc chant scores
• Upload a new chant score to the GregoBase
• The Caecilia Project - collection of gabc scores
• Collection of Chant-Related Links
• Nova Vulgata
• Benjamin Bloomfield's Blog - the designer of some of the online gabc tools
• Gregorian Chant repertoire fr en Cantus
• Gradualia et Antiphonarii
• Ordo Cantus Missæ Prænotanda (fr)
• .tex templates
• Scripts

• 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.
• The official Gregorio web site
• Latest features of Gregorio not yet integrated in the documentation
• Gregorio GIT
• 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.
• lilygabc - library providing support for gabc input in LilyPond

• 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.
• NPP_Gregorio.zip - 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).

• How to Install TexLive
• Gregorio software releases for people working with the very latest editions (i.e., not most users)

• Nabc

• Troubleshooting
• #gregorio IRC channel on freenode.
• Gregorio Webchat

• All Gregorio mailing lists
• The gregorio-users list: information and subscription form
• https://groups.google.com/g/gregorio-users Mailing List Archives
• Search engine for gregorio-users mailing list
• MusicaSacra Forum - there are gregorio users there!
• gregorio-users Mailing List posting address

• View and submit Gregorio bug reports here

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

• Works produced with Gregorio

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.