This program takes a plain-text file formatted in a certain way that describes how to output a formatted chord sheet. The program can print the formatted chord sheet in plain text and generate a PDF.
author: John Doe
title: Song Doe
capo: None
key: G
tuning: Standard
[Section Name]
Happy Birthday
to you
Chords are inserted, in order, in new lines above the >s, which are removed.
[Section Name]
chords: C G
Happy >Birthday
to >you
(You can, of course, also specify the chords already formatted in plain text.)
[!Section Name] (Hides section name in output)
[>Section Name] (Defines section to be reproduced later)
[<Section Name] (Reproduces section)
See battlehymn.txt.
$ acchording song.txt
$ acchording song.txt > song-chords.txt
If -p is passed, the program will output a PDF containing the input chord sheet.
Pass --help for list of available options. If you want to print UTF-8 encoded characters (like Cyrillic ones), you have to pass -u.
You can also provide options in the file header; see src/file.hpp for possible options. Values in file header are overridden by values passed via command line.
$ acchording -p song.txt # Outputs song.pdf
$ acchording -p --body-font "Ubuntu Mono:Regular" --size 12 song.txt
Fonts are fetched with fontconfig. Supply TrueType fonts by names that it will find.
You can configure some default values by copying src/config.def.hpp into src/config.hpp and editing that. If you don't, the default values from src/config.def.hpp will be used.
$ make
Licensed under the GNU General Public License Version 3, see LICENSE.