Skip to content

Working on the decompilation

Sean Ciaschi edited this page Sep 28, 2026 · 1 revision

recomp/conker.us.syms.toml (and mods/syms/) are generated from the decompilation in conker/, which needs its own Linux tools: IDO, which runs through the MIPS binutils, and the Python packages in requirements.txt. On Linux, macOS, or in WSL on Windows, ./build.sh --decomp builds the decompilation too, checks that it rebuilds your ROM's code byte for byte, and regenerates those files from it (recomp/run.sh). The decompilation is a work in progress: about 9% of the code is C so far, and the rest is still the original assembly.

On macOS, --decomp also needs coreutils and mips-linux-gnu-binutils from Homebrew (the script offers to install them). The decompilation comes with two Linux programs, the IDO compiler and a patched gzip that compresses exactly as the original game's did, so the script puts macOS replacements in tools/macos/: IDO's macOS build from ido-static-recomp, and GNU gzip 1.10 built with the same one-line change.

Clone this wiki locally