Skip to main content

ROMSearch

Docs Actions License

ROMSearch

ROMSearch is designed as a simple-to-interface with tool that will allow you to pull ROM files from some remote (or local) location, figure out the best ROM, and move it cleanly to a folder that can imported into an emulator. ROMSearch is supposed to be a one-shot program to get you from files online to playing games (which is what we want, right?).

ROMSearch also has a GUI! Currently only for Windows, but makes setting up configurations simple, and also allows for easy viewing of ROMs grouped into games via the ROMBrowser.

ROMSearch offers the ability to:

  • Sync from remote folder using rclone
  • Parse DAT files as well as filenames for ROM information
  • Provide filename mappings between different DAT files
  • Remove dupes from ROM lists using the excellent retool clonelists
  • Match ROM hashes to RetroAchievements to get compatible ROMs
  • Patch ROM files so RetroAchievements can be enabled
  • Moving files to a structured location, including potentially additional files that may be needed
  • Grouping multi-disc games into a single .m3u playlist
  • File (re)compression to a single-file, supported format
  • Discord integration so users can see the results of runs in a simple, clean way
  • View ROMs grouped into game titles, via the ROMBrowser

To get started, see the documentation. For known issues and workarounds, see the known issues.

Currently, ROMSearch is in early development, and so many features may be added over time. At the moment, ROMSearch works for the following consoles:

  • Nintendo (Handheld)
    • Game Boy
    • Game Boy Color
    • Game Boy Advance
    • Pokemon Mini
    • Virtual Boy
    • Nintendo DS
  • Nintendo (Home)
    • Nintendo Entertainment System
    • Super Nintendo Entertainment System
    • Nintendo 64
    • GameCube
  • Sega (Handheld)
    • Game Gear
  • Sega (Home)
    • Mega Drive/Genesis
  • Sony (Handheld)
    • PlayStation Portable
  • Sony (Home)
    • PlayStation
    • PlayStation 2

but be aware there may be quirks that will only become apparent over time. We encourage users to open issues as and where they find them.

The ROMSearch icon has been created by Freepik - Flaticon.

Metadata

Release files for romsearch 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for romsearch 0.3.1
File Size Uploaded Provenance Actions
romsearch-0.3.1.tar.gz 506.0 kB Without provenance Details for romsearch-0.3.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for romsearch 0.3.1
File Interpreter ABI Platform Actions
romsearch-0.3.1-py3-none-any.whl Python 3 none any Details for romsearch-0.3.1-py3-none-any.whl

Total release size: 714.5 kB

Release files / romsearch-0.3.1.tar.gz

Download URL romsearch-0.3.1.tar.gz
Size 506.0 kB
Tags Source
SHA-256 checksum
How to use checksums
5a9745ca1e86f0be690c5099c1c9c46eda81d94c2d98f6626dc1bd864a447cfc
BLAKE2b-256 checksum
How to use checksums
e1e6c9c8685b5800c7f004f8a23a4c442792dc1419292ae12b8afcf24c7b57a4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.9

Release files / romsearch-0.3.1-py3-none-any.whl

Download URL romsearch-0.3.1-py3-none-any.whl
Size 208.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
775d6171c1facd6c3e83e0fe8b64dbf2c6ba095376b4447dfb720c4de995f96b
BLAKE2b-256 checksum
How to use checksums
0511336914cbcf6b13163a03edee791c6ad2b1f4ac0f6543cebc235e5f29742a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.9

Security for romsearch 0.3.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page