The ChordPro format
This page is for Songwriters and Admins. The Lyrics & chords box in the song editor takes a song written in ChordPro: plain text, with chords in square brackets and a few instructions in curly brackets. Songbook reads it and lays out the song sheet, so you never have to line chords up by hand. To see the result before you save, select Preview.
Chords
Section titled “Chords”Put each chord in square brackets, straight before the syllable where it changes:
[C]Down by the harbour, [F]watching the boats come [G]inA chord can go in the middle of a word, and Songbook places it over the right letter:
Wan[F]dering home a[G]gain to[C]nightChord names start with a note, A to G, optionally followed by # or b (F#, Bb), then the kind of chord (m, 7, maj7, sus4, dim and so on). Slash chords such as G/B work too. These are the chords Songbook transposes and draws diagrams for.
Anything else in square brackets, such as [N.C.] for no chord or a strumming mark like [/], is shown above the lyrics just like a chord, but gets no diagram and is never transposed.
Verses and blank lines
Section titled “Verses and blank lines”Write each line of the song on its own line. A blank line starts a new verse, with a gap before it.
Section labels
Section titled “Section labels”Use a comment to label a section. It’s shown on its own line, above what follows:
{comment: Verse 2}[Am]Rain on the window, [D]kettle on the stove{c: Verse 2} is a shorter way to write the same thing. {comment_italic:} (or {ci:}) and {comment_box:} (or {cb:}) are accepted too, and look the same.
The Verse button in the editor adds a {comment: Verse} label for you.
Choruses
Section titled “Choruses”Wrap a chorus between {start_of_chorus} and {end_of_chorus} to highlight it in a shaded block:
{comment: CHORUS}{start_of_chorus}Sing it [F]loud, sing it [G7]out to the [C]sea [Am]Sing it [F]loud, and [G7]sing it with [C]me [G7]{end_of_chorus}{soc} and {eoc} are the short forms. The chorus doesn’t label itself, so add a {comment: CHORUS} above it as shown. The Chorus button in the editor writes all of this for you.
Wrap tablature between {start_of_tab} and {end_of_tab} (or {sot} and {eot}). Everything in between is shown exactly as you type it, in a fixed-width font so the columns line up. Square brackets inside a tab aren’t read as chords.
{start_of_tab}A|-----0---3---|E|---0---------|C|-0-----------|G|-------------|{end_of_tab}Columns and pages
Section titled “Columns and pages”{column_break}(or{colb}) starts a new column. On a wide screen the columns sit side by side; on a narrow one they follow each other.{new_page}(or{np}) also starts a new column on screen, and when the song is printed, it starts a new page.
Hidden lines and ignored instructions
Section titled “Hidden lines and ignored instructions”- A line that starts with
#is left out of the song sheet altogether, so you can use it for notes to yourself. - Instructions such as
{title:},{artist:},{key:}and{capo:}are ignored. The fields at the top of the editor set those. - Any instruction Songbook doesn’t recognise is ignored rather than shown.
An instruction has to be on a line by itself.
Custom chords
Section titled “Custom chords”Songbook has about 170 built-in shapes. When a song uses a chord that isn’t one of them, its diagram is a dashed box with a ?. You can add the shape yourself, or give a chord a different fingering for one song.
Put custom chords in Custom chord definitions, one per line, in this form:
NAME frets G C E A fingers G C E A- NAME is the chord name exactly as it appears in the song’s square brackets.
- After
frets, give the fret for each string, from the G string to the A string. Use0for an open string andxfor a string you don’t play. The wordfretsis optional:C 0 0 0 3andC frets 0 0 0 3mean the same. fingersis optional: the finger for each string,1for your index finger to4for your little finger,0for none. Finger numbers are shown in the diagram’s dots.
For example:
F frets 2 0 1 0 fingers 2 0 1 0G7 frets 0 2 1 2 fingers 0 2 1 3Dm frets x 2 1 0You can also write the four numbers together, as in C frets 0003, when every fret is a single digit.
For a barre, add an extra dot for each string the barre covers with add: string N fret F finger G, numbering the strings 1 (G) to 4 (A):
Bbm frets 3 1 1 1 fingers 3 1 1 1 add: string 1 fret 1 finger 1If a shape goes above the fifth fret, the diagram moves up the neck and shows the starting fret beside it.
Instead of the custom chords box, you can put a definition in the song itself, on its own line:
{define: Csus2 frets 0 2 3 3 fingers 0 1 2 3}A custom chord only affects the song it belongs to, and it replaces the built-in shape of the same name in that song. It’s used exactly as written: it isn’t converted when someone chooses Baritone tuning, and if someone transposes the song, the transposed chords use the built-in shapes.
A complete example
Section titled “A complete example”{comment: Verse 1}[G]Morning light on the [C]garden wall[G]Nobody's up but the [D]birds at all
{comment: CHORUS}{start_of_chorus}[C]Oh, the [D]day is [G]new [Em][C]Oh, the [D]day is [G]new [D7]{end_of_chorus}
{column_break}
{comment: Verse 2}[G]Coffee's on and the [C]radio plays[G]Same old song for the [D]same old days# Remember: slow down here{start_of_tab}A|--2--0-----|E|--------3--|{end_of_tab}