Release Notes

Release Notes

Complete version history for FindRomCover. Download links for each release are available on the Releases page.

3.2.2 — 2026-09-25

Improvements

• Settings menu cleanup — Ignore Bracketed Text in Matching now lives under the Settings menu instead of the top level, grouping it with the other matching and display toggles.

Under the Hood

• Removed an unused ParseDouble helper from the AI Settings window.
• Normalized for-loop spacing in ImageSaveService.
• Added CI, Docs, .NET, downloads, stars, issues, last-commit, and wiki badges to the README.

Downloads

• release_3.2.2_win-x64.zip
• release_3.2.2_win-arm64.zip

3.2.1 — 2026-09-24

Improvements

• New default OpenRouter model — the OpenRouter provider now defaults to google/gemma-4-26b-a4b-it, which follows the cover/box-art instructions more reliably than the previous default. Existing installations keep their configured model; the new default applies to fresh setups and whenever the Model field is left empty.

Downloads

• release_3.2.1_win-x64.zip
• release_3.2.1_win-arm64.zip

3.2.0 — 2026-09-24

AI Vision Assist (New)

• AI Pick Best on the Local Files and Google API tabs: a vision-capable model looks at the candidate images and highlights the best cover (green badge, moved to the front).
• Cloud or local models: OpenRouter, OpenAI, Anthropic (Claude), Google Gemini and GLM (Zhipu/Z.AI), plus local OpenAI-compatible servers (Ollama, LM Studio) and custom OpenAI/Anthropic-compatible endpoints.
• Default OpenRouter model is now qwen/qwen3.7-flash, the cheapest vision-capable model on OpenRouter (roughly $0.21 per 1,000 cover picks).
• AI Settings window: provider presets, encrypted API key storage, an editable model picker with Test / Load Models, request timeout, candidate/image limits, auto-save threshold, auto-run and verify-on-save toggles.
• Smart model picker: the loaded model list is filtered to vision-capable models by default (using provider modality metadata where available and a model-name heuristic otherwise), searchable with a filter box, and cached per provider for 7 days.
• Verify before saving: the folder watcher asks the model to confirm that a newly saved image matches the selected game before renaming it. Mismatches are left untouched and reported.
• AI Batch Fill: process the whole missing-covers list — local candidates first, optional Google API fallback — saving only when the confidence is above the threshold, with live progress, cancel, and per-item results.
• AI candidate similarity threshold: the filename matcher pre-filters candidates; only local images whose filename similarity is at or above the configured value (default 70%) are sent to the AI.
• No duplicate queries: covers already queried are remembered across sessions in the SQLite database QueryHistory.dat; Batch Fill skips them, and the history can be reviewed and cleared in AI Settings.
• Images are downscaled before upload (default 512px) and verdicts are cached for 30 days.
• Minimum cover size — downloads narrower than the configured Min cover width (default 200px) are rejected, so tiny thumbnails never become covers.
• Cover-first API picks — when ranking Google API results, the model is told to prefer real cover art or an in-game screenshot over a photo of a physical cartridge, cart, or disc.
• Fixed empty AI responses: reasoning models could spend the entire 400-token output limit on internal reasoning and return no text; the limit is now 4,096 tokens, and a clear error explains the cause if a model still runs out.
• More reliable batch downloads: images are requested with browser-like headers, and when a source blocks the full-size Google API image, the provider-hosted thumbnail is used as a fallback instead of failing.
• Accurate already-filled detection: cover detection now recognizes every supported image format and sanitized filenames, so the missing list no longer keeps games whose covers are already on disk; Batch Fill reports them once and removes them, and the list refreshes after every run.

Fixes & Improvements

