Songbook
========

Songs data for LaTeX songbooks.

[![Build Status](https://drone.xd0.de/api/badges/hendrik/songbook/status.svg)](https://drone.xd0.de/hendrik/songbook)

## Patadata

This data is meant to be processed by the songbook toolkit:
- [command line client](https://github.com/patacrep/patacrep)
- [gui client](https://github.com/patacrep/patagui) (not up-to-date with this data)
- [web client](https://github.com/patacrep/patanet) work in progress.

[Documentation](http://patacrep.readthedocs.io)

## Getting started

```console
virtualenv -p python3 venv
source venv/bin/activate
pip3 install songbook
songbook books/songbook-hendrik.yaml
```

## Adding a song

1. Grab the lyrics with chords from [Ultimate guitar](https://ultimate-guitar.com).
2. Hit the edit button and copy the plain text from the pop up (usually has less superfluous newlines than if you copy the text directly).
3. Head to [ultimate.ftes.de](https://ultimate.ftes.de/), select `Latex` from the dropdown in the middle, and paste the text into the left text field. A slightly different version should appear on the right side.
4. Replace any `H` chords on the left side with `B`. If the left side includes German `B` chords that should be English `Bb` chords, replace them also.
5. Create a new file for the song in `./songs/<artist>/`.
6. Copy and paste the re-formatted Latex version from the right text box on the website into the new file.
7. Add an entry for the new song to `books/songbook-hendrik.yaml`, again in the right order.
8. Fix things. Add the song title and artist to the first line. Have a look at the other song files to find out what the result should look like. Pay special attention to bridges, interludes (especially if they contain only chords and no lyrics), capo instructions.

## Copyright

Most songs are copyrighted by the respective owners and can't be redistributed without their permission. We will prepare a version with only traditionals, songs whose copyright has expired, or that were released under a permissive licence by the copyright holder.

[Patacrep](http://patacrep.com) is released underthe terms of the GNU General Public License.

[Patadata](https://github.com/patacrep/patadata) is CC-BY-SA.