Moving Your Library

This guide explains the safest way to move your main Zenspire library folder to a new location (e.g., from your Documents folder to an external drive) without losing your Favorites, Pinned images, or Collection data.

Important: Follow These Steps Exactly

The order of these steps is crucial to protect your data. This method involves copying your files first as a safety measure.

For Extra Peace of Mind: Back Up Your Database

Before you begin, you can back up the small database that stores your collections, favorites and other custom meta data. This is an optional but recommended step.

1. In Finder, click the Go menu and select Go to Folder….
2. Paste this exact path and press Enter: ~/Library/Containers/Zenspire/Data/Library/Application Support
3. In this folder, you will see a folder named Zenspire. Copy this entire folder to your Desktop. This folder contains the database file and its related temporary files. Backing up the entire folder is essential.
4. If anything goes wrong during the move, you can quit Zenspire and replace the Zenspire folder with your backup copy to restore your data.

1. Quit Zenspire Make sure the Zenspire application is completely closed. Press ⌘Q or select Zenspire > Quit Zenspire from the menu bar. This ensures no changes are being done to your library while you copy the image files.

2. Copy the Folder in Finder Using the macOS Finder, navigate to your current Zenspire library folder. Copy the entire folder to its new destination. You can do this by dragging the folder to the new location while holding the Option (⌥) key, or by right-clicking and choosing Copy, then pasting it in the new location.

3. Relaunch Zenspire Open the Zenspire application again. It will still be using the library at the original, old location.

4. Update the Location in Settings Open Zenspire’s settings (⌘,). Go to the Library tab and click the Choose... button. In the folder selection panel that appears, navigate to and select the copied library folder in its new location.

5. Verify the New Location After selecting the new location, Zenspire will rescan and load the library from the new path.

6. Clean Up (Optional) Once you have confirmed that Zenspire is working correctly with the library in the new location, you can safely delete the original library folder from the old location to free up disk space.