The UkeGeeks Family

UkeGeeks is a handful of free, open-source tools that all do one thing: turn plain-text songs into easy-to-read songsheets with chord diagrams. Which one you want depends on what you're trying to do.

I want to edit a song right now

Use the Song-a-Matic Editor, right here on ukegeeks.org. Paste in your lyrics and chords, and it draws the chord diagrams for you. You can transpose, switch to baritone tuning, and print. Nothing to install, no account.

New to the song format? Start with the User's Guide.

I want my own collection of songs

Use the UkeGeeks Songbook. It's a songbook app you run yourself: a song list with quick search, the full Song-a-Matic editor, and your songs kept as plain text files in a folder you own. It's great for ukulele clubs.

Run it on your own computer with Node.js (npm start), or on a PHP web host. Try the demo.

I want chord diagrams on my own website

Use Song Formatter. Add one script and one stylesheet to your page, put your song in a <pre>, and it draws the songsheet:

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ukegeeks/[email protected]/dist/song-formatter.bundle.css" />

<div id="ukeSongContainer">
  <aside id="ukeChordsCanvas"></aside>
  <article id="ukeSongText"><pre>{title: My Little Grass Shack}
[G]I want to go back to my [A7]little grass shack</pre></article>
</div>

<script src="https://cdn.jsdelivr.net/npm/@ukegeeks/[email protected]/dist/song-formatter.bundle.js"></script>
<script>
  ukeGeeks.scriptasaurus.init();
  ukeGeeks.scriptasaurus.run();
</script>

Developers can also install it from npm (npm install @ukegeeks/song-formatter) and render songs in Node. Try the demo.

I'm building my own song editor

Use the ACE ChordPro Extension. It adds ChordPro support to the Ace code editor: color highlighting, snippets, and chord-name autocomplete. It's what powers the Songbook's fullscreen editor. Try the live editor.

How they fit together

Song Formatter is the engine: it reads a song and draws the songsheet. The ACE extension is the editing component. The Songbook is built from both, and ukegeeks.org hosts the online editor, the docs, and this blog.

All of them read the same format, ChordPro: chords in square brackets, directives like {title: …} in braces. A song you write in one works in all of them.

What happened to Scriptasaurus?

Scriptasaurus was the original UkeGeeks JavaScript library. Song Formatter is its modern rewrite, with sharper SVG chord diagrams, and it now powers the Songbook.

Song Formatter keeps the same function names (ukeGeeks.scriptasaurus.run() and friends), so pages written for Scriptasaurus keep working. If your site loads the old ukeGeeks.scriptasaurus.min.js from ukegeeks.org, that file isn't going anywhere.