Advanced

Th' debug section in settings be used t' correct issues that may occur when usin' OnSong. Th' followin' be switches that inform OnSong t' perform certain functions when it starts up. Let's take a gander at these options and how they may help get ye out o' a jam, savvy?

Backup Media Files

By default, all media files such as audio backin' tracks and background images or video, be placed inside o' th' backup file. This can result in large backups that be difficult t' manage. Turn this option off t' prevent media files from bein' placed into th' backup file.

When ye restore a library that doesn't contain media files, ye OnSong keeps th' records o' that media but needs t' reestablish th' underlyin' media files. If ye import files o' th' same filename, OnSong will reestablish th' media record.

Clear Temporary Files

Turnin' on this option will clear temporary files when th' app be placed into th' background. This may be used if ye be runnin' out o' storage space on yer device. This be not recommended t' be used otherwise as it will affect performance and temporary files be cleared automatically by iOS when needed.

Forget Last Song

This be th' most important debug settin' t' keep in mind. If ye import a song that has incompatible content or be too large it may cause OnSong t' crash. Because OnSong remembers th' last song ye had viewed, this can cause a crash loop. In that case, open th' Settings app on yer device and turn on this settin'. Th' next time ye start OnSong, th' last known song will be forgotten and th' demo song will be viewed instead. This allows ye t' get back into OnSong and delete th' offendin' file.

Purge Database

Turnin' on this function will instruct OnSong t' delete yer current library and start over. When OnSong purges th' database, it jettisons th' library as a backup so ye can restore it later.

Reset Help File

In some cases, th' help file in OnSong may become corrupted. Turn on this settin' t' delete th' help file on yer device and cause OnSong t' download a fresh copy.

Reset Settings

This be equal t' th' Reset Settings tool found in th' Utilities Menu. It will remove all user preferences and reset th' settings back t' th' factory defaults. This does not remove yer OnSong library. This can be useful if a combination o' settings be causin' a problem when startin' OnSong.

Retrieve Help File

OnSong checks fer updates t' its help file when launched. Ye can turn this feature off t' prevent OnSong from lookin' fer a new help file. Default be on.

Storage Location

Since its inception, OnSong has stored libraries inside o' th' OnSong app. This has caused some users t' lose their library when th' app be deleted or corrupted. Ye can change th' location o' OnSong libraries t':

• Local stores th' OnSong library folders inside o' th' app. This keeps th' library only accessible t' th' OnSong app, but also means that deletin' th' app will remove th' library.
• Shared stores th' OnSong library folders in an app group. This allows other, OnSong-created apps t' access yer library. It also means that deletin' th' app will not delete yer OnSong libraries. Ye will need t' delete libraries before uninstallin' th' OnSong app t' completely remove th' data.

Note: most o' these features be off and when turned on, will be reset t' off once th' action has been performed when OnSong starts up. This be by design.