Skip to content

gmareske/openbook

 
 

Repository files navigation

Fakestbook

Fakestbook is a Jazz fakebook/song book compiled by free and open source software.

Quicklinks

TODO Project website!.

Want to download the book? This version might be slightly out of date.

Background

Historically, jazz fakebooks were hand-transcribed compilations of songs passed from musician to musician. I have one, it is very messy and disorganized. If you play jazz today, you might know them as "Real Books".

This project is an attempt to build a crowd-sourced, beautiful, digital pdf song book for jazz musicians. It uses the Lilypond music typesetting software and some scaffolding Scheme code to do so.

Why a fork?

Fakestbook is a fork of the openbook project. Many thanks to everyone who contributed there!

This was done for several reasons:

  • Code cleanup
  • Reduce dependencies
  • Speed
  • Ease of contributing

Eventually, the features I was working on grew too big in scope to be a reasonable pull request to the original.

Dependencies

How to Build

Building has only been tested on Linux. It should compile on any system that has the above dependencies and the normal suite of Unix command line tools.

  1. Ensure you have the dependencies installed on your system.
  2. Clone the repository and cd into it.
  3. To build the entire book, use the command make book. To build a single song, run make output/songs/<song name>.pdf.

Configuration

Configuration is done by editing config.ly. The configuration is written in Lilypond's scheme dialect, so a little scheme knowledge can help. Here's a short guide for some popular configuration options:

Need Help?

Use the Github Issues system to ask questions, one of the maintainers will get back to you.

Get Involved

Contributors are very welcome! See CONTRIBUTING.md for a guide on how to do so. But basically, we are looking for people to contribute code, songs, or both to the book. Feature requests are welcome as well.

Contact

Maintainers:

License

This repository is licensed under the GPLv3 license. See LICENSE for more details.

About

Open source lilypond real book for Jazz musicians

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • LilyPond 77.4%
  • Mako 13.1%
  • JavaScript 6.4%
  • CSS 1.7%
  • Python 0.6%
  • HTML 0.5%
  • Other 0.3%