Plain text files

A plain text song is typically a .txt file where the chords sit on their own line above the lyrics. Most chord charts on the web are written in this format, and text you drag from a web page into SongSheet Pro is read the same way. If a file marks its chords inside the lyrics with square brackets, such as A[D]mazing, it is a ChordPro file instead, which can hold more details than plain text.

SongSheet Pro reads a plain text file one line at a time and builds the song from the result. This page explains how it identifies each type of line, so you can write or tidy a file that imports the way you want. To import a file, see Adding songs. Then review the import to check that it has been read correctly.

A simple example

Most plain text songs need very little. This file has a title, an artist and one stanza:

Amazing Grace
John Newton

Verse 1:
 D                  G         D
Amazing grace! (how sweet the sound)

The first two lines are the title and the artist. Verse 1: names the stanza, the next line holds the chords, and the line below that is the lyrics. Each chord is placed above the part of the lyrics where it should be played.

The rest of this page covers the extra details you can add, and the exact rules SongSheet Pro uses to recognize each kind of line.

How SongSheet Pro reads a file

SongSheet Pro looks at each line and assigns it a type: title, artist, key, capo, tempo, time signature, copyright, stanza name, lyric line, chords, or blank line.

Most song details are recognized by an English label, such as Key or Capo. The label is not case-sensitive. A label in another language, for example Capotraste, is read as lyrics, not as a capo.

A plain text file is typically laid out with the title and artist at the top, followed by other song details such as the key. Then comes the song content, split into stanzas containing chords and lyric lines. The copyright line often sits at the end of the file.

Song details

Put each song detail on its own line. These can appear anywhere in the file, but typically you’d put the title and artist first, followed by other song details such as the key or time signature. If the same detail appears more than once, only the last one is used.

A few song details are recognized without a label, such as 4/4 or © 2023 Some Music. The sections below show the forms SongSheet Pro recognizes. Each form must make up the entire line: extra words after a key, capo, tempo or time signature make the line lyrics. SongSheet Pro only reads the song details described here: if you want to import composer, lyricist, arranger, CCLI number, year, duration, tags or notes, use a ChordPro file instead.

Title and artist

Label the title and the artist with Title and Artist lines. These are the accepted forms:

  • Title: Title: Amazing Grace or Title Amazing Grace
  • Artist: Artist: John Newton, Artist John Newton or By: John Newton (By: needs the colon)

This is the most reliable way. If you don’t label them, SongSheet Pro guesses them from the first two lines of text, skipping blank lines. A wrong guess can be corrected when you review the import.

These are the common layouts and what SongSheet Pro makes of them:

The file starts with Title Artist
Amazing Grace
John Newton
blank line
Amazing Grace John Newton
Amazing Grace
By John Newton
Amazing Grace John Newton
Amazing Grace
Key: D
Amazing Grace None
Amazing Grace
blank line
John Newton
Verse 1:
Amazing Grace John Newton

When the first line is lyrics, SongSheet Pro guesses the title and artist using these rules:

  • If the second line is By followed by one to three words that each start with a capital letter, such as By John Newton, the first line becomes the title and the name becomes the artist. A line such as By your side, or one where the first word after By is a common word such as My or All, doesn’t count as a By line, but the rules below can still make it the artist.
  • If the second line is not lyrics, for example a key, capo, tempo, or time signature, a stanza name, or chords, the first line becomes the title.
  • If the first two lines are both lyrics, are next to each other and are followed by a blank line or any other line that is not lyrics, they become the title and the artist.
  • If a blank line separates the first two lines, the first line becomes the title when the second line is followed by more lyrics, and they become the title and the artist when the second line is followed by a line that is neither lyrics nor blank. When the second line is followed by another blank line, neither is guessed.

When the first line is a Title line, the second line becomes the artist if it is lyrics and either is a By line like the one above or is followed by a blank line or any other line that is not lyrics. When the first line is anything else, such as chords or a stanza name, nothing is guessed. If no title is found, the file name is used.

