Your ukulele club's songbook, on your own website. Drop your songsheets into a folder and the Songbook turns them into a song list with quick search and clean, printable song pages with chord diagrams. Its built-in Song-a-matic editor lets players transpose, switch tunings and resize a song before printing it.
Try it: live demo
You need Node.js 18 or newer. No other installs, no database.
npm startThen open http://127.0.0.1:8080/ in your browser.
Prefer PHP? If your web host runs PHP and Apache, the same songbook runs there too: see Running the songbook with PHP.
Songs live in the cpm/ folder, one plain-text file per song, named something.cpm.txt. They're written in ChordPro: chords go in square brackets right where they change, like [C]Mary had a [G7]little lamb. The sample songs in cpm/ show the markup, and the User's Guide and ChordPro Markup Reference cover the rest.
You can also add and edit songs in the browser once you've set up an account.
Copy ugs.config.example.json to ugs.config.json to set your songbook's title, require a login, add editor accounts, or share it on your network. See Configuration, which also shows how to change the editor's defaults (font size, tuning, theme).
The pages load prebuilt JavaScript and CSS, so you don't need to build to run the songbook. If you change anything under src/:
npm installnpm run buildSee Building, CI and the demo site for what the build does, the static demo and the GitHub Actions workflow.
npm test- Changelog: what's new in each release.
- Song pages on your own site: the static HTML demos and the song-rendering API.
- Technical reference and tips on the UkeGeeks blog.
- ukegeeks.org: edit a song online, the User's Guide, and the blog.
- UkeGeeks Songbook (this repo): your own songbook app, run with Node.js or PHP.
- Song Formatter: chord diagrams and songsheets on your own website.
- ACE ChordPro Extension: ChordPro editing for the Ace code editor.
Not sure which one you need? See which UkeGeeks tool is right for you.
Contributors: David Calam (djc-503), louis-coding, AceLan Kao (acelan) and hutzelknecht.
Licensed under the GNU General Public License. Use it, change it, fork it, but please keep the author attribution.
ukegeeks.com is no longer affiliated with this project; the official site is ukegeeks.org.


