Skip to content

nandolawson/romoxidizer

Repository files navigation

romoxidizer

Open in Dev Container

This software is used to trim ROMs for Nintendo Game Boy Advance and the future Nintendo DS. It is written entirely in Rust and works on Windows & Linux, regardless of whether the CPU architecture is x86 or ARM. As far as I know, this is the only open-source software of its kind.

⚠ DS ROMs with Nintendo Wifi Connection / Download Play functionality should not be trimmed at this time. ⚠ romoxidizer is currently in early development. Even though the software has been tested, only ROMs for which a backup exists should be processed.

Usage

Pretty simple. Here is an example under Windows:

romoxidizer.exe C:\path\to\rom

Done! The ROM is trimmed.

Compiling

ℹ It is recommended to use the provided Dev Container as it is pre-configured for this project

just, cargo-edit & cross need to be installed via Cargo. Besides of them, you need to install Docker on your system.

Once everything is set up, run just build. If cross-compiling / a release build is desired, the command would be just build release.

Contributing

Anyone who wants to contribute is more than welcome to do so. I would be delighted to learn from the contributions of other users. If you find a bug or have a feature in mind that you think would be useful, please feel free to create a pull request on GitHub. If you decide to fork this project, please make sure to adhere to the license and the contribution guidelines. Your involvement and feedback are highly appreciated!