A handful of symbols covers almost any chart. This page lists all of them, with an example of each. The same reference is in the editor under Help (F1).

Tip: with Pro, Template… › All features in the editor puts a complete example in your text. Change it and watch the print preview follow.

Contents: Header · Bars and barlines · Rhythm · Chord symbols · Colour · Annotations · Text boxes and layout · Lyrics · Text blocks · Tabs · Chord diagrams · A complete chart · Keyboard shortcuts

Header lines go at the top of the text, one per line. Each one is optional.

You typeResult
@title: NameTitle, centred at the top
@subtitle: 12 bars, with II-V turnsSubtitle below the title
@author: NameComposer or artist, top right
@style: Medium SwingStyle, in italics top left
@key: FKey, shown next to the style. It moves along when you transpose
@tempo: 120Tempo marking
@pages: 2Minimum number of pages (handy for a fixed layout)
@transpose: +2Show and print this song 2 semitones higher (from -12 to +12). The text keeps its own key, so removing the line brings the original back. Per song; the buttons ↓♭ ↑♯ in the editor change this line
@title: Next song
@subtitle: …
A second @title: (or @subtitle:) starts the next song: a new page with its own header. The author, style, key and tempo lines below it belong to that song, so several songs fit in one file
@columns:2From this line on, two columns (also 3). Everything goes in the left column until @columnbreak; it applies until the next @columns
@columns:1Back to one column over the full width (the default)
@link: YouTube|https://youtu.be/…A link below the author: a text, a | and the address. It can be clicked in the print preview and stays clickable in a PDF saved with Print › Save as PDF. Without a text the site name is shown (youtube.com). Add as many as you like
@spotify: https://open.spotify.com/track/…A Spotify track for the Player button. Copy the link in Spotify with Share › Copy song link. Not printed
@loop: Solo 2:41-3:05A loop for the Player: a name (optional), a start and an end. Add as many as you like

Several songs in one file, for example a set list: start every song with its own header. Each @title: after the first one begins a new page; transposing moves the key of every song.

@title: First song
@key: F
| F | Bb | C7 | F |b

@title: Second song
@author: Someone
@key: G
| G | C | D7 | G |b

Bars and barlines

A row of bars is one line of text. Bars are separated by |; a row usually holds four bars.

You typeResult
| C | Am | F G |Bars separated by |. Several chords in one bar share it
|bEnd of a row with a small space after it (layout only)
|bbEnd of a row with a large space after it (layout only)
| F | G 2|Double barline: the end of a section or a change of key or time. The music goes on
| C | C 3|Final barline (thin–thick): the end of the piece, also at Fine
4| C | Am |Repeat start: the repeated part starts here
| Dm | G7 5|Repeat end: back to 4| (or to the beginning) and play again
2|b
3|bb
5|b
A barline and the end of the row together, for example 2|b = end of a section and a new row
| C | % |% repeats the previous bar
| C , G , |A comma is a slash: a beat without a new chord
| N.C. | C |N.C. = no chord
| C "quietly" G |A note between the chords, in quotes: printed as plain text and not transposed
| C | @empty |An invisible bar that keeps its width
| C | G | @empty | @empty |bTwo bars that take a quarter of the width each. Put the @empty bars first to align the bars to the right
| @time:3/4 C | G |Time signature. At the start of the bar it goes left, at the end it goes right
| C {4 4 88 4} |Rhythm notation below the chords, see Rhythm
| Am7~12 |Move a chord 12 pixels to the right (also with Alt+← / Alt+→)

Rhythm

Write the rhythm of a bar between { }, after the chords. It is drawn as notes below the chords, in the time signature of that bar (@time:, 4/4 by default). Separate the values with spaces (or +).

You typeResult
| C {4 4 4 4} |Four quarter notes. The values: 1 whole, 2 half, 4 quarter, 8 eighth, 16 sixteenth, 32 thirty-second
| C {2 2} |Two half notes
| C {88 88 88 88} |Values written together get a beam: here four pairs of eighths
| C {4 r4 4 r4} |r = rest: r4 is a quarter rest, r8 an eighth rest
| C {4. 8 2} |A dot after a value makes it dotted: 4. is a dotted quarter
| C {3(888) 4 2} |Triplet: three eighths in the time of two. Also 5(…) and 6(…)
| C {2t 4 4} |t = a tie to the next note
| C G {2 2} |Chords and rhythm are separate: two chords above two half notes
| @time:6/8 C {888 888} |In another time signature, the rhythm follows @time:
| C {4 4 4 4} | C {88 88 88 88} | C {4. 8 2} | C {3(888) 4 2} |b

