User guide · Reference

Chart text reference

Under every ChordCast chart is a few lines of plain text. You never have to write it, since the visual editor writes it for you, but it's the quickest way to type a chart in, and it's what you see in the text editor. Each example below is drawn on the page by the same renderer as the apps.

Basics

A chart is a few lines that start with % (the song's details), then the music. Each line of bars is written between barlines, |, and a name in square brackets starts a section.

%TITLE="Porch Light Blues"
%ARTIST="ChordCast Guide"
%KEY="F"

[A]
| F7 | Bb7 | F7 | F7 |
| Bb7 | Bdim7 | F7 | D7 |
| Gm7 | C7 | F7 D7 | Gm7 C7 |
A twelve-bar blues: three lines of four bars.
  • Chords in one bar share it evenly: | F7 D7 | is two beats each in 4/4.
  • Each line of text is a line on the chart. ChordCast fits the lines to the width of the screen and lines up barlines between lines of the same section.

Song details

%TITLE="Early Train"
%SUB_TITLE="Second set opener"
%ARTIST="ChordCast Guide"
%KEY="C"
%STYLE="Bossa Nova"
%TEMPO="140"

[A]
| CM7 | CM7 | D7 | D7 |
| Dm7 | G7 | Em7 A7 | Dm7 G7 |
LineWhat it does
%TITLE="…"The title. It's also the song's name in your library.
%SUB_TITLE="…"A line under the title.
%ARTIST="…"The artist or composer, shown at the top right and in your library.
%KEY="C"The key the chart is written in, like C, Bb or F#m. When you transpose, ChordCast names the key you're seeing from it.
%STYLE="…"The feel: Medium Swing, Bossa Nova, Ballad…
%TEMPO="140"Beats per minute. Turns on the tempo dot.
%REPEATS="3"How many times through the form.
%SHOW_STAFF="YES"Draw a staff under every line ("NO": never). Without it, lines with rhythm get a staff and the rest don't.

All of these are in the visual editor's Chart Settings too.

Chords

A chord is a root (A to G, with b or #) and a quality. ChordCast draws them with the quality small and raised, the way a copyist writes them.

[Chords]
| C | Cm | C7 | CM7 |
| Cm7 | Cm7b5 | Cdim7 | C7sus4 |
| C6 | C69 | Cadd9 | C+ |
| C7b9 | C7#11 | C7alt | C/E |
WriteFor
C Cm C+ CdimMajor, minor, augmented, diminished
C7 CM7 Cm7 CmM7Dominant, major and minor sevenths, minor-major seventh
Cm7b5 Cdim7Half-diminished, diminished seventh
C6 C69 C9 C11 C13 Cadd9Sixths, ninths and other extensions
Csus4 C7sus4 Csus2Suspended chords
C7b9 C7#11 C7(b9,#11) C7altAltered tensions, alone or several together
C/E and /EA chord over a bass note; /E alone changes only the bass
N.C.No chord (it's never transposed)

The spellings players actually type work too: Cmaj7 and C^7 read as CM7, C-7 as Cm7, Cø as Cm7b5, Co7 as Cdim7, C6/9 as C69. ♯ and ♭ typed as symbols are fine. A chart that uses H for B natural is read with German note names throughout. Anything that isn't a chord is kept as text, and the visual editor tells you so.

Bars and sections

WriteDraws
|A barline
||A double barline
||.A final barline
[Verse] on a line of its ownA section label. Leave a blank line before it to start the section on a new line of the chart.
./. and .//.Repeat the previous bar, or the previous two bars
,A chord-wide space inside a bar

Repeats and endings

[Verse]
||: Am7 | D7 | GM7 | CM7 |
| F#m7b5 | B7 |[1.] Em7 | Em7 :||
>| [2.] Em7 | E7 ||

[Chorus]
| Am7 | D7 | GM7 | ./. |
A repeated verse with first and second endings, then a chorus that repeats a bar.
WriteDraws
||: and :||Start and end of a repeat
:||:End one repeat and start the next
:||x3Play it three times (xX: as many times as needed)
|[1.] and | [2.]First and second endings (any text works: [2-3.])
> at the start of a lineRight-aligns a short line, which puts a second ending under the first. < left-aligns.

Rhythm

Add a length to a chord after a colon and ChordCast writes that rhythm on a staff, in rhythmic notation (slash noteheads with stems), to be played as written: hits, pushes, stops. Lines without lengths stay a plain chord grid, which tells the band to play time.

%TITLE="Rhythm figures"

[Hits]
| F7:4. F7:8 r:2 | Bb7:4. Bb7:8 r:2 |
| F7:8 F7:8 r:4 F7:4 r:4 | C7:2 Bb7:4 F7:4~ | :1 |

[Push and triplets]
| Dm7:2 G7:2 | <:8 CM7:1 |
| Dm7:4_3 Em7:4_3 FM7:4_3 G7:2 | C:1 |
Hits with rests, a tie across the barline, a push (the eighth-note anticipation) and triplets.
WriteMeans
C:1 C:2 C:4 C:8 C:16Whole, half, quarter, eighth, sixteenth
C:4. C:4..Dotted, double-dotted
C:4_3 :4_3 :4_3Quarter-note triplets (_5, _6, _7 for other tuplets)
C:4~ :4A tie to the next note, across a barline too
:4 on its ownAnother note on the same chord, without writing the chord again
<:8 C:1Push: the chord comes an eighth early, borrowed from the bar before

Every bar with lengths should add up to its time signature. The visual editor's rhythm buttons do the arithmetic for you.

Rests and time signatures

[Waltz]
| (3/4) Dm | ./. | Gm7 | A7 |

[Out]
| (4/4) Dm7 G7 | -2- | N.C. | Dm:1 ||.
A waltz, then back to 4/4 with a two-bar rest.
WriteMeans
r:4 r:2 r:8.Rests, with the same lengths as chords
-2-A rest of two whole bars (any number)
(3/4) before a chordA time signature from that bar on
[A]
| <S> C | Am7 | Dm7 | G7 <to Coda> |
| C | F | G7 | C <D.S. al Coda> |

[Coda]
| <Coda> F | G7 | C | C ||.
A segno at the top, To Coda, D.S. al Coda, and the coda.
WriteDraws
<S>Segno
<to Coda> and <Coda>To Coda, and the coda sign
<D.S.> <D.S. al Coda> <D.S. al Fine>Dal segno
<D.C.> <D.C. al Coda> <D.C. al Fine>Da capo
<Fine>Fine
<S2> <Coda2>A second segno or coda

Text and lyrics

[Intro]
| 'Drums only' N.C. | ./. | 'Band in' C | G7 |

[Verse]
| `Walk me`@ C | `down the`@ F | `road a`@ G7 | `gain`@ C |
A note above the bar, N.C., and a lyric under each chord.
WriteDraws
'Band in' CText above the bar
'Soft'@ FText above one chord
`walk me`@ CText under one chord: a lyric
"Solos"Text in place of a chord

Melody parts

A melody, a horn line or a bass riff can travel with the chart as a part in ABC notation, one line per part. You'll usually add parts with the visual editor's Parts button rather than by hand. See melody parts.

%TITLE="Night Market"
%ARTIST="ChordCast Guide"
%KEY="Dm"
%ABC_PART={"label":"Horns","bars":"A 1–4","abc":"X:1\nL:1/8\nK:Dm\nA2 d2 f2 e2 | d4 z4 | G2 B2 d2 c2 | B4 z4 |]"}

[A]
||: Dm7 | G7 | Dm7 | A7b9 |
| Dm7 | G7 | Em7b5 A7 | Dm7 :||
The chart, with a horn part for the first four bars in its %ABC_PART line. The apps and the web app draw the part below the chart.

When a chart won't draw

The text editor marks the line with the problem. The usual causes:

  • “A section name is missing its closing ]”: write [Chorus], not [Chorus.
  • “A % setting is missing its =”: write %KEY="C".
  • “A quote is never closed”: every ", ' and ` needs its partner.
  • “Two barlines meet where they can't”: often a bar after a final barline ||..
  • “It has something that isn't chart text”: a stray symbol such as ^ outside a chord.

Practise all of this hands-on in the text editor tutorial.