CTR2WUP

Experimental 3DS-to-Wii U static recompilation. The goal is a Windows injector that creates an individual WUP title, with the top screen on the TV and the bottom screen, touch and controls on the GamePad.

Commercial games, playable-game conversion and the Windows GUI are not available yet. Current builds provide developer tools and original homebrew diagnostics. Super Mario 3D Land is the first planned compatibility target.

Documentation · Downloads · Project graph · Development plan · Issues · Contributing

Project progress

Updated hourly from the Project. Open the graph for interactive task details and dependencies.

Capabilities

• Bounded container inspection, optional local decryption and verified asset preparation.
• ARM/Thumb/VFP translation foundations and checked guest memory/services.
• Original compiled guests with dual screens, input, SD saves and assets.
• Checked GSP/PICA processing, experimental GX2 shaders/textures and CSTM/ADPCM mixing.
• Reproducible RPX/WUHB diagnostics and independently verified original WUP candidates.

See compatibility for supported inputs, runtime limits and hardware validation scope.

Use or build

For original diagnostic downloads, follow getting started and the single guide inside the chosen package. SD files can be copied by FTP. Test instructions and return-folder details ship with each package.

Host development needs Python 3.12+, GNU Make and a C compiler:

python3 -m venv .venv
. .venv/bin/activate
python3 -m pip install -e '.[packaging,decryption]'
make help
make check

Contributing covers native SDK setup and validation; Windows builds covers the Windows toolchain.

Source map

Path	Purpose
host/	PC inspection, preparation, builds and packaging
translator/	AOT integration and generated-code boundary
renderer/	Host graphics preparation
runtime/core/	Portable guest CPU, services, graphics and audio
runtime/wiiu/	Native Wii U platform and adapters
tests/	Original fixtures, reference checks and hardware records
tools/	Build, validation and package generators
docs/	Usage and technical contracts
plans.md	Next development steps and milestone links

Generated output belongs in ignored artifacts/; ROMs, keys and derived game data stay in ignored private/. Never attach private game data to public issues.

License

MIT. Dependencies retain their own licenses; see THIRD_PARTY_NOTICES. Builds use devkitPro, WUT and libctru. The planned injector workflow is inspired by UWUVCI AIO.