Skip to content

Stop claiming Hasheous supplies RetroAchievements IDs - #162

Merged
gantoine merged 3 commits into
mainfrom
claude/new-session-4p7hrv
Oct 4, 2026
Merged

gantoine merged 3 commits into
mainfrom
claude/new-session-4p7hrv

Conversation

@sdornan

@sdornan sdornan commented Sep 30, 2026 •

Copy link
Copy Markdown
Contributor

Summary

After rommapp/romm#4962 (the fix for rommapp/romm#4959), RomM matches RetroAchievements by hash only and no longer takes RA IDs from Hasheous. The Metadata Providers page still said Hasheous "can provide Retroachievements IDs for matched games".

Changes to docs/getting-started/metadata-providers.md:

  • Hasheous: drops the RA ID claim. It now says Hasheous matches by file hash (MD5, SHA1, CRC), proxies IGDB data (titles, descriptions, cover art, screenshots) and adds region and language tags. This follows the in-app description change ("Hash-based matcher that proxies IGDB data.").
  • RetroAchievements: explains that matching is hash-only. RomM computes the RA hash with RAHasher and looks it up in RetroAchievements' list of compatible hashes. This needs the API key and hash calculation, which is on by default. Links to filesystem.skip_hash_calculation.
  • RetroAchievements: adds a note that on disc-based platforms, disc images inside zip/7z/rar/tar archives get no RA match from a scan. CHD and bin/cue/ISO work, and a manual match or an (ra-12345) filename tag also works.

I searched the rest of the repo for Hasheous near RetroAchievements/RA. The only other mentions say that skipping hashing loses RetroAchievements and Hasheous matching, which is still true, so I left them as they are.

Release timing

This describes behavior from rommapp/romm#4962. Please deploy it with the RomM version that ships that change, not onto an older version's docs.

Checks

  • uv run mkdocs build --strict passes
  • uv run python -m scripts.check_redirects passes
  • I couldn't run trunk check here because its plugin download was blocked. Running prettier 3.5.2 and markdownlint 0.45 on the page directly found nothing new on the changed lines.

AI assistance disclosure

Claude Code wrote this change from a handoff describing rommapp/romm#4959 and #4962. A human should check the wording against the merged RomM behavior before merging.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FoxH511V1d31hAA2tWvw3Q

sdornan and others added 2 commits September 30, 2026 15:36
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 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FoxH511V1d31hAA2tWvw3Q
@sdornan
sdornan marked this pull request as ready for review October 4, 2026 05:57
Copilot AI balanced review requested due to automatic review settings October 4, 2026 05:57

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟢 Approval recommended

The documentation reflects upstream behavior, with only a non-blocking clarification about existing matches remaining.

Review effort: Balanced
Findings: 1 Low severity

Open (1)
What changed in this PR

Updates RomM’s metadata-provider documentation to reflect hash-only RetroAchievements matching.

Changes:

  • Removes the claim that Hasheous supplies RetroAchievements IDs.
  • Explains hashing requirements, archive limitations, and manual matching options.
File Description
docs/​getting-started/​metadata-providers.md Corrects provider capabilities and documents RetroAchievements matching behavior.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/getting-started/metadata-providers.md
Comment thread docs/getting-started/metadata-providers.md Outdated
@gantoine
gantoine merged commit 8cb51b4 into main Oct 4, 2026
4 checks passed
@gantoine
gantoine deleted the claude/new-session-4p7hrv branch October 4, 2026 14:04
@sdornan
sdornan requested a review from gantoine October 4, 2026 14:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants