Back up and restore

SongSheet Pro saves your library whenever you make an edit, but it is still a good idea to keep a separate backup of your library.

Use the Back up and restore screen to export a complete copy of your local library, or to restore your library from a .songsheet-backup file created by SongSheet Pro.

Back up your library

1. Open Settings.
2. Choose Library.
3. Tap Back up and restore.
4. Tap Export a backup.
5. Wait while SongSheet Pro prepares the backup file.
6. Choose how you want to save or send it.

Depending on the apps and share destinations available on your device, you can save the backup to Files or send it using options such as AirDrop, Mail, or Messages.

What the backup contains

SongSheet Pro creates a backup file with the extension .songsheet-backup.

The backup contains:

• All songs in your current local library;
• All tags and metadata associated with those songs;
• All themes in your theme library; and
• All setlists and the songs they contain.

Note: The backup does not contain app settings. These are unaffected when importing or exporting backups.

If a song is linked to a backing track in your device’s Music library, the backup includes the metadata SongSheet Pro uses to identify that backing track. It does not include the audio file itself. When you restore the backup on a device that has the same track in its Music library, SongSheet Pro can relink the song to that backing track. If the track is not in the device’s Music library, the backing track link will be broken after restore.

After a successful export

SongSheet Pro shows a summary of your last successful backup next to Back up and restore in Settings. This includes the time and date of the most recent backup and the method you used to save or share it.

Backup tips

• Save a fresh backup before making major library changes.
• Keep at least one copy in the Files app or another location you control.
• Keep the .songsheet-backup file until you have confirmed the restore worked on the target device.

Restore your library

Restoring a library backup is replace-only. When you confirm the restore, SongSheet Pro replaces the current local library with the library stored in the backup file.

Before you continue, keep these points in mind:

• Restoring a backup replaces your current local library.
• This is not a merge tool.
• If you want to keep your current library, create a new backup first.

Restore a backup from Settings

1. Open Settings.
2. Select Library.
3. Tap Back up and restore.
4. Tap Restore library.
5. Choose the .songsheet-backup file you want to restore.
6. Confirm that you want to replace your current library, or cancel to leave your library unchanged.

If you confirm the restore, SongSheet Pro replaces your songs, setlists, themes, and tags with those in the backup. If you cancel, SongSheet Pro leaves your current library unchanged.

Open a backup file from Files

You can also restore a backup by opening the .songsheet-backup file from the Files app or another file location on your device. SongSheet Pro will open and ask if you want to restore the backup and replace the current library.

Just like when restoring a backup from Settings, you can cancel when SongSheet Pro asks you to confirm the restore.

What happens if something goes wrong

SongSheet Pro validates the backup before replacing your library. Once you confirm the restore, the backup file will be read and the data extracted. SongSheet Pro will not replace your library unless it fully loads the backup.

Note: We strongly recommend you make a backup of your library before restoring a backup file, so that even if something does go wrong, you will have a safe copy of your data.