What rom-weaver supports
rom-weaver works with game files you already have. It can change them, make them smaller, identify them, and test supported games.
The browser needs no account or installation. The CLI is the terminal version, useful for scripts and large jobs. Both process files on your device.
Change a game
| Feature | In plain words | Browser guide | CLI guide |
|---|---|---|---|
| Apply patches | Combine your game with someone else's changes, such as a translation. | Apply | Apply |
| Create patches | Compare an original file with your edited file to make a patch. | Create | Create |
| Ordered patches | Run several changes in order, with input and output checks when available. | Patch order | Patch chains |
| Cheat codes | Bake supported codes into a ROM, or turn them into a patch. | Cheats | Cheats |
| Patch weaves | Package patches with their order, names, choices, and expected ROM checks. | Weaves | Weaves |
Applying and creating have different format limits. The patch format table lists both, including Dreamcast DCP, which rebuilds a whole GD-ROM disc in the browser or the CLI.
Cheat support covers writes to the ROM. Codes that need live game memory cannot be baked. The cheat reference lists supported systems and matching limits.
Check and prepare files
| Feature | In plain words | Browser guide | CLI guide |
|---|---|---|---|
| Identify | Match a file's fingerprint to a known game, region, and revision. Search by name or checksum without a file, too. | Identify | Identify |
| Checksums | Calculate a fingerprint to compare two files, even if their names differ. | Checksum a file | Hash files |
| Extract | Take files out of an archive or disc image. Nested archives are supported. | Extract files | Extract files |
| Compress and convert | Put a ROM into a smaller container, or change its container. This does not port a game to another console. | Extract or compress files in the browser | Archives and disc images |
| Trim | Remove padding from supported files, or restore it. Padding is space around the useful data. | Trim and restore padding | Trim and restore padding |
| Headers and byte order | Handle supported dump layouts so patches receive the bytes they expect. | Resolve layout differences | Header options |
| M3U playlist | Write an .m3u for a multi-disc game, ordering discs from names such as Disc 1 and .disc02, alone or in a ZIP with the discs. |
Not in the browser | Playlist |
| PPF undo | Restore bytes saved inside a PPF3 patch that includes undo data; unpack ROM and patch inputs and compress the restored output. | Undo PPF | Tools |
The browser's Extract tool downloads selected files, or several files as one ZIP. The CLI also creates archives from directories.
The format reference owns the complete container, codec, checksum, trim, and header tables. Reading a format does not imply creating it.
Play and manage saves
| Feature | In plain words | Availability |
|---|---|---|
| Test a ROM | Play a supported game or check a patched result with the built-in emulator. | Browser only; supported systems |
| Store and export emulator saves | Keep progress in this browser and download a backup for another device. | Browser only |
| Edit a game save | Change supported properties in the game's saved progress, then download a separate copy. | Browser and CLI |
| Create a game save | Make a fresh supported save, or use an existing save as a template. | Browser and CLI |
The Save Editor reference lists the exact games, layouts, fields, and generation limits. A game save and an emulator save state are different files. The editor does not edit save states.
Patching support, emulator support, cheat support, and save editing support are separate. A console can have patch support without a browser emulator or save editor.
App and automation
| Feature | Support and limits |
|---|---|
| Offline use | The offline copy caches the app, every emulator core, and selected databases. Remote links and unselected databases need a connection. Offline setup. |
| Browser preferences | Theme, accent, language, byte units, guided help, output defaults, compression settings, and worker threads. Settings. |
| Guided practice runs | Step-by-step cards for Apply, Create, Weave, Test, and the two cheat workflows, using homebrew practice files. Guided Apply waits for you to add files. Guided practice runs. |
| Beta tools | Save Editor is behind the browser's beta setting. Trim, PPF Undo, and cheat tools in Apply, Create, and Identify are available without it. |
| Scripts and pipelines | The CLI has file selection, dry runs, standard input/output, JSON results, JSON event streams, shell completions, and man pages. CLI reference. |
| Hosting and integration | Static or Docker hosting, subpaths, URL-loaded ROMs and patches, weaves, and same-origin file integration. Hosting, integration. |
There is no account, cloud synchronization, or ROM download library. The supplied practice files are homebrew samples. Privacy lists storage and network behavior.