rom-weaver documentation

Start with the browser. Nothing needs to be installed, your files stay on your device, and the guided samples let you learn with tiny homebrew ROMs.

Use Browser usage for visual, step-by-step workflows. It explains the basics and includes a safe practice run. Then open the Browser usage section below and pick the guide for your task.

Use CLI usage for terminal commands, scripts, batch jobs, and CI. You can also jump straight to CLI installation or self-hosting the webapp.

Quick answers

Read the full FAQ

Do my files get uploaded?

No. The webapp reads, patches, and writes files on your device.

Which patch format should I use?

Applying a patch? Use the file you were given. Creating one? BPS is a good cartridge default.

Why does my ROM not match?

The region, revision, header, byte order, archive entry, or patch order differs from the author's file.