This is irrelevant to the recompilation, but I'm currently trying to find testers that're willing to test my new Android app out, it's multi-use and turns your phone into a PC once connected to a Monitor, or an Android TV when connected to a TV. If you're willing to test it, friend me at "WitherBlltz" on Discord. This is a Google Play Store Exclusive and doesn't work on IOS (yet)! you may need to pay 5 cents on the Play Store to download the app as a heads up! That was the minimum Google would let me put it as.

support my coffee addiction, and the recompilation/decompilation on my cashapp! $WitherBlitz

NSMB Wii Multiplayer Recompilation

<p align="center"> <a href="https://github.com/WitherBlitz/NSMB-Wii-Multiplayer-Recompilation/releases/latest"><img alt="Android 9+, arm64" src="https://img.shields.io/badge/Android-9%2B%20%C2%B7%20arm64-3DDC84?logo=android&amp;logoColor=white"></a> <a href="https://github.com/WitherBlitz/NSMB-Wii-Multiplayer-Recompilation/releases/latest"><img alt="Windows 10 / 11, x64" src="https://img.shields.io/badge/Windows-10%20%2F%2011%20%C2%B7%20x64-0078D4"></a> <a href="https://github.com/WitherBlitz/NSMB-Wii-Multiplayer-Recompilation/releases/latest"><img alt="Linux, x86-64" src="https://img.shields.io/badge/Linux-x86--64-FCC624?logo=linux&amp;logoColor=black"></a> </p> <p align="center"> <a href="#building-from-source"><img alt="PowerPC static recompilation" src="https://img.shields.io/badge/PowerPC-static%20recompilation-FF9F0A"></a> <a href="https://github.com/patchzyy/Wiicompiled"><img alt="Built on WiiCompiled" src="https://img.shields.io/badge/built%20on-WiiCompiled-8B5CF6"></a> <a href="LICENSE"><img alt="License: GPLv3" src="https://img.shields.io/badge/license-GPLv3-2EA44F?logo=gnu&amp;logoColor=white"></a> </p>

A native port of New Super Mario Bros. Wii for Android phones and Windows and Linux PCs, made with static recompilation.

There's no emulator in the loop, no interpreter, no JIT, no PowerPC anywhere at runtime.

Port made by WitherBlitz with the help of WiiCompiled's code, and was entirely coded by Claude Opus 5.5.

[!IMPORTANT] There are no game files in this project or its releases: no disc image, no levels, music, graphics or sounds. You need your own copy of New Super Mario Bros. Wii (USA, SMNE01, revision 1) and Dolphin on a computer to extract it. The downloads do contain the game's code, translated to native code, the way KartPad's do. See What the downloads contain.

I just want to play

<p align="center"> <img src="docs/screenshots/android-title.webp" alt="New Super Mario Bros. Wii running natively on an Android phone, with the on-screen Wii Remote controls" width="800"> <br>_{Running natively on Android at 60 fps, with the on-screen sideways Wii Remote.} </p>

---

What it does

Runs natively on your phone. The whole game is compiled to ARM64 code ahead of time. It runs at a full 60 fps on a Snapdragon 6 Gen 1 phone.

LAN and Tailscale multiplayer across phones and PCs. On the save file screen, a Couch / LAN button sits at the top right (Couch by default). Switch it to LAN to Create Room (choose how many are playing, then start the room when everyone is in) or Join a room from a list that finds games by itself: on your Wi-Fi, and over the internet on your Tailscale network, phones included. Every device runs the game and only the players' inputs travel, in lockstep. If a player drops, the others get a message instead of a frozen game, and the host keeps the progress. See LAN and Tailscale multiplayer.

Tap the menus. Tap (or click with the mouse on Windows) what you want on the game's menus: the title screen, Select a File, Select Players, the LAN menus, the world map's Menu / Select World / View Map / Items buttons, the pause and + menus and the Save / Don't Save style windows. On the world map, tap a level (or a Toad house, tower or castle) and the player walks there along the paths; tap the one the player stands on to play it. The on-screen controller hides on the main menus and comes back for the game.

