<aside> 💡

This troubleshooting guide is specifically for the macOS version of SnipNotes.

</aside>

If you receive an error message stating that the database cannot be opened when launching SnipNotes, please try the following steps to resolve the issue:

1. Open the Terminal app on your Mac

   • You can find it in Applications > Utilities, or use Spotlight (⌘ + Space) and search for "Terminal"

2. Copy and paste the following command into the Terminal:

   sudo chown -R $(whoami):staff ~/Library/Group\\ Containers/7T8DYS43CJ.de.lisczyk.felix.SnipNotes/
   

3. Press Return (↵) to execute the command

4. When prompted, enter your Mac's admin password

   • Note: The password won't be visible as you type
   • Press Return (↵) after entering your password

5. Close the Terminal

6. Restart your Mac

7. Launch SnipNotes again

Reset the Database

If the steps above did not help, you can reset the local database and restore your notes from iCloud.

<aside> 💡

Before you proceed: This step requires that iCloud synchronization is enabled in SnipNotes. If iCloud is not enabled, please get in touch before proceeding to avoid losing your notes.

</aside>

1. Quit SnipNotes and open the Finder

2. In the menu bar, click Go → Go to Folder…

3. Paste the following path into the text field and press Return:

   ~/Library/Group Containers/7T8DYS43CJ.de.lisczyk.felix.SnipNotes/
   

4. Move the folder named "database" to your Desktop (this serves as a backup)

5. Launch SnipNotes — the app should start with an empty note list

6. Open Settings (cogwheel icon in the upper-left corner) and switch to the "Troubleshooting" tab

7. Click "Reset Now" in the iCloud section and wait until the spinner disappears