Text File Handlin'

When OnSong imports certain files, it may need t' be given a hint t' th' file encodin' or format. Avast, ye! Text File Handlin' settin's help OnSong know how t' handle certain files it encounters.

Acquire Song Number from Title

When a song be imported that has a title that starts with a number followed by a period, OnSong can acquire th' number as th' song number fer proper sortin' and searchin'.

ChordPro Compatibility Processin'

ChordPro be a syntax and not a standard file format. Because o' this, different vendors have used features o' ChordPro in different ways, savvy? This option processes ChordPro t' make it as future compatible as possible by convertin' commented section labels into real sections, fer instance.

Convert Smart Quotes

This option will attempt t' convert incompatible smart quote characters into compatible versions, matey.

Detect Chords In Lyrics

OnSong uses text-based song content t' render chord charts on th' screen. Both OnSong and ChordPro file formats denote chord in square brackets within lyrics. However, most chord charts be available with chords on a separate line above lyrics. When this option be turned on, OnSong detected chords over lyrics and places th' chords with lyrics automatically. Default be on.

Detect Key By

If th' key o' th' song be not explicitly declared in th' song's metadata, OnSong will need t' find th' key in another way t' enable transposition, Arrr! OnSong detects th' key usin' one o' th' followin' methods:

• First Chord uses th' first chord in th' song as a basis fer th' key. Fer instance, if th' first chord be Am7, then th' key o' th' song be set t' Am. Default.
• Last Chord uses th' last chord in th' song as a basis fer th' key. Fer instance, if th' last chord in th' song be a Bbsus4, th' key will be set t' Bb.
• Note Counts be a method o' determinin' th' key o' th' song by accumulatin' all th' notes used by th' chords in th' song and then countin' sharps and flats t' determine th' key. This can be more accurate than th' first or last chord in th' song, but can still be false if not enough chords be in th' song.
• Metadata Only will only use th' metadata o' th' song fer th' basis o' th' key. That means that if th' key be not declared, transposition will not be available, ye scallywag.

Fallback File Extension

OnSong uses th' file extension o' a file t' determine its file format. This be important durin' th' import process so that text conversion can occur t' a supported internal format, or so external files like PDF can be viewed correctly, Blimey!

In most cases files have a file extension. OpenSong files tend t' be extension-less but be really XML-formatted files. Fer this reason, OnSong will automatically append a .xml file extension t' files that have no extension. This identifies th' file as an OpenSong file and converts it appropriately.

If ye have many files that have no extension, and th' type o' th' file be known, enter th' file extension in this place.

File Encodin'

Text encodin' be th' process o' convertin' characters in a written language into binary values that can be stored by a computer. OnSong be designed t' guess th' file encodin' o' a file, but there be some occasions where th' file encodin' be not known. Th' default settin' fer this be Auto meanin' th' encodin' be guessed. If ye know th' encodin' o' th' file, select it from one o' th' options:

• Auto detects th' encodin' based on th' contents o' th' file. Default.
• ASCII be a basic text encodin' that covers most western character sets.
• UTF-8 be a superset o' ASCII which contains most characters found through th' world, but does not include some characters such as those found in Asian languages. OnSong uses UTF-8 internally and stores larger character sets in a way that makes them retrievable.
• UTF-16 uses 16-bit values fer definin' th' character set allowin' fer 32,768 possible characters.
• UTF-32 uses 32-bit values fer definin' th' character set allowin' fer 2 billion possible characters.
• ISO-Latin or better known as its codepage "iOS-8859-1". It be similar t' UTF-8 and holds Latin-based characters.

Text File Conversion

When text files be imported, OnSong can automatically translate them in th' OnSong file format. This places chords into square brackets automatically. Since OnSong can now automatically handle chords over lyrics in th' song viewer, this be set t' Text by default. Ye can still have OnSong convert yer songs automatically by choosin' OnSong instead, matey!