-
Notifications
You must be signed in to change notification settings - Fork 0
FAQ
Yes. FindRomCover is free software licensed under the GNU General Public License v3.0. See License.
Windows 10 and later, both x64 and ARM64. The application is built with WPF on .NET 10 and does not run on Linux or macOS.
No. FindRomCover only works with ROM files you already have and only downloads cover images.
Only when you use features that require it:
- the update check contacts GitHub;
- the Google Custom Search API is called only when you use that tab;
- AI providers are contacted only when AI Assist is enabled and used;
- anonymous, best-effort usage statistics are recorded at startup;
- error-level events may be sent to the bug-report API.
Filenames and image contents are never uploaded except to your configured AI provider when AI Assist runs.
Yes, with Local Files search and the embedded browser. Google API, cloud AI providers, and update checks require internet access. Local AI models (Ollama, LM Studio) work offline.
Only for the Google API tab and for cloud AI providers. Local Files, Google Web, Bing Web, and local AI servers do not need any key.
In %LocalAppData%\FindRomCover\Settings.dat (SQLite). See Data Storage.
Copy the application folder and the %LocalAppData%\FindRomCover folder. API keys may need to be re-entered because encryption is tied to the Windows user and machine.
The cover name must match the ROM base name (case-insensitive, any recognized image extension). Rename the image to match the ROM, or let the watcher rename it while the game is selected, then press F5.
Right-click it and choose Remove Item from the list. It returns after a full scan unless a cover exists or the ROM is deleted.
Yes — edit the Extra Query field, or enable Settings > Use MAME Descriptions for arcade titles.
Right-click the entry and choose Delete corresponding ROM or ISO. This is permanent and asks for confirmation first.
No. It is optional and disabled by default.
With the default OpenRouter model, a pick costs a fraction of a cent — about $0.21 per 1,000 picks. See Recommended Models.
Yes. Run Ollama or LM Studio and select the Local provider. See Providers & Models.
Reasoning models can exhaust their output budget before writing an answer. FindRomCover now allows 4,096 output tokens and reports a clear error if that still happens; switching to a non-reasoning model usually solves it. See AI Troubleshooting.
No. AI can only choose an image. Saving and renaming follow your settings and the normal overwrite confirmation.
Keep Skip missing covers already queried in previous sessions enabled. Use Clear query history to start over. See Query History.
Install the Microsoft Edge WebView2 Runtime when prompted, then restart the application.
Verify the key in Settings > API Settings..., ensure the Custom Search JSON API is enabled in Google Cloud, and check your quota.
In the application folder (app.log, error.log, error_user.log) and in the live log window under Settings > Show/Hide Log Window. See Logs & Diagnostics.
Close FindRomCover and delete %LocalAppData%\FindRomCover\Settings.dat. Defaults are recreated on the next start. Stored API keys are removed too.
FindRomCover — find and download missing cover art for your retro gaming ROM collection.
Getting Started
User Guide
- Interface Overview
- Folders & Scanning
- Local Files Search
- Web Search (Google Web & Bing Web)
- Google Custom Search API
- Image Handling
- Missing Covers List
AI Vision Assist
- AI Vision Assist
- Providers & Models
- AI Settings
- Picking Covers
- Batch Fill
- Query History
- Recommended Models
- AI Troubleshooting
Configuration
- Settings Overview
- Themes & Appearance
- Similarity Algorithms
- Supported Extensions
- Data Storage
- Logs & Diagnostics
Reference
Development
More