• Ignore bracketed text when matching — a new Ignore Bracketed Text in Matching menu option (enabled by default) removes balanced (...), [...], and {...} groups from ROM and image names before scoring, so Game (USA) [En] matches a cover named Game. Works with all three similarity algorithms and with AI candidate pre-filtering.
• Image download failures no longer trigger bug reports — a dead or unreachable image host (connection timeout, refused connection, reset) is now logged as a warning and the thumbnail fallback is still tried, instead of aborting the download and filing an automatic bug report.
• "File is being used by another process" when saving covers — each save attempt now writes to a uniquely named temp file and write failures after all retries return a clear error dialog instead of an unhandled exception, fixing collisions from double-clicks, AI auto-save racing a manual save, and antivirus/sync locks.
• Save failure details in the UI — when a cover cannot be saved, the dialog and log now include the real reason (locked file, permissions) instead of a generic "Failed to save the image." message.
• Watched folders recover automatically — a folder that becomes temporarily unreadable (permissions, disconnected drive, antivirus) is logged as a warning, the watcher retries with backoff, and it no longer files automatic bug reports.
• Missing-list selection is kept — removing an item keeps the selection on the nearest entry instead of resetting to the top.
• Anthropic and Gemini providers now actually work — the provider adapters were never selected at runtime, so those requests went to an OpenAI-compatible endpoint and failed. Picks and verification now use the correct native adapter per provider.
• Covers are protected from accidental replacement — Google API downloads are verified before they replace an existing cover, the folder watcher no longer overwrites an existing PNG, and startup cleanup only removes the app's own temp files instead of any file containing .tmp.
• Picks never land on the wrong game — verification, saving, and missing-list removal use the ROM that was selected when the action started, even if the selection changes while the AI is still working.
• Google API timeouts handled properly — a timeout now shows a real error instead of "Search canceled." with a stuck progress state, and no longer aborts an entire AI batch fill.
• OpenAI reasoning models fixed — gpt-5-nano and o-series models are called with max_completion_tokens and without temperature, which the OpenAI API requires.
• Large missing lists no longer freeze the AI Batch window — query-history status is loaded in a single query instead of one database open per item.
• Sturdier settings storage — an unreadable settings database is preserved as Settings.dat.corrupt instead of being overwritten with defaults, and legacy settings are kept until the SQLite save succeeds.

Under the Hood

• New IVisionModelClient abstraction with native Anthropic Messages API and Gemini generateContent adapters; OpenAI, GLM, local, and custom OpenAI-compatible endpoints share one adapter, while custom Anthropic-compatible endpoints reuse the Anthropic adapter.
• Settings moved to SQLite: all settings (including encrypted API keys) now live in %LocalAppData%\FindRomCover\Settings.dat. The old encrypted settings.dat is migrated automatically on first start and kept as settings.dat.legacy.
• Full documentation: a professional documentation site (GitHub Pages) and a synchronized GitHub wiki with side navigation, including release notes and recommended AI models. CI publishes both.
• Dependency updates: Magick.NET, NAudio, Microsoft.Extensions.DependencyInjection, the Roslyn/Meziantou analyzers and the .NET test SDK were updated.
• Log writes are serialized: the error logger clears and appends under one lock, so entries cannot be lost or truncated during concurrent reporting.
• AI request failures are logged as warnings and never trigger the automatic bug-report pipeline.
• Version bumped to 3.2.0.
• GitHub Actions CI now builds and tests every push and pull request on Windows.

Downloads

• release_3.2.0_win-x64.zip
• release_3.2.0_win-arm64.zip

3.1.0 — 2026-09-02

Fixes & Improvements

