Setting up OpenSongApp for the first time

Splash screen

After installing OpenSongApp, you are presented with the home screen. The current version is shown at the top.This page is the 'splash screen' and is shown when you first install the app and whenever it updates to a newer version (you can view the latest update log by clicking on the 'Latest updates' link near the top of the page - this will bring you to this site, and the Latest updates page. You can return to this screen at any time using the button in the songbook options menu (covered later).

If you haven't selected your preferred storage location, you will be asked to do this before proceeding. On your first run of the app, I highly recommend using internal storage.

Using the Songbook

To go straight to the songbook (assuming you have chosen your storage location), click on the big green button at the top. Once you have set up your app, this will likely be the most common action on this page. Remember, you will need songs to make this app useful!

Setting up the Songs and Sets folders

On your first run, the app will check for the appropriate folders on your storage card (internal/external) and if necessary it will create them for you. The folders created are found inside your 'Documents' folder and are OpenSong/Songs and OpenSong/Sets. If you chose external or a custom storage location, the files will be found inside a folder named 'OpenSong' at your specified location.

Any songs that you want to use with the app need to be inside the OpenSong/Songs folder and, you've guessed it, any sets will be stored in the OpenSong/Sets folder. Some other folders are created by the app for the Presenter mode (such as Backgrounds and Slides). You can choose internal or external storage for your songs.


Some devices (especially running Android 4.4 or later and Samsung devices) may deny the app access to the SD card. Unfortunately there is very little I can do about this Android security feature. The SD card will only show one external card if it is available to the app. If you run into problems with the app, you should try to run it using internal storage - This is the preferred option.

You can also specify any custom folder to use (this often allows you to pick non-discovered SD cards).

Whatever folder you specify, the app will create an OpenSong folder at this location and all songs, etc. are saved inside this folder.

If you think you have lost your songs (after uninstalling/reinstalling/etc.), fear not - the most likely scenario is that you have not set the correct storage location. To fix, this, follow the guide on the FAQ pages.

If you don't have a collection of songs of your own, the app will automatically display the 'Welcome to OpenSongApp' screen. This 'song' is also the 'fallback' song if the app cannot find a song in your folder (if you accidentally or intentionally deleted it).

The app features several ways of adding songs. These are discussed later, but include importing my song collections, importing from Ultimate Guitar, Chordie, Worship Ready (coming soon) or creating your own songs manually.

To manually import your own existing OpenSong songs and sets from a desktop computer, browse to your OpenSong folder on your desktop (this is normally found in your Documents / My Documents folder). Copy the folders that you want to transfer (Ctrl-A selects all then Ctrl-C to copy). Then connect your Android device to you computer and browse to the appropriate OpenSong folder (make sure you browse to the internal/external storage location chosen above). Once in this folder, paste the copied folders (Ctrl-V). You can overwrite/merge the folders. I use Linux, so this may look different on your desktop if you use a Windows or Mac device.

Manage storage

You can also also wipe your Song folder if you want to.

This option can be selected by clicking on the red buttons from the Manage storage page.

You can return to this page at anytime by clicking on the 'Manage Storage' option in the settings menu.