Key

Write Key, then the note, separated by a space, a colon, an equals sign, of or of:. The note is A to G, optionally followed by #, ♯, b or ♭, then optionally by m, min, minor, maj or major, with or without a space before it.

Key: G · key a · Key of Am · Key of: B♭ maj · Key = Bb minor · Key=G · Key C major · Key: F♯m

Not recognized: Am (no label) and Key: Am7 (extensions).

Capo

Write Capo, an optional colon, then a number from -1 to 11.

Capo 2 · Capo: 2 · Capo:2 · Capo -1

Not recognized: Capo2 and Capo=2.

Tempo

Write a whole number with bpm after it, or put Tempo or bpm before it, with an optional colon or equals sign. You can also use both, as in Tempo 120 bpm.

120 bpm · 120BPM · Tempo 120 · Tempo: 120 · Tempo=120 · Tempo 120 bpm · bpm 120 · BPM: 120 · bpm=120

Not recognized: a number on its own, a decimal and Tempo120.

Time signature

Write two whole numbers with a slash between them, and nothing else on the line.

4/4 · 6/8 · 5/16 · 7/4

Not recognized: Time: 3/4 and 3 / 4. A lyric line that is only 1/2 is read as a time signature too. If that happens, change it to Lyrics when you review the import.

Start the line with Copyright and a space or colon, with ©, or with (c) and a space. The whole line is kept, including the word Copyright.

Copyright 2023 Some Music · Copyright: 2023 Some Music · © 2023 Some Music · ©2023 Some Music · (c) 2023 Some Music (the (c) imports as ©)

Not recognized: (c)2023 and a bare Copyright.

Song content

A song contains stanzas, containing lines recognized as lyrics or chords.

Stanza names

A stanza name is a line on its own that starts a new stanza. SongSheet Pro shows it with a capital letter and without the colon, brackets or parentheses, so VERSE 1: becomes Verse 1. A name is recognized in any of these forms:

Form Examples Becomes
Any name of one or two words, followed by a colon or a closing square bracket (]). This is the general case Solo:
Tag 2:
[Interlude]
Solo
Tag 2
Interlude
verse, chorus, refrain, bridge, intro or outro, with an optional number. No colon or brackets are needed, but a colon, square brackets or parentheses are accepted Verse 1
Chorus
Verse 2:
(Bridge)
Verse 1
Chorus
Verse 2
Bridge
A short form of those: v, ch, ref, br, in or out, with an optional number and the same colon, brackets or parentheses V1
Ch 2
[Ref]
Out:
Verse 1
Chorus 2
Refrain
Outro

A name that doesn’t fit these forms is read as lyrics. That includes a name with no colon (Solo), three or more words, a hyphen or other punctuation (Pre-Chorus:, Verse 1 (repeat):), and extra text after the name (Chorus x2). Parentheses work only with the words in the last two rows: (Solo) is read as lyrics. Because the short forms are recognized, a lyric line that is only In, Out or V is read as a stanza name too, wherever it appears, and it starts a new stanza. If that happens, change the line to Lyrics when you review the import.

A stanza doesn’t need a name. A blank line ends a stanza, and the next lyric line starts a new unnamed stanza unless a stanza name comes first.

Chords

Chords go on their own line, not inside the lyrics. They usually sit directly above the lyric line they belong to, but a chord line can also stand alone as an instrumental with no words.

SongSheet Pro is particular about what counts as a chord line. If a line is not detected as chords, check that:

  • Every item on the line is a chord or a chord symbol. D, Gmin, Asus4, F#m7 and C/G are chords. %, N.C. and the separators |, - and / are also allowed, so | G | C | and G - C are chord lines. One word that is not a chord, such as x2 or a note to yourself, makes the whole line lyrics. Put notes like that on a line of their own.
  • The note names are capital letters. Write A to G in capitals.

