Bunny Screenshot is a local macOS utility for indexing, searching, and safely renaming screenshots.
Common Setup Questions
I launched the app and no window appeared
After setup is complete, Bunny Screenshot launches quietly as a menu bar utility. Click the camera icon in the menu bar and choose Library, or press Cmd-N while the app is active, to open the Library window. The window only opens automatically on first launch, when setup has not been completed yet.
Where did the Dock icon go?
Settings > General has a Show Dock icon toggle. When it is off, Bunny Screenshot runs as a menu bar accessory without a Dock presence. Turn the toggle back on to restore the Dock icon.
Why don't sensitive screenshots show up in search?
By default they do. If Hide sensitive screenshots from search is enabled in Settings > Analysis & Privacy, screenshots the analysis flagged as sensitive are excluded from typed search results but remain in your library and in the Sensitive filter.
Why does Bunny Screenshot ask for folder access?
Bunny Screenshot only watches folders you choose. macOS requires your approval before an app can access protected folders such as Desktop. After you choose a folder, Bunny Screenshot stores a security-scoped bookmark so access should only need to be granted once per folder.
Why does Bunny Screenshot ask about OpenAI analysis?
With the default OpenAI engine, screenshot images are sent to OpenAI only when analysis runs, using your own API key. Bunny Screenshot asks for your confirmation before cloud analysis can run. If you prefer that nothing leaves your Mac, choose the On-device engine instead — it needs no OpenAI consent and no API key.
What is the on-device analysis engine?
The on-device engine analyzes screenshots entirely on your Mac using a local model. Pick it during setup or in Settings > Analysis & Privacy, then download a model: Efficient (recommended, ≈5.7 GB) or Accurate (≈6.7 GB, matches cloud quality but slower). Downloads show progress, can be cancelled, and resume where they left off if interrupted. You can remove a downloaded model anytime from the same screen to reclaim disk space.
Why is the model download so large?
Local vision models are several gigabytes by nature. The app checks your free disk space before starting and verifies the download against a pinned checksum before activating it.
Can I find screenshots from Spotlight (Cmd-Space)?
Yes. Analyzed titles, descriptions, and visible text are added to the macOS Spotlight index on your Mac, so you can search screenshots from Cmd-Space. Turn this off in Settings > Analysis & Privacy if you prefer; turning it off removes the entries from the system index. Sensitive screenshots follow your "hide sensitive from search" setting in Spotlight too.
Where is my OpenAI API key stored?
Your OpenAI API key is stored in macOS Keychain. It is not stored in Bunny Screenshot's SQLite metadata database or app settings.
Does Bunny Screenshot delete screenshots?
No. Bunny Screenshot does not delete screenshots. Resetting the metadata database only deletes Bunny Screenshot records, analyses, jobs, audit events, and rename history. It does not delete, move, or rename screenshot files.
Can I turn off automatic renaming?
Yes. Rename mode can be set to:
- None
- Auto
- Suggest (User Approval)
The default is Suggest (User Approval).
What is Developer Mode?
Developer Mode reveals MCP server settings, MCP tool controls, and database maintenance controls. MCP is disabled by default.
Troubleshooting
Scan Now does nothing
Open Settings and check:
- A watched folder is configured.
- For the OpenAI engine: the analysis disclosure is enabled and an API key is configured.
- For the On-device engine: a model is downloaded and installed.
- Watching is not paused.
- The screenshot filename filter matches the files you expect, or non-screenshot images are enabled.
Desktop cannot be read
Use the Grant Access action shown in the scan notice, or choose the folder again in Settings. This lets macOS grant Bunny Screenshot access to that folder.
Keychain prompts keep appearing
Open Keychain Access, find the Bunny Screenshot OpenAI API key item, and grant the app access from the item's Access Control settings. For App Store builds, re-check this flow after final signing because macOS Keychain trust is tied to the signed app identity.
Contact
Email max@2185lab.com and include your macOS version plus what you expected to happen.