rom-analyzer

Crates.iorom-analyzer
lib.rsrom-analyzer
version1.1.0
created_at2025-12-10 08:11:13.589884+00
updated_at2025-12-17 17:12:33.979294+00
descriptionA CLI tool for analyzing console ROM file headers.
homepage
repositoryhttps://github.com/Pobega/ROM-Analyzer
max_upload_size
id1977662
size224,955
Pobega (Pobega)

documentation

README

ROM Analyzer

A command-line tool written in Rust that analyzes ROM files (including those in .zip and .chd archives) to identify their region based on file headers.

Features

  • Region Identification: Accurately determines the geographical region of various game ROMs.
  • Archive Support: Supports analysis of ROMs within .zip and .chd archives.
  • Wide Console Support: Compatible with a broad range of classic gaming console ROMs.

Supported Consoles

The rom-analyzer currently supports ROMs for the following systems:

  • Game Boy (GB)
  • Game Boy Advance (GBA)
  • Game Gear
  • Master System
  • Nintendo 64 (N64)
  • Nintendo Entertainment System (NES)
  • PlayStation (PSX)
  • Sega CD
  • Sega Cartridge (general)
  • Super Nintendo Entertainment System (SNES)

Installation

To build and install rom-analyzer, you'll need Rust installed on your system.

git clone https://github.com/your-repo/rom-analyzer.git
cd rom-analyzer
cargo build --release
cargo install --path .

This will compile the project and install the rom-analyzer executable to your Cargo bin directory, making it available in your shell's PATH.

Usage

To analyze a ROM file or an archive containing ROMs, simply run:

rom-analyzer <path-to-rom-or-archive>

Example:

rom-analyzer "MyGame (USA).zip"
rom-analyzer "AnotherGame.chd"
rom-analyzer "SingleRom.nes"

The tool will output the identified region for the ROMs found.

Contributing

Contributions are welcome! Please feel free to open issues or submit pull requests.

License

This project is licensed under the MIT License.

Commit count: 0

cargo fmt