Chord symbols

Type chords the way you would write them. The editor prints them in jazz style or as text, depending on the setting Chord notation (⚙ Settings).

You typeResult
Cmaj7
C^7
CΔ
Major seventh (△, or maj7 in text style)
Cm7
C-7
Cmin7
Minor. Printed with m or – (a setting)
Cdim
Co7
Diminished (°)
Cm7b5
Cø
Half-diminished (ø)
C7b9
C7#11
C13
Tensions in superscript, with ♭ and ♯
C7alt
Csus4
Cadd9
C+
Altered, suspended, added note, augmented
D/F#Slash chord (a chord over another bass note)
c
bb
f#m
The root is not case-sensitive

Colour

Give a chord, a rehearsal mark or a label its own colour with !g (green), !r (red), !b (blue) or !z (black), right after it. The default colour of all chords is a setting.

You typeResult
| C!g | G7!r |
| Am!b | F!z |
A chord in green, red, blue or black
[C!g]text [G7!r]textAlso in a lyrics block
@diagrams: C!g G7!rAlso for the names above chord diagrams
| G7~10!r |Together with moving; the order does not matter (G7!r~10 works too)
|@mrk:*Chorus*!b F |A rehearsal mark: the box gets the colour
@box: [Intro]!g textThe label of a text box

Annotations

Annotations go inside a bar, before the chords.

You typeResult
|@mrk:*A* C | G |Rehearsal mark in a box
| @txtL:*text* C |Text above the bar, on the left. @txtC centres it, @txtR puts it on the right
@txtL:*/segno*
@txtR:*/coda*
@txtC:*/fermata*
Music symbols: segno, coda, fermata
@txtR:*/dc al /fine*
@txtR:*/ds al /coda*
@txtR:*/tocoda*
D.C. al Fine, D.S. al Coda, To Coda
| @txtL:*[1]* Dm | G7 5|
| @txtL:*[2]* C |
First and second ending, with a bracket over the bars

Text boxes and layout

You typeResult
@box: [Intro] textA text box with a label. The next lines belong to it, up to an empty line, a comment, a line with @ or a row of bars
@box: [A] [B]!r [C] [D]Several labels on one line: a row of boxes, each with its own colour
@spaceVertical space
@pagebreakStart a new page
@columnbreakGo to the next column (after @columns:2). In the last column, or without columns, it starts a new page
// commentA comment: only in the editor, not printed. For a note that is printed, use "…" in a bar

Lyrics

You typeResult
@lyrics: Verse 1Start of a lyrics block (the title is optional)
[C]Here starts the [Am]lineA chord between [ ] goes above the word after it, and moves along when you transpose
@endlyricsEnd of the lyrics block. An empty line inside the block = space between verses
@lyr: textReference text below the row of bars directly above it. Several @lyr: lines give several lines of text

The font and size of the lyrics are settings. Songs with the chords above the lyrics, as on Ultimate Guitar, can be converted with File › Import from Ultimate Guitar… (Pro).

@lyrics: Verse 1
[C]Morning light upon [G]the water,
[Am]every street is [F]waking slow
@endlyrics

Text blocks

For text without chords, such as the words of a song, notes for the band or an explanation, use a text block. It is printed exactly as you type it, in Inter 14px.

You typeResult
@textblock: NotesStart of a text block. The title is optional and is shown in a box
Any textPrinted as typed: spaces are kept, an empty line gives space, long lines wrap
@endtextblockEnd of the text block
@textblock: Notes @size:*16*Another font size (px) for this block
@textblock: Notes
Intro: drums alone for 4 bars, then everyone.
Last chorus twice, end on the downbeat.
@endtextblock

File › Import from Ultimate Guitar… (Pro) can make text blocks too: choose Lyrics only, without chords. All chords are removed and every section (Intro, Verse, Chorus …) becomes a text block with its name as the title.

Tabs

You typeResult
@staff
@gtab
@btab
An empty staff, guitar tab (6 strings) or bass tab (4 strings), to fill in by hand on paper
E|---3---5---|ASCII tab: lines that start with a string name and | are drawn as tablature: string lines, the fret numbers on the line, bar lines and a TAB clef
@tab … @endtabAn ASCII tab block. Chord names and counts above the tab stay above their column
5h7 7p5Hammer-on and pull-off: an arc from note to note
5/7 7\5Slide up or down: a slanting line
7b9Bend: an arrow up with the target fret
7~~~Vibrato: a wavy line
xA dead note: a cross
@tab @size:*12* @spacing:*1.0*Size (px) and line spacing for this block. The defaults are settings
@tab @style:*text*Print this block as text in a monospace font. For all tabs: the setting Tab display
@tab
e|-----------------|-----------------|
B|-----------------|-----------------|
G|-----------------|-----------------|
D|-----2--------2--|-----------------|
A|-----2-----5--2--|--0--------------|
E|--0-----3--------|-----3--5--------|
@endtab

