Super Mario Bros. Wonder Recomp

Super Mario Bros. Wonder came out on the Nintendo Switch in October 2023 and has never been released on PC. On 1 October 2026 DSOGaming reported that an unofficial native port was running on Windows on an RTX 3050 laptop, with no release date. BelmanteGu created the public repository on 14 October 2026, and it had more than 350 GitHub stars on 21 October. The README says the project grew out of a wider Switch recompilation effort, SwitchGamesRecomp, which shares the same runtime; we couldn’t open that repository.

This site is not affiliated with BelmanteGu, Projeto Belmante or Nintendo.

What it is

• A static recompilation: the game’s AArch64 machine code is translated ahead of time into C++ and compiled for your machine. Nothing is interpreted while you play.
• NVN on Vulkan: Wonder draws through NVN, Nintendo’s own graphics API. The project reimplements it on Vulkan (on a Mac, Vulkan runs on Metal through MoltenVK). The game’s shaders are translated to SPIR-V ahead of time with the Ryujinx shader translator. The README says the NVN API was worked out from the game’s binaries, with no leaked headers.
• Built from your files: everything made from the game stays in a private folder on your computer. The repository holds no game code, assets, keys or firmware, and no build made from them.
• Made with AI help: the README says most of the code, tooling and documentation were written with Anthropic’s Claude, directed and checked by a human who studied the Switch’s hardware to guide it.

It works like the other console recompilations in our recompiled games list.

Current status

From the README:

• 60 fps in the menus and in course 1-1 in unattended test runs, and a steady 60 fps on an Intel integrated GPU at 720p on Linux;
• ultrawide support that shows more of the level (menus stay 16:9), switched on with a setting;
• a 30 fps mode; there is no real unlock above 60, because the game speeds up;
• several users with a save each, and a choice of the game’s languages;
• an Android build with touch controls, tested on a Galaxy S23.

Known problems: on Windows the game crashes after character select every time for the reporter of issue #5, which was still open on 21 October 2026 (it does not happen on Linux). Windowed play on Windows can drop to 35–40 fps. The README also lists HUD and menu gaps in ultrawide, and rendering bugs and memory pressure on Android; several open issues report black screens on phones with Mali GPUs. Much of the project’s history was lost when moving between computers, the README notes, so some files mentioned in its docs no longer exist. We didn’t play the game through ourselves.

What you need

• Your own copy of Super Mario Bros. Wonder, version 1.0.0, base game with no update, plus your own console’s keys and firmware. The README says it does not explain how to obtain them, and neither do we.
• A computer to build on: an Apple silicon Mac, or Windows 10/11 or Linux on x86-64 with a Vulkan 1.3 GPU (tested with an NVIDIA RTX 3050 and Intel graphics).
• Developer tools: Python, CMake, Ninja, a C++ compiler, the Vulkan SDK or headers, SDL 3 and the .NET SDK, depending on the platform. The recompiled code is about 1.4 GB of C++, and the game uses 3.5 to 4.2 GB of memory while playing.

How to install

There is no installer. At a high level, from the official README and its build guide: clone the repository, set up the build tools, then import your own game files into the project’s private folder, recompile the game’s code, translate its shaders, build the button font, and compile the program. On a Mac the code recompile takes about 6 minutes and the first build about 15 more. The README covers macOS, Windows, Linux and Android separately. The Android package you build contains code from your own copy; the README asks you never to share or publish it.

Other Super Mario Bros. Wonder projects

We know of no other PC port of Super Mario Bros. Wonder. The Switch 2 edition from March 2026 is also console-only.

Is it legal and safe?

• It is an unofficial fan project, not affiliated with, endorsed by or sponsored by Nintendo. The README says no game files, game code, assets, keys, firmware or fonts are included in the repository.
• Use only files from a copy you own, and keep what you build for yourself.
• Get the code only from the official GitHub repository. Since there are no releases, any “download” of a ready-to-play Wonder PC port is not from this project.

More Switch games on PC: Zelda: Link’s Awakening, Super Smash Bros. Ultimate, Bayonetta 2. More Mario: Super Mario Galaxy on PC.

Unofficial. This page is written by an independent directory. It is not made by, endorsed by or affiliated with Nintendo (developed by Nintendo EPD) or BelmanteGu (Projeto Belmante) (Super Mario Bros. Wonder Recomp's author). We do not host any files, and we never link to game files, ROMs or ISOs.