Repository navigation
Releases
decomp.wtf v0.24.0
decomp.wtf 0.24.0
This release expands experimental Nintendo Switch source exports and adds folder-backed disc assets for eligible PlayStation 2 projects.
Nintendo Switch
- Recover more AArch64 call and branch targets, including guarded jump tables, SDK startup callbacks, exception landing pads, and
setjmpcontinuations. Improve linking for stripped modules and reviewed link profiles. - Expand desktop runtime support for SDK startup, offline accounts and networking, audio, input, saves, and applets. Windows exports support a native software-keyboard dialog and an optional settings handoff to the launcher.
- Correct Maxwell and Vulkan texture handling, viewport winding, depth bias, and rendering state. Add VP8 video decoding and optional cubic presentation scaling.
- Reduce overhead in native entry checks, draw submission, and frame presentation. Improve frame pacing and add optional build and presentation tuning.
Switch exports remain experimental. The Windows workflow runs original CPU, module, and desktop fixtures. Retail compatibility varies by title, and physical hardware coverage and adaptive geometry remain limited. Switch workflow guide
PlayStation 2
- Stage files from an extracted DVD tree with
tools/extract_assets.py --directory. The helper verifies each file against the export's SHA-256 inventory and retains the original disc sector addresses. This works for eligible 2048-byte-sector DVD exports with complete file inventories. - Existing image-backed projects can continue to use their disc images. Existing game builds and saves remain in their own projects.
Download decompnet-0.24.0-windows.zip, extract it, and run windows.cmd. The wheel, source distribution, installers, and SHA256SUMS are also attached.
Windows operational verification:
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/42524441073
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/42524437390
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/42524434170
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/42524431253
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/42524428019
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/42524424506
Tested commit: 58116cdd398a6099894470d556cd15797621c768.
decomp.wtf v0.23.0
decomp.wtf 0.23.0
This release adds an experimental Nintendo Switch workflow that translates AArch64 code into editable C. It accepts owner-extracted ExeFS modules, standalone NSO files, and homebrew NRO files. The desktop export includes the Kirikae service and Vulkan runtime sources and reports missing native targets.
decomp pc switch-inspectinspects an input and reports its module layout.decomp pc switch-probeexports a small CPU test project.decomp pc switch-runtimeexports linked ExeFS modules with a limited set of host services.decomp pc switch-native INPUT OUTPUT --experimentalexports a desktop source project. Rust 1.90 or newer is required for source generation. See the Switch workflow for build requirements and fixture commands.
Switch desktop execution was qualified on Linux x86-64 with original test programs. Windows desktop execution, adaptive presentation, and retail gameplay remain unqualified. The Windows release checks cover the app and the existing Game Boy Advance, Nintendo DS, Nintendo 3DS, PlayStation, and PlayStation 2 backends. The clean-install smoke test also checks Switch source checksums in the wheel and Windows ZIP.
Download decompnet-0.23.0-windows.zip, extract it, and run windows.cmd. The wheel, source distribution, installers, and SHA256SUMS are also attached. Existing generated projects keep their source snapshots and game data.
Windows operational verification:
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41913472948
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41913468554
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41913463884
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41913458747
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41913453645
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41913448035
Tested commit: 6726c3a0cd283d10111a04a0bd7643c2f59fca85.
decomp.wtf v0.22.0
decomp.wtf 0.22.0
This release expands graphics, audio and controls in generated desktop projects and improves native execution across all five supported platforms.
Game Boy Advance
- Add saved graphics options for scaling, color and fullscreen. Add optional band-limited audio playback with saved settings.
Nintendo DS
- Add saved audio and graphics controls. Keep animated HUD anchors separate from world overlays in enhanced views.
- Export supported enhanced cartridges in original DS (NTR) mode while retaining the complete input image. Improve startup and ARM7 recovery, cartridge capacity mapping, protected reads and infrared cartridge identification. Compatibility with enhanced cartridges is limited to their NTR execution path.
- Improve guarded Thumb dispatch, stack-restored ARM exits and callback recovery. Add reviewed native instruction alternatives and bounded cheat programs for project settings.
PlayStation
- Improve native execution through overlays, copied code, loaded libraries, relocated callbacks and instruction-cache resume entries. Correct zero-register writes in delay slots and support additional OpenBIOS exception continuations.
- Add native cheat settings and guarded instruction variants. Route quick keyboard taps and scripted controls through the same pad sampling path.
- Add desktop graphics and audio controls and preserve the full mix in enhanced audio. Disable unqualified native snapshots while retaining in-game saves and persisted disc selection.
PlayStation 2
- Improve native VU program generation and dispatch, including guarded ahead-of-time VU1 programs and more efficient Windows x64 vector operations.
- Reduce allocations and redundant work in VIF unpacking, DMA chains, GIF packets and GPU staging. Add an optional ordered VIF1 GIF frontend worker and improve ordered GS worker behavior.
- Add reviewed cheat alternatives and guest-frame input commands. Correct EE callback stack lifetime and Windows source export and command-file handling.
Nintendo 3DS
- Add desktop presentation and audio controls, optional texture packs and per-frame HID input publication.
- Recover more ARM and Thumb code paths, including interworking calls, relative jump tables, constructor callbacks, VFP fragments and loop edges. Apply guarded cheat instruction patches to loaded CRO copies.
- Improve offline socket, access-control and UDS behavior. Add room interface selection, the
GetHandleInfosupervisor call and silent microphone sampling for software that expects a microphone service.
Existing generated projects retain their own source snapshots. To use the new backend behavior, update or regenerate the project and validate its game-specific customizations.
The release gate checks the Windows application and all five native backends at the exact release commit. A separate clean Windows installation checks the packaged wheel, CLI, local web app and API. Game compatibility remains experimental and varies by title.
Download decompnet-0.22.0-windows.zip, extract it and run windows.cmd. The wheel, source distribution, installer scripts and SHA256SUMS are also attached. The packages contain the tool and its fixtures. Supply your own game inputs for export.
Windows operational verification:
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41790030280
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41790026827
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41790022649
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41790019766
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41790016382
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41790013188
Tested commit: acee7dd6bf398885050669866ffae4e1a748b648.
decomp.wtf v0.21.0
decomp.wtf 0.21.0
This release brings the shared GBA and Nintendo DS export, runtime and desktop
improvements developed during the recent game builds into a new installable
release. DS, PS1, PS2, GBA and 3DS remain the supported native PC output targets.
Game Boy Advance
- Split large dispatch registries into bounded source fragments so generated
projects stay within GitHub's individual-file limits. - Improve bounded Thumb switch and packed callback discovery, including leaf
callbacks and valid tables following rejected pointer-shaped data. - Add an exact-ROM callback inventory audit to catch required missing entries
and ARM/Thumb mode mismatches before compiling an export. - Add an in-window cheat browser with project-provided catalogs, categories,
exclusive choices and per-save preferences, plus optional native project
hooks. Unsupported instruction-patching device codes remain rejected. - Sample live controls after rendering and frame pacing, and correct mirrored
cheat addresses, odd-size pixel selection and desktop stack allocation.
Nintendo DS
- Improve module-qualified overlay and ARM7 callback recovery, mutable literal
handling, verified protected-function boundaries and recovery ordering.
Exclude packed ARM7 autoload payloads from executable recovery. - Correct shared-frame Thumb long branches and loop conditions, signed range
guards, register-preservation checks and live jump-table selector bounds. - Support reviewed callback reference bounds tied to exact decoded-module
hashes, and consolidate overlapping dispatch regions before emission. - Extend GPU rendering for fog, outlines, shadows, depth-equal surfaces and
translucency, with filtered downsampling and up to 12x internal resolution.
Preserve captured scene origins through LCD brightness and correct sloped
raster boundary pixels when antialiasing or edge marking is active. - Add optional dynamic widescreen with separate geometry and UI placement.
Follow-up fixes preserve battle panels, cinematic framing, startup menus,
world overlays, HUD controls and stable captions as text reveals. Reuse GPU
textures and uniform locations to reduce presentation overhead. - Add optional original-score audio cleanup with 16-bit host output and causal
sampled-instrument interpolation, while preserving guest sample reads,
channel timing and capture/reverb writes. Hardware output remains the default.
Reduce desktop sound buffering without clearing sound already queued. - Preserve brief keyboard taps and ordered releases, clear consumed modal
inputs, keep scripted touch active and use drawable dimensions for high-DPI
settings captures. - Add optional project-owned feature hooks independent of cheat menus, and
improve offline wireless register, interrupt and power-state behavior.
Wireless packet transport is not implemented.
Existing projects and validation
Existing generated projects retain their own source snapshots and customizations.
Adopting a newer exporter or runtime requires an explicit project update and
validation; this release does not automatically regenerate existing games.
Title-specific cheats, cameras, event content, mobile assets and other game
enhancements remain in their separate projects.
The release gate requires successful Windows application and all five native
backend qualification workflows on the exact main-branch release commit.
Package publication additionally builds the wheel, source distribution and
Windows source/install ZIP, then installs the wheel in a clean Windows
environment and checks the CLI, application and API.
Compatibility remains experimental and game-specific. Original fixtures and
bounded gameplay checks do not certify a complete playthrough. No game ROMs,
BIOS dumps, saves or generated retail game source are included.
For Windows, download decompnet-0.21.0-windows.zip, extract it and run
windows.cmd. The wheel, source distribution, installer scripts and
SHA256SUMS are also attached.
Windows operational verification:
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41385737658
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41385735683
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41385733550
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41385731556
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41385729463
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41385727422
Tested commit: fbb6f3630333dab04162fe1521904bed040fbb42.
decomp.wtf v0.20.1
decomp.wtf 0.20.1
This patch release fixes DS shared-return translation exposed by Dragon Quest
IV's Chimera Wing travel and repairs fresh DS runtime-source installation.
- Recognize balanced compiler entry/exit instrumentation around a shared Thumb
return. A BL into the enclosing function's return sequence consumes that
function's saved frame and must not resume after the BL. Emit a local jump or
an actual tail call, without a returning-call check against the BL continuation. - Add original ARM/Thumb fixtures checking local and separately outlined shared
returns, saved registers, caller stack balance, both branch paths and helper
execution. Runtime return checks remain enabled in dedicated regressions.
Malformed stack-restoration sequences are still rejected. Ordinary nested
function calls continue to return normally. - Update the checksum-pinned DS runtime download to the repository's canonical
dq9-remastered/DQ9-Remasteredlocation. Its commit remains unchanged; the
renamed archive was verified against all 389 pinned Git file blobs.
The exact owner-side DQIV function was also re-emitted successfully with the
generic correction. No game addresses, ROM bytes, saves, or private game output
are included in this release. DQIV's widescreen camera and menu enhancements
remain in its separate game project. Existing generated projects keep their
source snapshot; this release does not rewrite them automatically.
For Windows, download decompnet-0.20.1-windows.zip, extract it and run
windows.cmd. The wheel, source distribution, installers and SHA256SUMS
are also attached. Compatibility remains experimental and title-specific;
these bounded regressions do not establish a full-game playthrough.
Windows operational verification:
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41008986065
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41008983567
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41008981477
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41008977948
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41008975543
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/41008973122
Tested commit: 528de05abdd48425f5dce5302bae4e1098b94819.
decomp.wtf v0.20.0
decomp.wtf 0.20.0
This release focuses the local workbench on editable native PC source projects
for DS, PS1, PS2, GBA and 3DS. It includes the current main-branch work since
0.19.0 and the shared runtime fixes found while adapting Dragon Quest IV.
- Export game code, a source runtime, build configuration and owner-side asset
preparation tools. Generated projects support GPU rendering, window resizing,
keyboard/controller input and persistent saves, with platform-specific limits
recorded in the project and qualification reports. - DS includes ARM9/ARM7 static output and graphics/audio integration; PS1 supports
ordered multi-disc games in one source project; PS2 includes EE/IOP/VU source
paths; GBA includes ARM/Thumb desktop output; 3DS includes ARM/Thumb/VFP source
and its bundled runtime. See the README for exact accepted input formats. - Keep DS/3DS dual-screen presentation in the generic output; game-specific
combined widescreen adaptations belong in the exported game project. - Remove N64, GameCube, Wii and GB/GBC from the supported console scope and GUI.
Remove public/collaboration controls from the local workbench. Agents remain
optional, with local connection and agent setup instructions in the README. - Correct DS texture state handling, use exclusive save ownership, preserve
queued audio under load, and include runtime patch inputs in backend identity. - Update the repository front page, GUI screenshot, setup/download documentation
and Windows-only automated CI. Linux source builds remain a manual option. - Update both installers to 0.20.0 and require exact-commit Windows application
and all five native-output qualification workflows before publication.
For Windows, download decompnet-0.20.0-windows.zip, extract it and run
windows.cmd. The wheel, source distribution, installer scripts and
SHA256SUMS are also attached. Toolchains and optional runtime sources are
downloaded separately with their recorded checksums and licenses.
ROMs, BIOS/firmware, mobile recordings and private game outputs are not included.
A generated PC project is the starting point for a port: unfamiliar games can
still require recovery fixes, asset mapping and game-specific presentation work.
Original fixtures and bounded retail checks do not establish full compatibility
or a complete playthrough for every game. Physical GPU/audio/controller results
apply only to the hardware and scenarios recorded in their assessments.
Windows operational verification:
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/40932149135
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/40932141143
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/40932136204
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/40932132148
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/40932127035
- https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/40932121629
Tested commit: cc164e5442c3996b4e0504e2dae46ba290e3c555.
decomp.wtf v0.19.0
decomp.wtf 0.19.0
This release brings the completed native Windows compiler paths and the first
GB/GBC assembly workflow onto the main release channel. Windows runs without
WSL. The full Linux compiler suite is checked on Ubuntu 24.04 x86-64 (MIPS
binutils needs glibc 2.38 or newer; older 32-bit compilers need libc6-i386).
- PS2 uses verified native hosts of the original EE-GCC 2.96 C/C++ compiler,
with ordinary pinned installation, strict matching and byte-exact exports. - N64 IDO 5.3 includes the distinct classic cfront pipeline and cross-unit
template prelinking alongside the original SGI/EDG frontend. - GBA includes separately verified normal and old agbcc C++ frontends, preserving
each original Thumb backend. PS1 and N64 compiler paths retain their native
Windows and Linux validation. - GB/GBC supports browser import, editable RGBDS assembly, local agent claims,
bank-aware byte checking and verified full-ROM exports. This is assembly
verification; mapper analysis, richer layouts and room synchronization remain
experimental or unfinished. It does not produce C/C++ game source. - Fresh Windows/Linux release installs and update checks now use this fork's
GitHub releases. Existing explicitly configured upstream installs retain their
recorded update source. - Fixed a native Windows heap crash when N64 imports ran in background workers.
The shipped analyzer now passes repeated worker creation and teardown checks. - Fixed GameCube build commands and Ninja reconfiguration with tool paths
containing spaces, and target builds from a clean source checkout.
Download decompnet-0.19.0-windows.zip, extract it and double-click
windows.cmd. Linux users can run the attached install.sh. The wheel,
source distribution and SHA256SUMS are also attached. Period toolchains are
downloaded separately with pinned checksums; proprietary compilers retain their
explicit installation step and are not bundled in these release assets.
The operational run checks application workflows, original homebrew fixtures,
compiler matching/export, GameCube and DS project rebuilding, and native Windows
behavior. The actual release wheel is separately installed and checked on both
hosts, including the local web server and authenticated API. Platform-specific
and unavailable private-ROM tests are recorded as skips in the CI results.
Operational verification: https://github.com/OMGitsMatt45/decomp.wtf/actions/runs/39531701023
Tested commit: 11fdfb32c5e9846a6ffe74fc6bc7a2d8f0879f57.
GB/GBC checks also passed on Windows and Linux.