Issue:
On first launch, a new installation of Sample Manager shows a “Database migration error” — even before importing samples.
Cause:
The app fails to create or upgrade the database due to macOS file permission issues, especially in newer versions of macOS.
Fix:
- Quit Sample Manager completely. Ensure it’s not running in the background.
- Delete the database file manually:
- Go to: ~/Library/Application Support/ADSR
- Delete any .db3 files you see in this folder.
- Reopen Sample Manager. It will attempt to create a fresh database on launch.
Optional:
On macOS Ventura or later, grant Full Disk Access to Sample Manager:
- Go to System Settings → Privacy & Security → Full Disk Access
- Add ADSR Sample Manager.app manually if it’s not listed
Why This Happens:
- Newer versions of macOS may restrict database creation if folder permissions are not inherited properly during installation.
- A partially created database file can also trigger migration errors on launch.