ChordPro syntax
ChordPro is a plain text format for writing songs with chords. Leggio saves every song in ChordPro, so your songs stay readable by other apps and by any text editor.
This page describes what Leggio does: the full ChordPro format has many more directives, and the ones Leggio doesn’t know stay in the text but have no effect (see at the end).
Chords
Section titled “Chords”Chords go in square brackets, right before the syllable they fall on:
[Am]This is [F]my [C]songA line can contain chords only, for an intro or an instrumental passage:
[C] [G] [Am] [F]How to write a chord
Section titled “How to write a chord”- Note:
C D E F G A B, with#orb(F#,Bb). Italian names work too:Do Re Mi Fa Sol La Si,Do#,Mib,Sib. - Minor:
m(Am), but alsomin,mior-. - Other:
7,maj7,9,11,13,6,6/9,sus2,sus4,add9,dim,dim7,aug,m7b5, alterations likeb9or#11, in brackets too:C7(b9). The7+of Italian notation means major seventh. - Bass: after the slash,
G/BorSol/Si. - No chord:
N.C.
Italian songbooks often have Re4 for Dsus4 and Re2 for Dsus2: Leggio understands them.
When you transpose, Leggio changes the note and the bass and leaves the rest as it is, so any chord symbol stays intact.
Annotations and marks
Section titled “Annotations and marks”[*text]is an annotation: it shows in gray and is not transposed. For example[*x2]or[*Riff].[*|]on a chords-only line is a bar line: bars wrap together.(Am7)in round brackets is an optional chord.- A line of at least four dashes (
----), equals signs, underscores or asterisks becomes a separator line.
Section headers
Section titled “Section headers”The simplest way to split the song into parts is a comment:
{c: Intro}{c: Verse 1}{c: Chorus}{c: Bridge}Leggio shows the header in a colored label, as you wrote it. The editor’s section bar inserts these headers for you.
The chorus is marked with a vertical bar on the side. You can mark it out in two ways:
{start_of_chorus}[C]Sing with [G]me{end_of_chorus}or with a header that contains “Chorus”: the bar runs down to the next section. The short forms {soc} and {eoc} work like the long ones.
{chorus} on its own shows the “Chorus” header, but does not repeat the chorus lyrics.
{start_of_tab}e|-----0-----|-----0-----|B|---0---0---|---1---1---|G|-0-------0-|-0-------0-|{end_of_tab}The tab shows in a fixed-width font and wraps at the bar lines. A chord line right above the tab is lined up with its columns. Tabs are not transposed and are not shown with the Keyboard instrument.
{sot} and {eot} work too, but if you use the editor’s Visual mode, write the long forms: Visual mode mistakes the short ones for section headers.
Song information
Section titled “Song information”These directives usually go at the top of the file. When you import a file, Leggio uses them to fill in the song’s fields:
| Directive | What it does |
|---|---|
{title: …} or {t: …} |
The song’s title. |
{artist: …} or {subtitle: …} |
The artist. |
{key: …} |
The key. |
{tempo: …} or {bpm: …} |
The BPM (whole numbers only). |
{capo: …} |
The capo to start from. Leggio also recognizes {c: Capo 2} and a “Capo 2” line. |
{time: 3/4} |
The time signature, used by the metronome for the accents. |
{duration: …} |
The duration, used to set the auto-scroll speed. |
After the import, title, artist, key and BPM are edited in the editor’s fields, not in the text.
Chord diagrams
Section titled “Chord diagrams”With {define} you draw a chord shape your own way:
{define: Bm base-fret 1 frets x 2 4 4 3 2}There are also {define-guitar: …} and {define-ukulele: …} for a single instrument. The diagram follows the transposition and the capo.
Listening links
Section titled “Listening links”{x_leggio_listen: https://…} is a Leggio directive: it holds the link to a video or a track to listen to. Leggio writes it when you export a song and reads it back when you import it, so listening links don’t get lost.
Directives Leggio does not use
Section titled “Directives Leggio does not use”The directives Leggio doesn’t know (for example {start_of_verse}, {comment_italic}, {meta: …}, {composer: …}, {new_page}) stay in the text and are exported as they are, but when you read the song they show up as an uppercase label. You can hide them, together with all the headers, by turning off Section headers in Settings → Customization.
{time: …} also shows up as a label, and {comment: …} written in full shows the word “COMMENT” in front: for sections, use the short form {c: …}.
A complete example
Section titled “A complete example”{title: Example}{artist: Leggio}{key: G}{tempo: 92}{capo: 2}
{c: Intro}[G] [*|] [Em] [*|] [C] [D]
{c: Verse 1}[G]This is the [Em]first versethat [C]talks about [D]nothing
{start_of_chorus}{c: Chorus}[C]Sing it with [G/B]me, the [Am7]cho[D7sus4]rus [*x2]{end_of_chorus}
{c: Solo}{start_of_tab}e|-----0-----|-----0-----|B|---0---0---|---1---1---|{end_of_tab}
{c: Outro}[G] [(Em)] [C] [D] [G]