Using Gregorio with Scribus

This page describes the use of Gregorio within Scribus.


Scribus is a free DTP (desktop publishing) software with a simple and accessible graphical user interface. It is possible to include Gregorio scores in a Scribus document, and thus to build a book or a booklet containing Gregorian scores simply.

Installing the additional Scribus files

To be able to use Gregorio in Scribus, some additional files for Scribus must be installed. These files are available in the contrib/ directory of the Gregorio sources, and also in the Git repository. These files are 900_gregorio.xml and gregorio.png. If you are under Windows, they are in C:\Program Files\Gregorio\contrib (assuming you have gregorio installed here).

If you are under MacOS X or if you have installed Gregorio under Windows with the advanced method, you will need to slightly modify these files to adapt them to your system. These modifications are described in the comments of the file 900_gregorio.xml.

Finally, you need to make Scribus use these files. In the Scribus menu, go to File/Preferences. Then, in the External Tools part, under Render Frames, click on Add and select the file 900_gregorio.xml. Something you might want to do is to make gregorio the first item of the list. To do so, click on Up several times. Click on Apply, then OK, and you're done.

Use in Scribus

The use of gregorio inside Scribus is almost the same as the use of LaTeX within Scribus: click on Insert/Insert Render Frame, then select the area in which you want a score to appear. Right-click on this area and click on Edit Source, and the editor will open.

First select gregorio in the program list (if it's not selected by default). The left text area allows you to enter the gabc code of the score. Two other tabs are present: one to add some packages to the LaTeX header, and one to enter some GregorioTeX commands.

The rendering result may look strange at first, because the preview has a low quality; this is not the case for the final rendering; which you will see if you export in PDF.

When you try to export a PDF, you will need to check the box Embed EPS & PDF files (EXPERIMENTAL). While exporting, Scribus will output some warnings, but you can ignore them safely. If you cannot check that box (this happens in certain versions, especially under Linux), the scores will be included as images, which can introduce pixelization. To improve the quality of the images, you can change the value of the option Resolution for EPS Graphics; 600dpi is a standard value for desktop printers. Note that in this case the size of the PDF output file will be as much as 10 times greater.