With a Pro account, Edit tab in the toolbar opens the @tab block at the cursor in a visual tab editor.

Chord diagrams

A row of guitar chord diagrams (standard tuning), with the chord name above each one. The row wraps onto a next line when it is longer than the page:

@diagrams: C Am7 F@8 D7@10 Bb(x-13-15-15-15-13)
You typeResult
@diagrams: C G Am FThe most common shape of each chord
F@8The shape that starts closest to fret 8, here the barre chord; the diagram shows 8fr
D7(x5453x)Your own fingering, low E first: x = muted, 0 = open, one character per string
Bb(x-13-15-15-15-13)With dashes between the strings when a fret is above 9
G#m11(224422)@4Move your own shape along the neck: its lowest fret goes to fret 4 and the diagram starts there, with 4 next to the barre. Transposing only moves the @4
A(x02220:x01110)Fingers after the colon; the same finger on several strings is a barre
@diagrams @size:*70*: C GAnother width (px) for this row. The default size and the finger numbers are settings
F!r@8Chord colours work here too

Chords with a diagram

Every root (C, C# / Db … B) with these chord types has one or more shapes in the chord database. Write them as in the chart; the examples are in C:

You typeChord types
C Cm C-
Cdim Co Caug C+
Csus2 Csus4 Csus
Triads: major, minor, diminished, augmented, suspended
C6 Cm6 C7 Cmaj7 CΔ
Cm7 C-7 Cm7b5 Cø
Cdim7 Co7 C7sus4 Cm(maj7)
Sixths and sevenths
C6/9 Cm6/9 C9 Cm9 Cmaj9
C11 Cm11 Cmaj11 C13 Cmaj13
Cadd9 Cmadd9
Extensions and added notes
C7b5 C7b9 C7#9 C9b5 C9#11
C+7 C7#5 Caug9 C7alt
Cmaj7b5 Cmaj7#5 Cmmaj7b5 Cmmaj9 Cmmaj11
Altered chords
C/E C/G Am/C …Slash chords: their own shape when the database has one, otherwise the shape of the chord itself
C5(x355xx) C7#11(x3435x)Chord types without a shape in the database (power chords, C7#11, C13b9 …): give the fingering

A barre in your own fingering is found by itself: the lowest sounding string is on the lowest fret, at least one other string is on that fret, and no string in between is open or muted. Transposing moves the diagrams along. A chord that is not in the chord database and has no fingering gets an empty frame with a question mark and a note in the error list.

A complete chart

Header, sections, a repeat with endings, a text box and lyrics together:

@title: Jazz Blues in F
@subtitle: 12 bars, with II-V turns
@author: Rick Spaan
@style: Medium Swing
@key: F

4|@mrk:*Head* @time:4/4 F7 | Bb7 | F7 | Cm7 F7 |b
| Bb7 | Bdim7 | F7 | Am7b5 D7b9 |b
| Gm7 | C7 | F7 D7 | Gm7 C7 5|bb

@box: [Form] head 2x, solos over the same chart, then head 2x

|@mrk:*Ending* Gm7 | C7 | F6 , , @txtR:*/fermata* 3| @empty |bb

@lyrics: Verse
[F7]Walking down the avenue, [Bb7]nothing on my mind
@endlyrics

More complete charts are on the examples page.

Keyboard shortcuts

KeysAction
Ctrl+EnterRefresh the preview
Ctrl+SSave: in My songs with a Pro account, otherwise as a .txt file
Ctrl+Shift+SSave as… in My songs: a copy under another name or in another category
Ctrl+OOpen a .txt file
Ctrl+PPrint, or save as PDF
F1Open the notation help in the editor
Alt+↑ / Alt+↓Move the current line (or the selection) up or down
Shift+Alt+↑ / Shift+Alt+↓Copy the current line (or the selection) up or down
Alt+← / Alt+→Move the selected chords
Click a chordSelect it (several are possible); a double-click jumps to it in the text
Double-click a blockGo to it in the text: a text block, lyrics, text box, tab, chord diagrams or a row of bars
Click an ASCII tabOpen it in the tab editor (Pro)
EscClear the selection

The shortcuts of the practice player are on the help page.

Write your first chart before the next rehearsal

Open the editor, start from an example and make it your own.