{"id":22442898,"url":"https://github.com/veltzer/openbook","last_synced_at":"2026-02-09T04:35:02.851Z","repository":{"id":1316265,"uuid":"1261113","full_name":"veltzer/openbook","owner":"veltzer","description":"OpenBook is an open source Jazz real book","archived":false,"fork":false,"pushed_at":"2025-07-07T22:29:58.000Z","size":190421,"stargazers_count":297,"open_issues_count":14,"forks_count":48,"subscribers_count":28,"default_branch":"master","last_synced_at":"2025-07-22T10:44:03.577Z","etag":null,"topics":["jazz","music","open-book","open-source","opensource","pdf","real-book","realbook","sheet-music","standards"],"latest_commit_sha":null,"homepage":"https://veltzer.github.io/openbook/","language":"Mako","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/veltzer.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["veltzer"]}},"created_at":"2011-01-16T19:12:42.000Z","updated_at":"2025-07-07T22:30:01.000Z","dependencies_parsed_at":"2023-09-24T16:50:40.265Z","dependency_job_id":"cb019d9f-c8e3-4f9a-8c19-0c11692ccbdc","html_url":"https://github.com/veltzer/openbook","commit_stats":{"total_commits":1761,"total_committers":9,"mean_commits":"195.66666666666666","dds":"0.060760931289040365","last_synced_commit":"d341811062a866f735c0fcda9273798c95ba1fb3"},"previous_names":[],"tags_count":175,"template":false,"template_full_name":null,"purl":"pkg:github/veltzer/openbook","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/veltzer%2Fopenbook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/veltzer%2Fopenbook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/veltzer%2Fopenbook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/veltzer%2Fopenbook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/veltzer","download_url":"https://codeload.github.com/veltzer/openbook/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/veltzer%2Fopenbook/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268162340,"owners_count":24205700,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-01T02:00:08.611Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["jazz","music","open-book","open-source","opensource","pdf","real-book","realbook","sheet-music","standards"],"created_at":"2024-12-06T02:21:01.647Z","updated_at":"2026-02-09T04:35:02.775Z","avatar_url":"https://github.com/veltzer.png","language":"Mako","funding_links":["https://github.com/sponsors/veltzer"],"categories":[],"sub_categories":[],"readme":"## openbook\n\nversion: 0.0.1\n\ndescription: OpenBook is an open source Jazz real book\n\nwebsite: https://veltzer.github.io/openbook\n\n## Build\n\n![build](https://github.com/veltzer/openbook/workflows/build/badge.svg)\n\nOpenBook is a standards book for Jazz players which containts hundreds of jazz standards\n\n## Contact\n\nchat with me at [![gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/veltzer/mark.veltzer)\n\n## What is OpenBook?\nOpenBook 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.\n\n## Where is the project's website?\nhttps://veltzer.github.io/openbook\n\n## Why did you start this?\nBecause of many reasons:\n* I wanted to learn Jazz, and a good way to do that is to write down the tunes (amongst many other things).\n* I wanted beautiful sheet music that I could fiddle with.\n* I did not want to pay for the overly expensive real or fake books out there.\n* I believe in free software and wanted free (in the sense of freedom) sheet music.\n* Jazz is a prime example of a free type of art, so it's conjunction with free software seems a match made in heaven.\n* Jazz musicians may need beautiful electronic Real books because electronic books are starting to be\nused by Jazz musicians both for practice and for performance.\n\n## What tools are used?\n* python3: for the python scripts\n* virtualenv: for using virtualenv for python\n* lilypond: this is the main tool we use\n* qpdf: for qpdf(1) (used in pdf size reduction)\n* ghostscript: for ps2pdf(1), pdf2ps(1), gv (used in pdf size reduction and cutting pdfs)\n* timidity: play output midi and convert midi to wav\n* lame: convert audio (encode ogg)\n* tidy: for tidy(1) (used in checking HTML)\n* okular: kde pdf reader\n* python-mako-doc: documentation for the template preprocessor\n* texi2html: needed to install lilypond from source\n* guile-2.2-dev: needed to install lilypond from source\n* lilypond-doc: documentation for lilypond\n* lilypond-doc-html: documentation for lilypond\n* lilypond-doc-pdf: documentation for lilypond\n* npm: for htmlhint\n\n## What python modules are used?\n* pytconf: Configuration, command line and injection framework for python\n* python-dateutil: Extensions to the standard Python datetime module\n* tqdm: Fast, Extensible Progress Meter\n* PyMySQL: Pure Python MySQL Driver\n* Mako: A super-fast templating language that borrows the best ideas from the existing templating languages.\n* requests: Python HTTP for Humans.\n* gitpython: GitPython is a Python library used to interact with Git repositories\n\n## What is produced?\nBeautiful and lightweight postscript and PDF real books with Jazz tunes.\nThe idea is that the end user can control the final output and decide if he/she\nwants lyrics, size of paper, transposition for a trumpet, selection of tunes and more.\nIn addition, you can produce midi, mp3 and ogg outputs.\nPossibly other output formats will be supported in the future (epub?).\n\n## What is the copyright?\nAll the stuff in this project is GPL version 3. The tunes themselves have their own copyright holders.\n\n## Who can contribute?\nAnyone.\n\n## What system do I need to participate?\nA Linux system that you can install software on.\nMac OSX is reported to work too if you know how to install the right stuff on it.\nWindows is not currently supported although well-formed patches will be accepted.\n(disclaimer: the author hates Windows with a vengence so patches have to be spotless\nto be accepted)\n\n## What do I need to know to participate?\n* Some rudimentary Linux system administration (in order to install the software needed for this project to build).\n* Some basic git software content tracking (in order to fetch the project, modify and submit patches).\n* The lilypond language (in order to edit or add tunes).\n* Some music knowledge would also help...:)\n\n## Who currently contributes?\nLook at the CREDITS file\n\nYour name could be here if you contribute...\n\n## Where can I see some results?\nCheck out the PDFs and other outputs in https://veltzer.github.io/openbook.\n\n## Why is there so little documentation?\nI just started this project (4 years all in all -\u003e that's not true: it's 12 years in the making). Feel free to add stuff and request a pull.\nContributing may make you an admin...\n\n## How do you write the standards?\nUsing lilypond. Check it out at http://www.lilypond.org/.\n\n## Will you co-operate with the lilypond, mutopia and wikifonia communities?\nYES! Any bugs or feature suggestion are submitted to the lilypond community.\nAny requests for pieces from the mutopia community will be respected.\nWikifonia uses musicXML for typesetting while I use an essentially lilypond\nformat as input format - so there could not be much co-operation there.\n\n## Do you only allow Jazz tunes?\nNo. Rock and Pop will be welcome and so would classical.\nIf you are really into classical lilypond production, you may alternativly\nwish to contribute to the mutopia project at http://www.mutopiaproject.org/.\n\n## How do I build the pdfs?\n* you need tools installed. on Ubuntu ```$ sudo apt install lilypond qpdf```\n* clone the repository ```$ git clone git://github.com/veltzer/openbook.git```\n* cd into the newly created folder ```$ cd openbook```\n* install python tools to create a python virtual envrionment. on Ubuntu ```$ sudo apt install python3 virtualenv```\n* create a python virtual environment ```$ virtualenv --python=/usr/bin/python3 .venv```\n* activate the virutal env ```$ source .venv/bin/activate```\n* update pip ```$ python -m pip install --upgrade pip```\n* install the python prerequisites ```$ pip install -r requirements.txt```\n* run the build process ```$ make```\n* the pdfs should now be built, and you will find them in the 'docs' folder.\n* if you want to build all the tunes individually then run ```$ make all_tunes```\n\n## MacOS user notes\n* [Python3](https://realpython.com/installing-python)\n* [pip](https://pip.pypa.io/en/stable/installing)\n* [qpdf](https://github.com/qpdf/qpdf)\n* make (on Mac/OS X this is part of X-Code or [command line tools](https://stackoverflow.com/a/9329325/2223106))\n\n## How do I contribute?\n* create an account on github.\n* hack on the .ly.mako files (git add the files that you hack on).\n* commit to your own hard drive repository (git commit).\n* push to git hub (git push).\n* send me a pull request (button in the github ui).\n\n## Can I just add a single tune?\nYes. To add a tune named [tunename] just add single file named\n```\nsrc/openbook/[tunename].ly.mako\n```\nYes, the extension should be .mako since I use \"mako\" for templating.\nIn that file there are sections. Just copy them from some other tune. One section for\nchords, another for lyrics, another for the melody etc.\nAfter working on the tune build just a single tune by issueing:\n```sh\nmake out/src/openbook/[tunename].pdf\n```\nor\n```sh\nmake out/src/openbook/[tunename].midi\n```\nor\n```sh\nmake out/src/openbook/[tunename].stamp\n```\nto get both pdf and midi.\n\nTo get the external pdfs build\n```sh\nmake out/src/openbook/[tunename].?.pdf\n```\n\n## Can I just build a single tune?\nSure. Just use:\n```sh\nmake out/src/openbook/[tunename].pdf\n```\nto build the pdf\n```sh\nmake out/src/openbook/[tunename].midi\n```\nto build the midi\n```sh\nmake out/src/openbook/[tunename].stamp\n```\nto get both pdf and midi.\n\n## What about MusicXML?\nSorry, this project is lilypond based. Patches for MusicXML will be welcome, but I don't\nsee how they will fit into this project.\n\n## Can I send corrections to the tunes without learning lilypond and all the rest of the stuff?\nYes. Just send them as regular text via my email below.\n\n## Where can I get more documentation about this project?\nLook in the `doc` subfolder of the source code...\n\n## How can I get a version of this book in a key other than C?\nJust edit `include/common.ly.mako` and change TONALITY=\"c\" to \"bes\" or \"ees\" before compiling.\n\n## How do I download the external pdfs to compare them to this project?\nJust run:\n``` sh\nmake real_books_archive.gi\n```\nand look at the resulting `real_books_archive.gi` folder that is created.\n\nMark Veltzer, Copyright © 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fveltzer%2Fopenbook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fveltzer%2Fopenbook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fveltzer%2Fopenbook/lists"}