Song indexing

Found under: Song Menu > + > Rebuild song index

When you first boot OpenSongApp the app will fully index your songs. This involves scanning all items in your OpenSong/Songs folder and for OpenSong formatted songs, the app will read in the contents of these songs and build a database of their contents. This is a relatively slow process and only needs to be carried out if the files have been changed using another app (OpenSongApp updates its database whenever you change or edit a song in the app).

If you have updated files and want the app to only update songs that have changed since the last full index, you can run the quick index. This only reads in file that have a created/modified date newer than the database file. This should be quite a fast scan and is ideal if you use external synchronisation (such as Dropsync or Autosync for Google Drive). I should point out that quick means quicker than full!

If you haven't changed anything, the app will allow you to skip indexing, thus speeding up the boot process.

While song indexing is taking place, you will be unable to edit songs or adjust song actions related to the song.

Indexing is quite an intensive process and is affected by memory, device speed and any other processes running in the background. For each song (I know many users have over 1000), the app has to open each one in turn, read in the data, process the song and create a database entry before moving to the next one. Please be patient.

Index songs (full)

You only need to run the full index under the following circumstances:

You used a separate file manager to manually add/remove song files into/from the OpenSong/Songs folder
There have been significant changes made to your Songs folder
The songs are showing as blank or there is another issue with your song menu
You exited the app before indexing completed (you will likely not be shown the option for indexing songs if this was the case).

Index songs (quick)

You should use the quick index under the following circumstances:

You have your OpenSong/Songs folder synchronised with online storage (such as Google Drive or Dropsync) and there has been a change to files on the online storage location that has triggered a synchronisation of your storage.
You have manually added or edited a few songs in your song folder using software other than OpenSongApp

Skip

This is the default option and is automatically chosen after 10s or if you close the popup window. This will use the currently saved database. If you have any issues with songs either not being up to date or empty, you should run the full index.

If you boot the app and later want to rebuild the song index, you can manually trigger it by opening the Song menu, clicking on the + button and then selecting rebuild song index. Again you can choose the full or quick methods.

Page updated

Google Sites

Report abuse