Writing in the song editor

The song editor colors your chord sheet as you type and writes the brackets and braces for you. The Sections and Directives rail, the slash menu, Tab between fields, and Expand.

The editor is where you write a song, in either of Fretlist's two formats. It colors the sheet as you type and can write the syntax for you, so your attention stays on the words and the chords instead of on where a brace goes.

For the formats themselves, see Chords over Lyrics and ChordPro.

Colors as you type

Everything you write is colored as you go:

Chords take your chosen chord color, whether they sit inline like [C#m] or bare on a chord line. The chord name in a {define: ...} takes it too, since that is the part you scan the line for.
Section headings and directives are teal, so the shape of the song stands out from its words.
Bracketed text that is not a chord, like [x4], [N.C.] or [*Break], is an annotation: italic, in the lyric color.
Lyrics stay in the normal text color, and so does the fret data in a definition.

The brackets are not what decides the color. Whether the text names a chord is.

These are the same colors the finished chord sheet uses, so a song looks the same while you write it as it does when you play it.

A ChordPro song in the editor: a define line whose chord name is amber and whose fret data is dim, teal grid and verse directives, amber inline chords, an italic [*Break] annotation, and plain lyrics — Chords, directives, annotations and lyrics each take their own tone.

The Sections and Directives rail

Above the writing area is a row of buttons that insert syntax at the cursor, so you never have to remember how a directive is spelled.

The first chips are section headings, and Fretlist puts the ones this song already uses first, so a song with three verses keeps Verse within reach. The full set is Intro, Verse, Pre-Chorus, Chorus, Bridge, Instrumental, Interlude, Solo and Outro, and the Section chip opens all of them with a search box.

After those come the things you can drop into a song:

Chord: an inline [ ] chord, ready to type into
Chord line: a chord line above the lyric you are on
Chords table: a [Chords] block for chord diagrams
Chord definition: a {define: ...} for a custom voicing
Comment: a comment line
Note: a performance note
Chord grid: a grid block, named and ready to fill
Repeat bars: repeat marks inside a grid
Tab block: a tab staff
Repeat chorus: a reference back to the chorus you already wrote

Which of these show as chips depends on the song and the format you are in. The Directive chip opens the full list, and every chip has a tooltip saying what it writes. On a wide window the rail ends with a quiet or type / reminder.

The rail wants a wide window. It appears from desktop widths up, and is off on phones and narrow tablets where the keyboard wants the bottom of the screen.

The rail above the editor: Verse and Chorus section chips, a Section dropdown, a divider, a Comment directive chip, a Directive dropdown, and an or type slash reminder at the end — Section chips first, then directives. The Section and Directive chips open the full lists.

The section picker open below the Section chip in the rail, with a Search sections box above all nine section names laid out in two columns — The Section chip opens every section name, with a search box.

On a computer with a mouse or trackpad you can insert the same things without leaving the keyboard. Type / as the first character on a line and a menu opens, grouped into Sections and Directives. Keep typing to narrow it.

↑ ↓ move through the list
↵ inserts the highlighted item
Esc closes the menu

Every row shows the text it will write, so you can see what you are about to insert before you commit to it.

The slash only counts at the start of a line. Anywhere else it is just a slash, so a chord like G/B never opens the menu by accident. On an empty line the editor shows a faint Press / to add as a reminder.

The slash menu open under a typed slash, listing the sections with the text each one inserts on the right, Interlude highlighted, the Directives group below, and a keyboard hint and match count along the bottom — Each row shows what it will write. The count at the bottom right tracks the matches.

Tab moves between fields

Tab is navigation in the editor rather than indentation, and it does whatever is most useful where the cursor is.

On a chord line, Tab jumps to the start of the next word in the lyric below, padding the chord line out if it is shorter than that column. Shift Tab goes back. Placing the second chord costs the same as the first.

On a chord definition, Tab walks the fields in order: the chord name, the base fret, then each fret. Each one arrives selected, so filling in a voicing is Tab, type, Tab, type.

A definition you insert is not blank. Fretlist looks at which chords the song plays, picks one that has no shape yet, and fills in the usual fingering for it. The chord name comes back selected, because that is the one part it had to guess.

In a chord grid, Tab tours the block in reading order: the name first, then every cell of every row, each selected so typing replaces it. Tab past the last cell parks the cursor at the end of the block. Shift Tab walks back the same way.

Expand

Expand hides the title, artist and details rows and gives that space to your lyrics. Expanded, those rows fold into one line that still says which song you are in. Click that line to bring them back, or use the Close button where Expand was.

Press F in an editor to fold the sidebar away for more room still, and F again to bring it back.

The editor expanded: title, artist, key and capo folded into one summary line above the Lyrics and Chords header, with the CoL and ChordPro tabs and a Close button where Expand was — Expanded, the metadata rows fold into one line that still names the song.

Expand is a desktop control. On a phone the field is already the screen.

Two formats, one song

The tabs above the field switch between Chords over Lyrics and ChordPro. The first shows as CoL when the row is too narrow for its full name.

Switching converts the song, and the lines you did not touch come back exactly as you wrote them. A heading typed as Verse: stays Verse:, and one written as = Chorus stays that way too, rather than being rewritten into a form you did not choose.

On a phone

The phone editor is the field. It scrolls like any other page and the keyboard slides over it. The Song Details bar tucks away as you scroll down and comes back as you scroll up, and tapping into the lyrics puts it away until you are done writing. Tapping the song name drops a panel from the top bar for the title and artist, and the CoL / ChordPro switcher rides the corner of the field so the format is always one tap away.

The rail and the slash menu are off here.