Text File Handlin'

Arrr, when OnSong imports certain files, it may need t' be given a hint t' th' file encodin' or format, matey! Text File Handlin' settin's help OnSong know how t' handle certain files it encounters, savvy?

Fallback File Extension

OnSong uses th' file extension o' a file t' determine its file format, Ahoy! 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, ye scallywag.

In most cases files have a file extension. OpenSong files tend t' be extension-less but be really XML-formatted files. For 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, Blimey!

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

File Encodin'

Text encodin' be th' process o' convertin' characters in a written language into binary values that can be stored by a computer, Arrr! 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, savvy?
• 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, Avast! 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!