ChordPro Format Support

Setlist Helper supports ChordPro format (also known as Chopro format). Below are the supported directives.

If your lyrics have the chords written on the line above the words, you do not need to retype them. Open the song in your Song Catalog, click "View Lyrics or Add Lyrics", and use the Convert to ChordPro button to convert them in place.

There is also a free online converter at bandcentral.com/tools/chordpro-converter. Paste in chords-over-lyrics text, for example from a tab site, and it gives you back clean ChordPro. No account is needed.

The directives listed below are wrapped in curly braces ({ and }). Upper or lower case is not significant:

{title: title string} ({t:string})

Title of the song.

{subtitle: subtitle string} ({su:string})

Specifies a subtitle for the song that will be displayed below the title.

{key: x}

The key of the song.

{tempo: x}

The tempo of the song.

{start_of_chorus} ({soc})

Indicates the start of a chorus. This will show "Chorus" in bold, indent the chorus, and add a black line to the left of the chorus so it can be identified more easily.

{end_of_chorus} ({eoc})

Marks the end of a chorus.

{comment: string} ({c:string})

Shows the string following the colon as a comment. Do not confuse this with the # sign comment. Lines starting with # are not shown.

{pause:xx}

Used to pause auto-scroll in the app. Replace xx with seconds or minutes.

{pagebreak}

This is only for the www.setlisthelper.com website. Add the {pagebreak} tag to your lyrics to make the printer go to a new page when printing.

{start_of_tab} ({sot})

Indicates the start of a guitar tab section. The text will be formatted in a fixed-width font until the end_of_tab directive appears. This can be useful for creating a tab drawing with ASCII text.

{end_of_tab} ({eot})

Indicates the end of the guitar tab section.

{soh}

Start highlighting a line of lyrics.

{eoh}

End highlighting lyrics.

Chords

Chords are delimited by square brackets ([ and ]). Sharp is indicated by a # (hash) and flat by a b (lowercase B). Recognized chord forms:

[A-G]{#|b}{m|dim|maj|sus}{digit}{/[A-G]{#|b}}

Examples: [A] [C#m7] [Bb/D]

Chord Grids

Chord grids are not supported yet. If this is something you would like to have supported, please email tim@setlisthelper.com.

Comments in the File

Lines in the file that have # as the first character are considered comments and will never be printed.

Example

{t:Honky Tonk Women}
{st:Rolling Stones}
#HONKY TONK WOMEN ROLLING STONES
#
#
I [C]met a gin soaked barroom queen in [F]Memphis,
she tr[C]ied to take me upstairs for a r[G]ide.
She h[C]ad to heave me right across her sh[F]oulder,
cause [C]I just can't seem to dr[G]ink you off my m[C]ind.

It's the H[G]onky Tonk W[C]omen,
give me, give me, g[G]ive me the honky tonk bl[C]ues.