# decomp-permuter

> Randomly or systematically permutes one C function, recompiling each variant and scoring it against a target object file to search for matching compiler output. PERM macros specify manual alternatives, and the optional permuter@home mode distributes runs to other workers.

- Type: Tool
- Targets: Binary · Game
- Category: Game analysis tools
- Relationship: Foundation tool
- Sources reviewed: 2026-10-17
- Added to the catalog: 2026-10-17
- Original resource: <https://github.com/simonlindholm/decomp-permuter>
- Primary source: <https://github.com/simonlindholm/decomp-permuter/blob/8556c81d80d1c1af98a858c8f4dc951357f29139/README.md>
- Catalog page: <https://awesomerea.org/resources/decomp-permuter/>
- Record JSON: <https://awesomerea.org/resources/decomp-permuter/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/decomp-permuter/index.md)

## Requirements & limits

- Each input directory needs a single-function .c file, the target .o, a project-specific compile script and a settings .toml; import.py can generate them for configured Make or Ninja projects. The README lists MIPS (IDO, possibly GCC), PowerPC and ARM32 assembly.
- Requires Python 3 and toml; pynacl and Levenshtein are optional. permuter@home needs access granted by an existing network member, supports a limited compiler list and does not run on native Windows; workers also need Docker.
- A zero score means the scored disassembly matches. The README warns that random passes often find nonsensical changes, so a human must still choose readable, non-overfitted code; the tool does not recover names, types or semantics.
- MIT license. No packaged release; last commit at review: 2026-10-06.

## Primary sources

1. <https://github.com/simonlindholm/decomp-permuter/blob/8556c81d80d1c1af98a858c8f4dc951357f29139/README.md>
2. <https://github.com/simonlindholm/decomp-permuter/blob/8556c81d80d1c1af98a858c8f4dc951357f29139/LICENSE>

## More in Games

- [asm-differ](https://awesomerea.org/resources/asm-differ/index.md) · Tool
- [UE Explorer](https://awesomerea.org/resources/ue-explorer/index.md) · Tool
- [GARbro](https://awesomerea.org/resources/garbro/index.md) · Tool
- [Godot RE Tools](https://awesomerea.org/resources/godot-re-tools/index.md) · Tool
- [UE4SS](https://awesomerea.org/resources/ue4ss/index.md) · Tool
- [FModel](https://awesomerea.org/resources/fmodel/index.md) · Tool

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.