Repository navigation
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.
macOS — see Installation. Right-click → Open, or allow it under System Settings → Privacy & Security.
Windows — SmartScreen: More info → Run anyway.
- 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.
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.
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 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.
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.
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.
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.
Crosspost Helper — local-first, no account, nothing uploaded unless you send it.
Crosspost Helper