Skip to content

FAQ

Jump to bottom
Nick edited this page Dec 8, 2025 · 1 revision

FAQ

General

Why doesn't ClipStash use clipboard notifications?

macOS doesn't provide them. There's no NSNotification for clipboard changes. Polling NSPasteboard.changeCount is the only reliable method — same approach used by all established clipboard managers.

How often does it check the clipboard?

Every 300ms with debouncing. This uses negligible CPU (<0.5% idle).

Where is my data stored?

~/Library/Application Support/ClipStash/clipstash.db

Images are stored in the images/ subfolder.

Does ClipStash sync to the cloud?

No. There is no cloud sync, no accounts, no network access whatsoever.

Usage

How do I exclude an app?

  1. Go to Settings → Privacy → Ignored Apps
  2. Click "Choose app from Finder"
  3. Select the application to ignore

How do I view full content of a clip?

Double-click the item. It opens in a separate, resizable window where you can:

  • Select and copy portions of text
  • View images at full size

How do I export to NotebookLM?

  1. Open Settings → Export
  2. Choose scope (Last 100, Pinned Only, etc.)
  3. Click "Export Now"
  4. Upload the generated .md files to NotebookLM

What happens when history is full?

Oldest non-pinned items are automatically removed when you exceed the history limit.

Troubleshooting

ClipStash isn't capturing my clipboard

  1. Check if the source app is in the Ignore List
  2. Check if "Ignore concealed" or "Ignore transient" is blocking it
  3. Make sure the app is running (menu bar icon visible)

Launch at Login isn't working

The app must be in /Applications folder. macOS restricts Login Items to apps in standard locations.

How to fully uninstall?

rm -rf /Applications/ClipStash.app
rm -rf ~/Library/Application\ Support/ClipStash

← Privacy & Security | Troubleshooting →

Clone this wiki locally