This userscript automatically adds download links for supported ROMs on RetroAchievements.org "Supported Game Files" pages. It uses hash information to inject direct download links for supported ROM files.

Note: Please ensure you comply with RetroAchievements’ policies and the legal framework in your region when using this tool.

• Linked Hashes: 35,887
• Missing Hashes: 5,174

• Respect RA Policies: Do not post ROM links on RetroAchievements’ website or Discord.
• ROM Legality: Only access ROMs you legally own. Downloading ROMs without owning a physical copy may violate copyright laws.
• Game Preservation: This tool supports video game preservation, but always respect developers’ and publishers’ rights.
• No File Hosting: The script does not host ROMs; it only links to them, similar to a search engine.
• By using this script, you agree to comply with all relevant laws.

• Myrient Links: Due to Myrient changes, download requests open the website and search for the filename before downloading.
• Archive.org Links: Some files rely on Archive.org. Stay signed in to access them.
• Rezi Search Links: For games with unmatched hashes, the script provides a Rezi search link so you can quickly attempt to manually locate the correct ROM.
• Game ID Changes: RetroAchievements occasionally recycles game IDs. Report any issues here or submit a pull request to update hashlinks.json.
• Update Cycle: The script checks for updates once every 24 hours if the repository has changed.
• Manifest V3: Chromium browsers (Chrome, Edge, Opera) may face userscript compatibility issues. You may need developer mode enabled. Firefox is recommended for best results.

TamperMonkey lets you run custom scripts in your browser.

• TamperMonkey FAQ
• Chrome Extension
• Firefox Add-On
• Safari Extension

Alternative: ViolentMonkey or FireMonkey can also be used.

1. Open TamperMonkey → Dashboard → Utilities → Install from URL.
2. Paste this URL: https://github.com/MentalBlank/RARomOnHashesUserScript/raw/refs/heads/main/TamperMonkeyRetroachievements.js
3. Click Install.

✅ Ensures automatic updates whenever the script changes.

1. Open TamperMonkey → Dashboard → Add a new script (or click +).
2. Copy the entire script into the editor.
3. Save (File > Save or Ctrl + S / Cmd + S).

• Refresh any RetroAchievements.org “Supported Game Files” page.
• Wait for the page to load and links to appear.

Note: See the following "Troubleshooting" section if links don’t appear.

• Ensure the script is enabled in TamperMonkey.
• Make sure the page fully loads before the script runs.
• Open the browser’s developer console to verify the script is running: "RA Rom Download Script running."
• Confirm linked hashes at hashlinks.json.

Pull requests from the community are welcome. When updating hashlinks.json:

• Ensure the JSON is valid.
• Remove matching hashes from missinghashes.json if applicable.

• Wholee: RA dump and original script this project was based on.
• Erista Group & Myrient Teams: Preservation efforts.
• RetroAchievements Team: Platform and emulation support.
• All Users: Thank you for using and testing this script!