Touch controls, tilt and shake. An on-screen sideways Wii Remote (D-pad, 1, 2, A, Shake, + and -) with adjustable opacity and vibration. Turn the phone like a steering wheel to tilt, jolt it to shake. Each can be turned off.

Any aspect ratio, ultrawide included. Original 4:3, 16:9, or Fill, which widens the view to fit your whole screen. On screens wider than 16:9 (ultrawide monitors, most phones) the game really draws wider: levels, the world map and the menus show more to the sides instead of being stretched, and enemies appear at the real edges of your screen.

Native rendering via aurora. The graphics layer is built on aurora, a source-level GameCube & Wii compatibility layer, running on Vulkan (Android) or Direct3D 12 / Vulkan / Direct3D 11 (Windows).

High internal resolution. Render at more than the console's 480 lines, on phones and on PC, or at exactly your screen's own resolution with Match Screen Resolution.

Settings gear. The gear next to the Couch / LAN button on the save file screen opens the game's settings window, and so do Settings in the world map's + menu (under Quick Save) and Settings in a level's pause window (between Continue and Exit Course). Video: Match Screen Resolution, the resolution multiplier (greyed out while matching the screen; on a wide screen each scale comes as "1x (480p)" with black bars or "1x Ultrawide" filling the screen), Show FPS Counter (off by default), Frametime Graph (each frame's time, drawn under the FPS counter; off by default; with V-Sync on it shows how many screen refreshes each frame was up for), Spinning Coins (animated coins and blocks, on by default) and, on Windows and Android, V-Sync (no tearing: the game's clock follows the display's refresh, one frame per refresh at 60 Hz or every third at 180 Hz; off by default on Windows, on by default on Android). On Windows and Linux, Fullscreen: Off, Borderless (a window covering the screen, as F11 toggles) or Exclusive (the game takes over the display); each press moves to the next. Audio: Master, Music and Sound Effects sliders, each with its percentage beside it; drag one (finger or mouse) or move it 5% at a time with left and right. Keybinds: every keyboard control, each changed by picking it and pressing the new key, with Reset Defaults, and Space Smart Spin QoL (on by default): on the keyboard, Space pressed while Mario is in the air spins him, like shaking the remote, instead of pressing 2 (wall jumps, swimming and Yoshi's flutter keep 2; within about a small Mario's height of the ground it is the next jump instead). Language: English, Español or Français, the three languages on the USA disc (Nintendo's own translations); a change applies the next time the game starts.

Leaving the app pauses the game (Android). Switch to another app or go to the home screen and the game stops where it is; come back and it carries on from the same frame. Before it pauses, it also writes the game's own Quick Save of your progress, so if Android closes the app while you're away, the next start puts you back on the world map at the level you were in. Coming back normally deletes that backup again. (With the pause window or the world map's menu open, it pauses without the backup: that menu has Quick Save itself.)

Settings. On Android, Settings on the start menu holds Display (aspect ratio, render resolution, FPS counter, frametime graph, spinning coins, V-Sync, graphics compatibility) and Controls; in the game, the phone's Back gesture offers Start Menu, Leave LAN Game and Quit. On Windows, press F10 for the settings bar. Everything you change is saved and restored next launch.

Updates (Android). Check for Updates under Play on the start menu installs the newest release from this page, with your saves, settings and game files kept. Auto Update (off by default) does it whenever you open the app. The first time, Android asks you to allow installs from NSMBW.

Skip Start Menu. On Android, the app can open straight into the game; Back > Start Menu brings you back.

Tested devices

Device	Chipset	GPU	Android	Result
Samsung Galaxy S26 Ultra (SM-S948U)	Qualcomm Snapdragon 8 Elite Gen 5 for Galaxy (SM8850)	Adreno 840	16	60 fps, LAN play
T-Mobile REVVL 7 5G (TMRV075G)	Qualcomm Snapdragon 6 Gen 1 (SM6450)	Adreno 710	14	60 fps, LAN play
Google Pixel 3 XL	Qualcomm Snapdragon 845 (SDM845)	Adreno 630	12	60 fps (thanks to v0.2.2 performance), LAN play
LG V30+ (LS998)	Qualcomm Snapdragon 835 (MSM8998)	Adreno 540	8.0	Not supported: needs Android 9 or newer
Windows 10 PC	AMD Ryzen 5 5600G	NVIDIA GeForce RTX 5070	-	60 fps, LAN play with the phones
Windows PC	AMD Ryzen 7 5700X3D	NVIDIA GeForce RTX 5070 Ti	-	60 fps, LAN play

Linux has been run on Ubuntu 26.04 and Fedora 44, both under WSL with software rendering so far: it boots, plays with sound, and computes the same frames as Windows for LAN play. Reports from real Linux PCs and the Steam Deck are welcome.

[!WARNING] Untested on Mali GPUs (most phones with MediaTek, Samsung Exynos or Google Tensor chips). Adreno GPUs needed workarounds for their shader compilers (Display > Graphics Compatibility); Mali may need its own. If you try one, please open an issue with what you see.

Requirements

• Android: an arm64 phone on Android 9 or newer, with Vulkan (OpenGL ES 3.1 where Vulkan can't run the game). About 1 GB free for the app, the game files and the import.
• Windows: Windows 10 or 11, 64-bit, with a Direct3D 12, Vulkan or Direct3D 11 GPU. Processors older than Intel Haswell / AMD Excavator (no AVX2) get the compat build automatically (see Installing).
• Linux: a 64-bit x86 PC with a Vulkan driver and glibc 2.35 or newer: Fedora 36 or newer, Ubuntu 22.04 or newer, Debian 12 or newer, Arch, SteamOS and their relatives. X11 and Wayland both work.
• Your own USA SMNE01 revision 1 copy of New Super Mario Bros. Wii, and Dolphin on a computer to extract it.

Only the USA disc, revision 1 works. Other regions and revisions put the game's code at other addresses, so the app and the PC version check the disc and refuse anything else.

[!NOTE] Nobody here will tell you where to get the game. Dumping your own disc is on you, and links to game files won't be provided or tolerated.

Getting the game files

You do this once, with Dolphin on a computer:

1. In Dolphin, right-click New Super Mario Bros. Wii and choose Properties.
2. Check the Info tab: the game ID must be SMNE01 and the revision 1.
3. Open the Filesystem tab, right-click the disc at the top and choose Extract Entire Disc. Pick an empty folder. You get a folder with files and sys in it.

Android: copy that folder (or a zip of it) to your phone. Open the app and tap Import from Extracted Game Data Folder… or Import Game Data Zip… and choose it. The app checks the game, copies it in, and you can delete the copy afterwards. Your saves are kept when you import again.

Windows and Linux: start NSMBW.exe (Linux: ./NSMBW) and choose that folder when it asks. Or name the folder game and put it next to NSMBW.exe (NSMBW). Keep the folder: the PC version reads it every time.

The app's start screen shows these steps until a game is imported, and Help shows them again.

Installing

Download from the Releases page:

• Android: NSMBW-0.3.1-android-arm64.apk. Open it on your phone and allow installing from that app when Android asks. Updates install over it and keep your saves and game files.
• Windows: NSMBW-0.3.1-windows-x64.zip. Extract it anywhere and run NSMBW.exe. Settings (including where your game files are), saves and caches live in Documents\MarioWiiSaveData, so a new version, extracted anywhere, carries on where the last one left off. The first start of 0.0.8 or later takes over the data of an older version extracted in the same folder (or of the version it replaces). On a processor without AVX2 (older than Intel Haswell or AMD Excavator), NSMBW.exe starts compat\NSMBW-compat.exe by itself: the same game, with its math done the long way, so it still plays LAN games with everyone else. Keep the compat folder next to NSMBW.exe.
• Linux: NSMBW-0.3.1-linux-x86_64.tar.gz. Extract it anywhere and run ./NSMBW. The first start asks for the extracted game folder (with zenity or kdialog; or put the folder next to NSMBW, named game). Settings, saves and caches live in ~/.local/share/WiiCompiled ($XDG_DATA_HOME/WiiCompiled if set). Older processors get compat/NSMBW-compat automatically, as on Windows. Fedora Workstation, KDE and Ubuntu desktops already have everything else it needs; if the game says it found no Vulkan driver, install it with sudo dnf install mesa-vulkan-drivers vulkan-loader (Fedora) or sudo apt install mesa-vulkan-drivers libvulkan1 (Ubuntu, Debian), or your NVIDIA driver.
• Another game, such as a mod: saves are kept per game. Extract a second copy of the release and put that game's extracted folder next to its NSMBW.exe, named game. That copy plays it with saves of its own, and the first copy keeps playing the original.

[!CAUTION] Only take builds from this repository's Releases page. If someone's sharing an APK or zip anywhere else, don't touch it.

Controls

Android: the on-screen remote, tilt and shake, all adjustable under Settings > Controls on the start menu.

Windows (a Wii Remote held sideways):

Key	Wii Remote
Arrow keys	D-pad
X or Space	2 (jump); Space in the air spins (Space Smart Spin QoL)
Z or Left Shift	1 (run, fireball)
C or Ctrl	Shake (spin, pick up)
Q / E	Tilt left / right
B	A
Enter or Esc	+ (pause, the world map's menu)
Minus or Tab	-
F10	Settings bar
F11	Fullscreen on / off

Every key can be changed in the gear's Keybinds tab on the save file screen. A game controller also works on Windows as a sideways Wii Remote (remap it under F10 > Controls).

LAN and Tailscale multiplayer

<p align="center"> <img src="docs/screenshots/windows-lan-couch-toggle.png" alt="The Couch / LAN button at the top right of the Select a File screen, on Windows" width="640"> <br>_{The Couch / LAN button on the save file screen (Windows), in the game's own style. Press Up from any file to reach it.} </p>

Up to 4 players, on any mix of phones and PCs. Every player needs their own game files.

1. One player presses Up on the save file screen to reach the Couch button at the top right, switches it to LAN, then picks Create Room and how many are playing.
2. The others switch it to LAN too, pick Join, and choose the room from the list.
3. The host starts the room. Every device restarts into the session with the host's save, and the game goes to the player select by itself.

Same Wi-Fi: rooms show up by themselves.

Over the internet, with Tailscale: install Tailscale on every device and sign in to the same tailnet (or share a device with friends). Tailscale can't broadcast, so the game finds rooms there like this:

• A PC asks every device in tailscale status, and a PC's room is announced to every Tailscale device, so it shows up on the phones by themselves.
• Devices remember the Tailscale devices they meet (on the same Wi-Fi or over Tailscale) and pass them on: once any device has seen another, every game device on the tailnet learns it.
• To find another phone the very first time with no PC around, add its Tailscale name (as shown in the Tailscale app, e.g. s26-ultra) or its 100.x address under Tailscale & LAN Devices: on the start menu on Android, or F10 > LAN Play on Windows. Those screens also show the device's own addresses to tell others. Only one of the two needs to add the other.

Rooms on the same Wi-Fi are always used over the Wi-Fi, even when Tailscale is on. Tailscale play was tested between the Windows PC and the REVVL 7 over Tailscale alone, in both directions.

Windows asks to let the game through the firewall the first time you host a room; allow it, or others can't find your room. Couch is the normal local multiplayer on one device.

Building from source

Owning the game is still required even if you compile everything yourself.

You'll need: .NET 8 SDK, CMake, Ninja, LLVM/Clang (LLVM-MinGW for Windows, the Android NDK for Android) and Python 3. The full steps, from Dolphin's extraction to the APK and the exe, are in projects/nsmbw/BUILDING.md.

• The NSMBW project: projects/nsmbw (translator config, function map, tools).
• The runtime, retargeted from Mario Kart Wii to NSMBW: runtime.
• The Android app: android.
• WiiCompiled's own README, for the translator and the runtime it comes from: docs/WiiCompiled-README.md.

What the downloads contain

The release downloads include the game's code, translated from the disc's PowerPC executable to native ARM64 and x86-64 code, but no game files: no disc image, no levels, music, graphics or sounds, and no console keys. You supply those from your own disc. This is the same model KartPad uses for Mario Kart Wii. WiiCompiled itself does not ship translated code: its setup translates the game on your own machine.

The source code in this repository is free software under the GPLv3 (see License). That license covers this project's code only; it gives no rights to Nintendo's game, its code or its assets.

FAQ

Is this an emulator? No. Everything is compiled to native code before you ever press play. At runtime there's nothing emulating a Wii CPU or GPU.

Is it a decompilation? Not in the hand-written sense: it's a static recompilation. WiiCompiled's translator turns the game's PowerPC code into C++ automatically, and that is compiled for your phone or PC. The runtime around it (graphics, audio, input, the Wii's system software) is source code.

Do you provide the game? No. Don't ask.

Which game version works? USA SMNE01, revision 1. Other regions and revisions are rejected: their code sits at other addresses, and this port's runtime hooks the game at exact addresses.

Will you fix original bugs? No, behaving like the real game is the goal. Only report things where this port differs from the original game on a Wii or in Dolphin.

The game crashed or shows something wrong. Open an issue with your device, what you did, and the log from Documents\MarioWiiSaveData\Logs (Windows) or ~/.local/share/WiiCompiled/Logs (Linux).

Is it done? No, this is 0.3.1. It boots and plays on the tested devices, but not every level has been checked, and rendering, performance and LAN play are still being worked on.

AI usage

This port was entirely coded by Claude Opus 5.5, Anthropic's AI model, directed and tested by WitherBlitz on the devices above. That includes moving WiiCompiled's runtime from Mario Kart Wii to New Super Mario Bros. Wii, the Android app, and LAN play.

Credits

• WiiCompiled by patchzyy and contributors - the static recompiler and runtime this port is built on.
• Jude (@YlPorts) - the Android draw-count and Mali GPU changes.
• KartPad - WiiCompiled on Android, whose approach and game-file import steps this port follows.
• aurora - the GX rendering/windowing backend. MIT licensed.
• Dawn - Google's WebGPU implementation, powering aurora's Vulkan and Direct3D backends.
• Dolphin Emulator - the reference for Wii hardware behavior, the free DSP coefficient ROM and the default WiiConnect24 tree bundled with the runtime, and the tool you extract your game with.
• The NSMBW reverse-engineering community - RootCubed's NSMBW symbols, the NSMBW decompilation and the NSMBW address maps, which the function map is built from.
• Everyone in the static recompilation community.

Bundled third-party components and their licenses live in THIRD-PARTY-NOTICES.md.

License

This project is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License, version 3 as published by the Free Software Foundation, like WiiCompiled, which it is based on.

It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Not affiliated with, endorsed by, or associated with Nintendo. New Super Mario Bros. Wii is a trademark of Nintendo.

I plan to fully decompile this game in the near future, but for now with the time I have at the moment, this'll have to do. At first, this project was to just see the limits of what I can do with Opus, but now I'd like to see it to the end haha. I'll use this as a base for some of the features and copy them over once I decompile the game. Sorry for the misleading repo name! I changed my mind midway through the creation of this project.