Skip to main content
Back to overview
All guides

Migrating from OpenSong

Your whole OpenSong library moves over in one go. Songs are converted to ChordPro during import, and your song folders are kept. The Add song button in SONGUIDE has a Coming from OpenSong entry that walks you through the same steps and takes the file at the end.

From OpenSongApp on Android

The backup in OpenSongApp is the fastest way over:

  1. In OpenSongApp, open Settings, then Song actions, then Backup.
  2. Leave the extras (persistent database, highlighter notes) unticked and create the backup.
  3. Share the .osb file straight to SONGUIDE. Or save it, then pick it in SONGUIDE under Add song, Coming from OpenSong.

From OpenSong on a computer

Desktop OpenSong keeps every song in the Songs folder inside its data folder. The location is set in OpenSong under Settings, File Locations:

  1. Find your OpenSong data folder and compress its Songs folder into a ZIP archive. Zip the Songs folder alone, not the whole data folder: backgrounds, pads, and other media dwarf the songs and push the archive over the size limit. If it syncs through Dropbox, download it first (Make available offline), or zipping fails on the online-only files. On a Mac, "The operation couldn't be completed" usually means some files or folders are locked. Open the Songs folder, click the first item, hold Shift and click the last so everything is selected, then hold Cmd and Ctrl and press I (one info panel opens for the whole selection, plain Cmd I would open one window per file) and untick Locked. Folders and their contents are locked separately, so repeat this inside any subfolder whose files show a small lock icon, then compress again.
  2. Get the ZIP onto the device running SONGUIDE, then choose Add song, Coming from OpenSong, and Pick backup or ZIP.

What comes across

Every song arrives as a normal SONGUIDE song in ChordPro. Section tags like [V1] become headings such as Verse 1, and chord lines move into the lyrics exactly where they sit in OpenSong. Title, artist, copyright, CCLI number, key, tempo, and time signature all carry over, and comments become annotations. A capo becomes your personal capo setting on the song.

The backup's subfolders become SONGUIDE folders with the same names, and songs without a subfolder land in a folder named after the archive. If a folder of that name already exists, the new one gets Import added to its name. When everything is done, a summary lists each created folder with its song count.

What stays behind

  • Presentation order, themes, and OpenSongApp extras such as sticky notes, hand-drawn highlights, and linked videos are not imported.
  • OpenSong sets are not imported. Setlists are quick to rebuild in SONGUIDE once the songs are in.
  • PDFs and images stored inside a backup are skipped and counted in the summary.
  • The stock Welcome to OpenSong sample song is left out.

An archive can be up to 50 MB and each song file up to 1 MB. That comfortably fits libraries of well over a thousand songs, because song files are small text. An archive over the limit almost always means media came along: zip the Songs folder alone, or zip a few of its subfolders at a time and import each.

Next steps