Troubleshooting

Troubleshooting

Common Issues

App doesn't appear in menu bar

1. Check Activity Monitor for ClipStash process
2. Try relaunching the app
3. Check System Settings → Control Center → Menu Bar for hidden icons

Clipboard not being captured

Check the ignore list:

1. Settings → Privacy → Ignored Apps
2. Remove any apps you want to capture from

Check automatic protection:

• "Ignore concealed" skips password manager content
• "Ignore transient" skips temporary clipboard data

Check source app:

• Some apps use private clipboard APIs that can't be read

Search not finding items

• FTS5 search looks in text content only
• Images are not searchable by content
• Try shorter search terms

Export fails

• Check you have write permissions to Downloads folder
• Try smaller scope (Last 50 instead of Last 500)
• Check disk space

Launch at Login not working

macOS requires apps to be in /Applications for Login Items:

1. Move ClipStash.app to /Applications
2. Relaunch the app
3. Enable "Launch at Login" again in Settings

Images not loading in detail view

• Image may have been deleted
• Check if images folder exists: ~/Library/Application Support/ClipStash/images/

Reset & Recovery

Reset all settings

defaults delete com.kiku.ClipStash

Clear clipboard history

Settings → Diagnostics → Clear History

Choose to keep or delete pinned items.

Complete reset

# Stop the app first
rm -rf ~/Library/Application\ Support/ClipStash
defaults delete com.kiku.ClipStash

Then relaunch the app.

Getting Help

• GitHub Issues
• Check existing issues before creating new ones

---

← FAQ | Home