From 9fc0dcc7c3b4b4da79ad7caad73d471048f0debb Mon Sep 17 00:00:00 2001 From: Sam Dornan Date: Wed, 30 Sep 2026 15:36:32 +0000 Subject: [PATCH 1/3] Stop claiming Hasheous supplies RetroAchievements IDs RomM matches RetroAchievements by hash only since rommapp/romm#4962 (the fix for rommapp/romm#4959), so Hasheous no longer provides RA IDs. Describe what Hasheous still supplies, explain how RA matching works and what it needs, and note that disc images inside archives get no RA match from a scan (rommapp/romm#4967). Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01FoxH511V1d31hAA2tWvw3Q --- docs/getting-started/metadata-providers.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/getting-started/metadata-providers.md b/docs/getting-started/metadata-providers.md index a6bc91f1..00c418d7 100644 --- a/docs/getting-started/metadata-providers.md +++ b/docs/getting-started/metadata-providers.md @@ -99,7 +99,7 @@ You must run a LaunchBox metadata update (either manually, or scheduled via cron ### Hasheous -[Hasheous](https://hasheous.org/) is a free, open-source metadata provider that uses file hashes to match games. It proxies IGDB data for titles, descriptions, and cover art, and can provide Retroachievements IDs for matched games. +[Hasheous](https://hasheous.org/) is a free, open-source metadata provider that matches games by file hash (MD5, SHA1 and CRC). It proxies IGDB data for titles, descriptions, cover art and screenshots, and adds region and language tags from the matched dump. RetroAchievements matches come from RomM's own hash lookup, not from Hasheous (see [RetroAchievements](#retroachievements)). Set `HASHEOUS_API_ENABLED=true` in your environment variables, and future scans will start using the [Hasheous API](https://hasheous.org/swagger/index.html). @@ -127,6 +127,12 @@ Achievements are displayed from [RetroAchievements](https://retroachievements.or Copy the key shown and use it to set `RETROACHIEVEMENTS_API_KEY` and perform a `UNMATCHED` scan targeting the platform you want to match with RetroAchievements. +Matching is hash-only: RomM computes each ROM's RetroAchievements hash with RAHasher and looks it up in RetroAchievements' list of compatible hashes. This needs the RetroAchievements API key and hash calculation, which is on by default (see [`filesystem.skip_hash_calculation`](../reference/configuration-file.md#filesystemskip_hash_calculation)). + + +!!! note "Disc images inside archives" + On disc-based platforms (PSX, PS2, Saturn, Sega CD, Dreamcast, PSP, Wii and others), RomM can't compute a RetroAchievements hash for a disc image inside a zip, 7z, rar or tar archive, so a scan won't match those ROMs. CHD and uncompressed images (bin/cue, ISO) work. You can still match them manually or add an `(ra-12345)` [filename tag](#metadata-tags-in-filenames). A fix is tracked in [rommapp/romm#4967](https://github.com/rommapp/romm/issues/4967). + After that, each user needs to set their own username in their profile and sync it with RetroAchievements. A new `Achievements` tab will appear in the `Personal` tab in the game details. To avoid unnecessary API calls, a cached file with the RA database is stored locally. Refresh time for that cache file can be changed with the environment variable `REFRESH_RETROACHIEVEMENTS_CACHE_DAYS`. From 69142ce6705c81ed5edad3eb5e075299eb2b617a Mon Sep 17 00:00:00 2001 From: Sam Dornan Date: Wed, 30 Sep 2026 15:37:28 +0000 Subject: [PATCH 2/3] Drop the Hasheous note about RetroAchievements matching Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01FoxH511V1d31hAA2tWvw3Q --- docs/getting-started/metadata-providers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/metadata-providers.md b/docs/getting-started/metadata-providers.md index 00c418d7..dcfb156b 100644 --- a/docs/getting-started/metadata-providers.md +++ b/docs/getting-started/metadata-providers.md @@ -99,7 +99,7 @@ You must run a LaunchBox metadata update (either manually, or scheduled via cron ### Hasheous -[Hasheous](https://hasheous.org/) is a free, open-source metadata provider that matches games by file hash (MD5, SHA1 and CRC). It proxies IGDB data for titles, descriptions, cover art and screenshots, and adds region and language tags from the matched dump. RetroAchievements matches come from RomM's own hash lookup, not from Hasheous (see [RetroAchievements](#retroachievements)). +[Hasheous](https://hasheous.org/) is a free, open-source metadata provider that matches games by file hash (MD5, SHA1 and CRC). It proxies IGDB data for titles, descriptions, cover art and screenshots, and adds region and language tags from the matched dump. Set `HASHEOUS_API_ENABLED=true` in your environment variables, and future scans will start using the [Hasheous API](https://hasheous.org/swagger/index.html). From 7c9cb3736e562b19afc9d260731e91c1b9ab853f Mon Sep 17 00:00:00 2001 From: Georges-Antoine Assi <3247106+gantoine@users.noreply.github.com> Date: Sun, 4 Oct 2026 10:03:49 -0400 Subject: [PATCH 3/3] Update docs/getting-started/metadata-providers.md --- docs/getting-started/metadata-providers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/metadata-providers.md b/docs/getting-started/metadata-providers.md index dcfb156b..16541eb7 100644 --- a/docs/getting-started/metadata-providers.md +++ b/docs/getting-started/metadata-providers.md @@ -131,7 +131,7 @@ Matching is hash-only: RomM computes each ROM's RetroAchievements hash with RAHa !!! note "Disc images inside archives" - On disc-based platforms (PSX, PS2, Saturn, Sega CD, Dreamcast, PSP, Wii and others), RomM can't compute a RetroAchievements hash for a disc image inside a zip, 7z, rar or tar archive, so a scan won't match those ROMs. CHD and uncompressed images (bin/cue, ISO) work. You can still match them manually or add an `(ra-12345)` [filename tag](#metadata-tags-in-filenames). A fix is tracked in [rommapp/romm#4967](https://github.com/rommapp/romm/issues/4967). + On disc-based platforms (PSX, PS2, Saturn, Sega CD, Dreamcast, PSP, Wii and others), RomM can't compute a RetroAchievements hash for a disc image inside a zip, 7z, rar or tar archive, so a scan won't match those ROMs. CHD and uncompressed images (bin/cue, ISO) work. You can still match them manually or add an `(ra-12345)` [filename tag](#metadata-tags-in-filenames). After that, each user needs to set their own username in their profile and sync it with RetroAchievements. A new `Achievements` tab will appear in the `Personal` tab in the game details.