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 | - 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 | | Line | What 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 | | Write | For |
|---|---|
C Cm C+ Cdim | Major, minor, augmented, diminished |
C7 CM7 Cm7 CmM7 | Dominant, major and minor sevenths, minor-major seventh |
Cm7b5 Cdim7 | Half-diminished, diminished seventh |
C6 C69 C9 C11 C13 Cadd9 | Sixths, ninths and other extensions |
Csus4 C7sus4 Csus2 | Suspended chords |
C7b9 C7#11 C7(b9,#11) C7alt | Altered tensions, alone or several together |
C/E and /E | A 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
| Write | Draws |
|---|---|
| | A barline |
|| | A double barline |
||. | A final barline |
[Verse] on a line of its own | A 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 | ./. | | Write | Draws |
|---|---|
||: and :|| | Start and end of a repeat |
:||: | End one repeat and start the next |
:||x3 | Play 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 line | Right-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 | | Write | Means |
|---|---|
C:1 C:2 C:4 C:8 C:16 | Whole, half, quarter, eighth, sixteenth |
C:4. C:4.. | Dotted, double-dotted |
C:4_3 :4_3 :4_3 | Quarter-note triplets (_5, _6, _7 for other tuplets) |
C:4~ :4 | A tie to the next note, across a barline too |
:4 on its own | Another note on the same chord, without writing the chord again |
<:8 C:1 | Push: 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 ||. | Write | Means |
|---|---|
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 chord | A time signature from that bar on |
Codas and signs
[A]
| <S> C | Am7 | Dm7 | G7 <to Coda> |
| C | F | G7 | C <D.S. al Coda> |
[Coda]
| <Coda> F | G7 | C | C ||. | Write | Draws |
|---|---|
<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 | | Write | Draws |
|---|---|
'Band in' C | Text above the bar |
'Soft'@ F | Text above one chord |
`walk me`@ C | Text 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 :|| 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.