Once a line is read as chords:

  • Spacing sets the position. Each chord is placed over the lyric character that is in the same column, so use spaces to align each chord with the lyrics. Tabs are converted to spaces first.
  • A chord line with no lyrics under it stays a line of chords. This is how an instrumental line is kept. It happens when the next line is blank, a stanza name, another line of chords or a song detail line, or when the chords are at the end of the file.

The reverse can also happen: a lyric line that holds only A, Am, Em or A D is read as chords, because SongSheet Pro can’t tell the difference. When you review the import, change the line to Lyrics.

Chords in square brackets belong to a different format. If a file contains a chord in square brackets, such as [Am] or [G7], or starts with { as its very first character, SongSheet Pro treats it as ChordPro instead of plain text. Stanza names in brackets, such as [Chorus] and [Verse 1], don’t have this effect.

Lyric lines

Every line that is not one of the types above is lyrics, including a line that starts with #. Plain text has no comments, so every line is imported.

File types

SongSheet Pro opens plain text files that end in .txt or .text. Each plain text file imports as a single song.

A full example

Here is a longer file, the first two verses of the same hymn, that uses every kind of line. It shows how the pieces from the sections above fit together:

Title: Amazing Grace
Artist: John Newton
Key: D
Capo: 2
Tempo: 90
3/4

Verse 1:
 D      D7          G         D
Amazing grace! (how sweet the sound)
             E           A
That saved a wretch like me!
  D        D7        G      D
I once was lost, but now am found;
    Bm         A     D
Was blind, but now I see.

Verse 2:
'Twas grace that taught my heart to fear,
And grace my fears relieved;
How precious did that grace appear
The hour I first believed.

Copyright: Public domain
  • Title: and Artist: label the title and the artist.
  • Key: D, Capo: 2, Tempo: 90, 3/4 and the copyright line are song details.
  • Verse 1: and Verse 2: are stanza names, and the blank line before Verse 2: ends the first stanza.
  • The lines such as D D7 G D hold the chords. Each chord sits over the lyric character in the same column, so the first D is over the m of Amazing.
  • The remaining non-blank lines are lyrics.

To try importing plain text, drag and drop the full example into SongSheet Pro, then review the import.

Reviewing the import

When you import a single file, or drop text onto your library, SongSheet Pro shows a preview on the Import Song screen before it adds the song. Look through the preview for lines that were read as the wrong type, such as a stanza name shown as lyrics or a title that is really a lyric. If you select or drag several files at once, there is no preview for each song. SongSheet Pro opens one import window for all of them instead, where you choose what to do with songs already in your library, and it skips any file it can’t read. See Adding songs.

Plain text import preview showing the parsed song with chords above lyrics before importing

If a line is wrong, you can change it to the type it should have, for example from chords to lyrics. To change a line’s type:

  1. Tap Line Types or swipe left.
  2. Tap the line, then choose the type from the list on the right. To remove the line from the song, choose Ignore this line.
  3. Tap Preview to return to the song preview.
Line Types view with each line labeled as title, chords, lyrics or stanza name

The list has three groups:

  • Song Metadata: Song title, Artist, Key, Capo, Time signature, Tempo and Copyright.
  • Song Content: Stanza name, Chords and Lyrics.
  • Other: Blank line and Ignore this line.

Only the types that make sense for the line can be chosen, and the choices depend on the type SongSheet Pro detected. To undo a change, choose the line’s original type again. A lyric line can’t be changed to a key, capo, tempo or time signature by hand: write it in one of the forms in Song details instead and import the file again.

Changes apply only to the song you are importing, and the file is not changed. Choosing Song title, Artist, Copyright or Stanza name keeps the whole line, including any label such as Title:. For a stanza name, only the spaces at either end are removed, so a colon stays in the name. If you change a line to Chords, SongSheet Pro places its chords over the lyric line below by column, and doesn’t check that they are real chords.

Once you are happy with the import, tap Import in the top-right to add the song to your library. Tap Cancel in the top-left to dismiss the import view without importing the song.

Last updated: November 9, 2026