Backup & Restore

Curlo can back up your database on a schedule. Each backup is a standalone SQLite snapshot containing all of your library data — file records, metadata, UCS classifications, tags, and collections. Audio files themselves are never copied, and restoring a backup never touches the audio files on disk.


Enabling Automatic Backups

  1. Open Curlo’s Settings and switch to the Backup tab
  2. Set Backup Frequency to Daily, Every 3 Days, or Weekly (it defaults to Off)
  3. Click the edit button next to Backup Location and choose a folder for the backup files
  4. Adjust how many backups to Keep Last (1–20, default 3) — older backups are cleaned up automatically

Tip: When you switch from Off to any frequency, Curlo creates the first backup immediately — no waiting required.

Until a backup is configured, a reminder banner appears at the top of the window. Click Settings… to jump straight to the backup settings, or choose Don’t Remind Again to dismiss it.


When Backups Happen

Once enabled, Curlo checks whether a backup is due periodically while it runs: shortly after launch, when the app becomes active again, and before it quits. Backups automatically wait for indexing to finish. You can also click Back Up Now in the backup settings at any time to create one manually.

Backup files are named Curlo-Backup-<datetime>.sqlite and stored in the folder you chose — an external disk works fine. If the backup location is temporarily unavailable (for example, the disk isn’t mounted), Curlo retries automatically on its next check.


Restoring From a Backup

  1. In the Backup settings, select a backup from the Available Backups list
  2. Click Restore…, then confirm with Restore & Quit
  3. Curlo quits. The next time you open Curlo, the restore completes automatically and a notice tells you which backup it came from

Note: Restoring replaces the current database with the backup. The previous database is preserved in full as a *.pre-restore file, so the restore is safe.


What’s in a Backup

IncludedNot included
File records, metadata, UCS classifications, tags, collectionsAudio files themselves
A complete snapshot of the databaseCurlo’s app settings

As long as your audio folders are backed up separately, keeping these backup files is all you need to rebuild your entire Curlo library on any Mac.