Songbook Py2TeX

Python generator for songbook in PDF, from plain TXT via TeX format

Idea

Songs

• Organize songs by folders
• Put in every forlde file 0.dir
• Type name of section in first row of 0.dir file
• Files and dirs names cannot contains spaces or nonlatin characters

Source of songs

Every song is in separate file, like

title: Umbriaga
authors: lyrics and music: Witold Zamojski


Kiedy jacht nie wraca z mórz | a7 D7
i w główkach portu ciągle go brak, | H7 e
Przejmujesz się i serce Ci drży, | a7
a może już pozostanie tak? | H7


 Umbriaga wciąż gna, | Ae
 silnych wiatrów nie boi się, | a7
 Szuflady wali raz po raz, | D7
 bo przebrany ma bras. | G H7
 Więc nie przejmuj się, | e
 oni wrócą tu, | a7
 Bo oprócz wiatrów i burz | D7
 muszą być, i już. | G H7

chorus

keyword chorus repeat chorus instead write again

Output

Songs are sorted alphabetically first by folders names, and later file names.

Table of contents is ordered alphabetically without folders.

After song processing XeLaTeX will process full songbook using songbook package. Output format is PDF.

Requirements

• XeLaTeX installation, the best are TeX Live or MacTeX (try full install)
• Python3

How to run

Linux or MacOS

sh start.sh

or if use Windows

start.bat

Configuration

Example of config.ini:

[Settings]
chord_right = 0
chorus_repeat = 1
slide = 0
font_lato = 1
new_page = 1
contents = 1

• chord_right - chord is printed on left (0) or right side (1)
• chorus_repeat - repeat (1) chorus or not (0)
• slide - generate as book (0) or as slide (1) eg. for mobile phone
• font_lato - use font lato (1) or default (0)
• new_page - every song start on new page (1) or not (0)
• contents - add (1) table of contents or not (0)