Skip to main content

One Stop ROM Shop

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

romsearch-0.3.1.tar.gz (506.0 kB view details)

Uploaded Source

Built Distribution

romsearch-0.3.1-py3-none-any.whl (208.5 kB view details)

Uploaded Python 3

File details

Details for the file romsearch-0.3.1.tar.gz.

File metadata

  • Download URL: romsearch-0.3.1.tar.gz
  • Upload date:
  • Size: 506.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for romsearch-0.3.1.tar.gz
Algorithm Hash digest
SHA256 5a9745ca1e86f0be690c5099c1c9c46eda81d94c2d98f6626dc1bd864a447cfc
MD5 f160c96f6bd27ebbe700e9bf321c2568
BLAKE2b-256 e1e6c9c8685b5800c7f004f8a23a4c442792dc1419292ae12b8afcf24c7b57a4

See more details on using hashes here.

File details

Details for the file romsearch-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: romsearch-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 208.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for romsearch-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 775d6171c1facd6c3e83e0fe8b64dbf2c6ba095376b4447dfb720c4de995f96b
MD5 a8d78d8ecdfa8f75667910eef2d76567
BLAKE2b-256 0511336914cbcf6b13163a03edee791c6ad2b1f4ac0f6543cebc235e5f29742a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page