Home

Awesome

openbook

version: 0.0.1

description: OpenBook is an open source Jazz real book

website: https://veltzer.github.io/openbook

Build

build

OpenBook is a standards book for Jazz players which containts hundreds of jazz standards

Contact

chat with me at gitter

What is OpenBook?

OpenBook is a Jazz real book constructed with free software. A real book simply means a big book with lots ofJazz tunes or standards as they are more widely known.

Where is the project's website?

https://veltzer.github.io/openbook

Why did you start this?

Because of many reasons:

What tools are used?

What python modules are used?

What is produced?

Beautiful and lightweight postscript and PDF real books with Jazz tunes. The idea is that the end user can control the final output and decide if he/she wants lyrics, size of paper, transposition for a trumpet, selection of tunes and more. In addition, you can produce midi, mp3 and ogg outputs. Possibly other output formats will be supported in the future (epub?).

What is the copyright?

All the stuff in this project is GPL version 3. The tunes themselves have their own copyright holders.

Who can contribute?

Anyone.

What system do I need to participate?

A Linux system that you can install software on. Mac OSX is reported to work too if you know how to install the right stuff on it. Windows is not currently supported although well-formed patches will be accepted. (disclaimer: the author hates Windows with a vengence so patches have to be spotless to be accepted)

What do I need to know to participate?

Who currently contributes?

Look at the CREDITS file

Your name could be here if you contribute...

Where can I see some results?

Check out the PDFs and other outputs in https://veltzer.github.io/openbook.

Why is there so little documentation?

I just started this project (4 years all in all -> that's not true: it's 12 years in the making). Feel free to add stuff and request a pull. Contributing may make you an admin...

How do you write the standards?

Using lilypond. Check it out at http://www.lilypond.org/.

Will you co-operate with the lilypond, mutopia and wikifonia communities?

YES! Any bugs or feature suggestion are submitted to the lilypond community. Any requests for pieces from the mutopia community will be respected. Wikifonia uses musicXML for typesetting while I use an essentially lilypond format as input format - so there could not be much co-operation there.

Do you only allow Jazz tunes?

No. Rock and Pop will be welcome and so would classical. If you are really into classical lilypond production, you may alternativly wish to contribute to the mutopia project at http://www.mutopiaproject.org/.

How do I build the pdfs?

MacOS user notes

How do I contribute?

Can I just add a single tune?

Yes. To add a tune named [tunename] just add single file named

src/openbook/[tunename].ly.mako

Yes, the extension should be .mako since I use "mako" for templating. In that file there are sections. Just copy them from some other tune. One section for chords, another for lyrics, another for the melody etc. After working on the tune build just a single tune by issueing:

make out/src/openbook/[tunename].pdf

or

make out/src/openbook/[tunename].midi

or

make out/src/openbook/[tunename].stamp

to get both pdf and midi.

To get the external pdfs build

make out/src/openbook/[tunename].?.pdf

Can I just build a single tune?

Sure. Just use:

make out/src/openbook/[tunename].pdf

to build the pdf

make out/src/openbook/[tunename].midi

to build the midi

make out/src/openbook/[tunename].stamp

to get both pdf and midi.

What about MusicXML?

Sorry, this project is lilypond based. Patches for MusicXML will be welcome, but I don't see how they will fit into this project.

Can I send corrections to the tunes without learning lilypond and all the rest of the stuff?

Yes. Just send them as regular text via my email below.

Where can I get more documentation about this project?

Look in the doc subfolder of the source code...

How can I get a version of this book in a key other than C?

Just edit include/common.ly.mako and change TONALITY="c" to "bes" or "ees" before compiling.

How do I download the external pdfs to compare them to this project?

Just run:

make real_books_archive.gi

and look at the resulting real_books_archive.gi folder that is created.

Mark Veltzer, Copyright © 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024