Overview
For problems specific to a feature, see that feature’s page — most have a Troubleshooting section at the bottom. This page covers installation, offline mode, and support.Where to get help
Click the Help & feedback icon in the sidebar (or pressCtrl/Cmd+Shift+/) to open one dialog with everything: documentation, changelog, keyboard shortcuts, bug reports, feature requests, free-form messages, and the Discord invite. Bug reports automatically attach app version, OS, recent errors, and up to the last 10 MB of the local log file — you can turn that off before submitting.
Installation & Updates
v2.0.0 Migration
v2.0.0 introduced a new database architecture that is not compatible with previous versions. After updating, you’ll be prompted to migrate. We recommend skipping the migration and starting fresh with a reanalysis of your samples. A fresh install from the downloads page is only required if the migration does not complete successfully.macOS Apple Silicon Build
Redownload the app from the website and select the correct version for your CPU architecture. A previous bug caused Apple Silicon users to receive Intel builds.Offline Mode
After signing in once while online, all local features work offline:- Sample browsing, filtering, and search by name and tokens
- Audio playback with Tempo and Key Lock
- Sound Profile filtering
- Similar Samples
- AI Assistant chat
- Deep Search — the AI pass that matches samples by your description
- Deep Tagging
- Cloud sync and backup
Samples won’t play or show up as missing
If files you added before suddenly won’t play, show as missing, or can’t be written to, Sample Vault has most likely lost read access to where they live on disk. The app only sees a sample if the account running it can reach that path. This is most common with samples kept on a network share or external drive:- The drive or share isn’t mounted, or mounted at a different path than when the samples were added.
- On a machine with more than one user account, the share is mounted under a different account than the one running Sample Vault, so the app inherits permissions that can’t read or write those files.