• Automatic scan after selecting a folder — browsing to the ROM or Image folder now scans automatically as soon as both folders are set (#1).
• Clear scan feedback — the status bar reports how many ROM files matched the supported extensions and how many are missing covers; an explicit message replaces a silently empty list (#1).
• Refresh after editing supported extensions — changing the extension list re-scans immediately.
• Repository migrated — the project now lives at purelogiccode/FindRomCover; the update checker follows the new releases page.

Under the Hood

• A corrupt settings.dat is quarantined as settings.dat.corrupt and defaults are restored instead of failing.
• Managed PBKDF2 fallback so settings decryption no longer crashes on systems where the OS cryptographic implementation fails.
• Friendlier Google Custom Search API error messages (invalid API key, quota exceeded, bad requests).
• More robust link opening with an explorer.exe fallback.

Downloads

• release_3.1.0_win-x64.zip
• release_3.1.0_win-arm64.zip

3.0.1 — 2026-07-12

• WebView2 graceful fallback — when the runtime is missing, web search tabs are unavailable but the rest of the application works; no repeated error logs.
• Image conversion improvements — corrupt or misformatted images are detected immediately and skipped without retries; retries remain for transient I/O failures.
• Less log noise — benign events logged at Debug level; the bug-report sink only sends Error-level events.
• Dependency updates: Magick.NET 14.15.0, MessagePack 3.1.8, WebView2 1.0.4078.44, Serilog 4.4.0.

3.0.0 — 2026-07-06

Major release that introduced the tabbed interface and local similarity search.

New Features

• Tabbed search interface — Local Files, Google Web, Bing Web, and Google API tabs, each keeping its own results.
• Local file similarity search — Jaro-Winkler, Levenshtein, and Jaccard algorithms with a 10–90% threshold and trigram indexing for large folders.
• System tray integration — minimize to tray with restore/exit and balloon notifications.
• Keyboard shortcuts — F5 refresh and more.
• Image folder watcher — detects new covers, converts them to PNG, renames them to the selected game, and updates the missing list.
• Delete ROM from missing list — right-click to permanently delete the ROM/ISO after confirmation.

Improvements

• Settings encrypted with AES using a machine-specific PBKDF2 key; legacy settings.xml migrated automatically.
• Serilog structured logging with a live log viewer and rolling 7-day files.
• Dependency injection with Microsoft.Extensions.DependencyInjection.
• Extended image format support (HEIC, HEIF, ICO, SVG, JXL, JP2, AVIF) and Magick.NET resource limits.
• Graceful startup/shutdown, orphaned temp-file cleanup, and global exception handlers.
• Better Google API error messages for 429, 403, and 400 responses.
• Filename sanitization to prevent path traversal.

Breaking Changes

• PlaySound service replaced by IAudioService with a null fallback.
• settings.xml no longer used.
• MameManager no longer a serializable DTO; use MameData.

2.9.0 — 2026-05-25

• Fixed similarity calculation for empty strings (now 100% instead of NaN or 0).
• Handled InvalidWmpVersionException in the audio service.
• Added UpdateCheckOrchestrator and UpdateNotificationInfo for cleaner update flow.
• Extensions sorted alphabetically; accessibility tooltips added.
• Improved error handling and shutdown robustness; fatal startup dialog added.
• Dependency and test coverage updates.

2.8.0 — 2026-05-12

• Performance: trigram indexing for large image folders, Levenshtein early bailout, pre-computed Jaccard n-grams, pooled buffers in Jaro-Winkler, progressive image loading.
• Features: GitHub update checking, anonymized usage tracking, cross-instance settings synchronization.
• UI/UX: tooltips throughout, improved empty states, loading overlay styles.
• Testing: new unit test project with 214 tests.
• Removed MameManager, replaced by MameDataService.

2.7.0 — 2026-04-14

• Comprehensive XML documentation across services and models.
• Code quality improvements and smaller refactors.
• Dependency updates and additional tests.

Older releases

Version	Date	Highlights
2.6.0	2026-02-22	Key UI improvements: loading overlays with progress indicators
2.5.1	2026-01-21	Dependency updates and image loading resilience
2.5.0	2026-01-08	Magick.NET replaces GDI+ for image processing
2.4.2	2026-01-03	Improved error logging
2.4.1	2025-11-28	Audio service crash prevention
2.4.0	2025-11-18	Upgraded to .NET 10 and C# 14
2.3.0	2025-09-17	Codebase update
2.2.0	2025-07-26	UI updates
2.1.1	2025-07-02	Library updates
2.1	2025-04-29	ButtonFactory and command enhancements
2.0.0	2025-03-15	Codebase update
1.10	2025-03-07	GDI+ error fixes, more robust image saving
1.8.0	2025-01-14	.NET Core 9, library updates, bug fixes
1.7.0	2024-12-08	Alphabetical sorting for missing covers
1.6.0	2024-11-28	Right-click context menu
1.4.0	2024-05-20	Code improvements and bug fixes
1.3.0.4	2024-02-28	Added Jaccard and Levenshtein similarity algorithms
1.2.0.3	2024-02-05	Initial release

Related pages

• Installation
• Recommended Models
• GitHub Releases