Skip to content

Troubleshooting

valerie-4659 edited this page Aug 11, 2026 · 1 revision

Troubleshooting

When reporting something, please include your platform, the version from the bottom of the sidebar, and what you did just before it went wrong. Open an issue.

The app will not open

macOS — see Installation. Right-click → Open, or allow it under System Settings → Privacy & Security.

Windows — SmartScreen: More info → Run anyway.

The library is empty after scanning

  • Check Scan shows the folder and that it is enabled.
  • Check the folder actually contains supported files: .jpg, .jpeg, .png, .webp, .gif, .mp4, .webm, .mov.
  • Press Refresh in the Library toolbar.

Thumbnails are missing or wrong

Use the Thumbnails button on the source in Scan. It rebuilds every thumbnail for that source without re-walking the folder, which is what you want after a cleared cache or an interrupted first scan.

Scanning is slow

The first scan is slow by nature — it decodes every image to make thumbnails. Later scans should be fast because unchanged files are skipped.

If every scan is slow, the usual cause is that the files look changed: a folder on a cloud drive (Google Drive, OneDrive, iCloud) that re-syncs and rewrites timestamps will defeat the skip. Locally-stored folders do not have this problem.

The browser extension does not fill anything

  • The app must be running — the extension talks to it locally.
  • Reload the post page after queueing.
  • Check the extension is enabled for that site.
  • Nothing happens on send: the extension fills, you press send. That is by design.

AI captions fail

The error text under the Generate button comes from the provider. The common ones:

  • 401 / invalid key — check the key in Settings → AI.
  • 429 — you are rate-limited or out of quota with that provider.
  • Content refusals — the provider declined. Lower the Spice level, or use a different provider.

An update was announced but the download is the same version

The banner reads the version from the release on this repository. If it disagrees with what you have installed, refresh with Check now on the About page. If it still disagrees, please open an issue with both version numbers.

Starting over

Removing the application data directory resets the app completely — index, history and settings. Your images are not touched; they were only ever read. A fresh scan rebuilds the index.