v0.9.1

New Super Mario Bros. U, native PC port, v0.9.1

The Wii U game rebuilt as a native program for Windows, macOS, Linux and Android. The download has no
game files, no game code and no keys: the installer builds the game on your machine from your own copy.

System	Start
Windows 10/11, x86-64 (windows-x86_64) or ARM64 (windows-arm64), Vulkan	NSMBU.exe
macOS 14+, Apple Silicon	NSMBU.app
Linux, x86-64 or arm64, glibc 2.35+, Vulkan	nsmbu-launcher
Android 13+, arm64, Vulkan	android-arm64.apk

Download the zip for your system, unzip it anywhere and start that file. The first start builds the
game once and can take a few minutes; later starts go straight to the game. The game, saves and
settings stay in the folder. On Linux you can also use the single-file .AppImage without
unzipping (Steam Deck included); it keeps them in ~/.local/share/nsmbu and ~/.config/nsmbu
instead (Ubuntu 24.04+: libfuse2t64, or --appimage-extract-and-run).

On Android, install the android-arm64.apk (android-x86_64 is for emulators and Chromebooks), open
the app and choose your game: it builds the game on the phone once, which takes a few minutes.

The installer takes a .wux/.wud disc image with its disc and Wii U common keys, a Cemu .wua
archive (no keys needed), or an extracted game folder. Supported regions and versions are in the
Compatibility table.

The builds are unsigned. On macOS 14, right-click the app and choose Open. On macOS 15 or
newer, use System Settings > Privacy & Security > Open Anyway, and keep NSMBU.app inside the
unzipped folder. On Windows, choose More info > Run anyway when SmartScreen blocks the app.

To open the installer again, hold Shift while starting (macOS, Windows) or run
nsmbu-launcher --setup (Linux). Full install steps and controls are in the
README.

Changelog

Fixed

• Setup finishes on the USA or Europe base disc (#67).

v0.9.0

New Super Mario Bros. U, native PC port, v0.9.0

The Wii U game rebuilt as a native program for Windows, macOS, Linux and Android. The download has no
game files, no game code and no keys: the installer builds the game on your machine from your own copy.

System	Start
Windows 10/11, x86-64 (windows-x86_64) or ARM64 (windows-arm64), Vulkan	NSMBU.exe
macOS 14+, Apple Silicon	NSMBU.app
Linux, x86-64 or arm64, glibc 2.35+, Vulkan	nsmbu-launcher
Android 13+, arm64, Vulkan	android-arm64.apk

Download the zip for your system, unzip it anywhere and start that file. The first start builds the
game once and can take a few minutes; later starts go straight to the game. The game, saves and
settings stay in the folder. On Linux you can also use the single-file .AppImage without
unzipping (Steam Deck included); it keeps them in ~/.local/share/nsmbu and ~/.config/nsmbu
instead (Ubuntu 24.04+: libfuse2t64, or --appimage-extract-and-run).

On Android, install the android-arm64.apk (android-x86_64 is for emulators and Chromebooks), open
the app and choose your game: it builds the game on the phone once, which takes a few minutes.

The installer takes a .wux/.wud disc image with its disc and Wii U common keys, a Cemu .wua
archive (no keys needed), or an extracted game folder. Supported regions and versions are in the
Compatibility table.

The builds are unsigned. On macOS 14, right-click the app and choose Open. On macOS 15 or
newer, use System Settings > Privacy & Security > Open Anyway, and keep NSMBU.app inside the
unzipped folder. On Windows, choose More info > Run anyway when SmartScreen blocks the app.

To open the installer again, hold Shift while starting (macOS, Windows) or run
nsmbu-launcher --setup (Linux). Full install steps and controls are in the
README.

Changelog

Added

• The installer can add a New Super Luigi U folder on the Keys screen, next to a disc image, or with an extracted game folder.
  A Cemu archive that already contains the matching add-on installs it with the game.
• Settings → Graphics has Async shader compile, off by default.
  Turn it on so a burst of new shaders does not freeze the picture.
  An object can be missing for a moment while its shader compiles.
• Settings → Display has Stretch picture instead of widening the view, on by default.
  Turn it off to keep the wider view on screens that are not 16:9.
• Settings → Debug can add a Settings button on the world-map start menu.
  It is off by default, and the menu becomes two rows of three the next time you open it.

Changed

• Vulkan starts in Vsync (smooth) when you have not chosen a presentation mode.
• A new shader keeps the last picture on screen until that shader is ready.
  The shader you can see compiles before shaders that are off screen.
• Each shader compiles once, and the shader cache stores that program once.
  An existing cache still loads, then it is saved in the smaller form.
• Courses draw faster when the frame rate is uncapped.
• The world map draws faster once the picture has settled.
• The hidden GamePad picture is not drawn, so the world map can hold a higher frame rate.
• The New Super Luigi U story-map notice does not appear at startup.
• The performance overlay shows logic steps per second above the frame graph, and shader recompile time with the CPU and GPU lines.
• The performance overlay frame graph is green when the frame time meets your frame rate, shows the line only, and keeps each hitch until it scrolls off.

Removed

• Lua mods and file-replacement packs no longer install.
  The Mods tab installs Cemu graphics and shader packs only.
• T no longer switches between 60 fps and 120 fps.
  Choose the frame rate in the frame menu.
• R no longer cycles the internal resolution.
  Change it in Settings.

Fixed

• Phones and PCs whose Vulkan driver is 1.1 or 1.2, and has no dynamic rendering, can start the game (#63).
• Stretch picture instead of widening the view stretches the 16:9 TV picture into the chosen shape, such as 21:9.
  The GamePad picture keeps its own shape.
• 60 fps on a high-refresh display keeps 60 logic steps a second.
• Foreground grass and flowers follow the camera between frames, including an up or down pan.
  That pan no longer crashes the course.
• Foreground grass wave and sway follow the in-between pictures at high frame rates.
• The ground and bricks follow the camera between frames, so they stay smooth with pipes and enemies.
• The ground and the characters share one camera sample between frames, so the picture no longer jitters when the camera moves.
• The shader cache loads while the game starts, so the first frames no longer wait on that read.
• Crash recovery stays off until you turn it on in Save States.
  A crash does not turn it on.
• The performance overlay averages its numbers over the same two-second window as the frame graph.
  The numbers refresh every half second, and the graph keeps scrolling when the frame rate drops.
• A steady 60 fps no longer shows as 59.5 on the performance overlay.
• When New Super Luigi U is installed, the eShop prompt stays off.

v0.8.4

New Super Mario Bros. U, native PC port, v0.8.4

The Wii U game rebuilt as a native program for Windows, macOS, Linux and Android. The download has no
game files, no game code and no keys: the installer builds the game on your machine from your own copy.

System	Start
Windows 10/11, x86-64 (windows-x86_64) or ARM64 (windows-arm64), Vulkan	NSMBU.exe
macOS 14+, Apple Silicon	NSMBU.app
Linux, x86-64 or arm64, glibc 2.35+, Vulkan	nsmbu-launcher
Android 13+, arm64, Vulkan	android-arm64.apk

Download the zip for your system, unzip it anywhere and start that file. The first start builds the
game once and can take a few minutes; later starts go straight to the game. The game, saves and
settings stay in the folder. On Linux you can also use the single-file .AppImage without
unzipping (Steam Deck included); it keeps them in ~/.local/share/nsmbu and ~/.config/nsmbu
instead (Ubuntu 24.04+: libfuse2t64, or --appimage-extract-and-run).

On Android, install the android-arm64.apk (android-x86_64 is for emulators and Chromebooks), open
the app and choose your game: it builds the game on the phone once, which takes a few minutes.

The installer takes a .wux/.wud disc image with its disc and Wii U common keys, a Cemu .wua
archive (no keys needed), or an extracted game folder. Supported regions and versions are in the
Compatibility table.

The builds are unsigned. On macOS 14, right-click the app and choose Open. On macOS 15 or
newer, use System Settings > Privacy & Security > Open Anyway, and keep NSMBU.app inside the
unzipped folder. On Windows, choose More info > Run anyway when SmartScreen blocks the app.

To open the installer again, hold Shift while starting (macOS, Windows) or run
nsmbu-launcher --setup (Linux). Full install steps and controls are in the
README.

Changelog

Added

• The performance overlay shows 1% low FPS in an FPS / AVG / 1% row.

Changed

• Controls always load from the controls file in your user folder.
• Install and first-run help in the online docs is grouped under user-facing guides; README install steps are unchanged on each platform.
• Mods and the Mods tab work on base-disc builds, not only on 1.3.0 update dumps.
• New desktop setup and release packages use a top-level installer/ folder.
  Older release zips still unpack tools/installer/.

Fixed

• Windows on older Intel graphics no longer crashes on the title screen after the intro (#60).
• Quitting a course you opened from the map returns you on that course's node, with the world map still showing the world entrance.
• Opening a course from the map shows that course name on the loading card, and quitting frames the opened course on the world map.
• After an intro skip, quitting puts the map player on the course you opened instead of only the save start.

Development build (main @ 4dd6ac8, 2026-11-02)

Development build of main @ 4dd6ac8: not a release. It has the changes below that are not
released yet, and has had less testing than a release. Use it to try a fix, and include the commit
(4dd6ac8) when you report a problem. The latest release is on the Releases page.

New Super Mario Bros. U, native PC port, v0.8.3-devel.4dd6ac89

The Wii U game rebuilt as a native program for Windows, macOS, Linux and Android. The download has no
game files, no game code and no keys: the installer builds the game on your machine from your own copy.

System	Start
Windows 10/11, x86-64 (windows-x86_64) or ARM64 (windows-arm64), Vulkan	NSMBU.exe
macOS 14+, Apple Silicon	NSMBU.app
Linux, x86-64 or arm64, glibc 2.35+, Vulkan	nsmbu-launcher
Android 13+, arm64, Vulkan	android-arm64.apk

Download the zip for your system, unzip it anywhere and start that file. The first start builds the
game once and can take a few minutes; later starts go straight to the game. The game, saves and
settings stay in the folder. On Linux you can also use the single-file .AppImage without
unzipping (Steam Deck included); it keeps them in ~/.local/share/nsmbu and ~/.config/nsmbu
instead (Ubuntu 24.04+: libfuse2t64, or --appimage-extract-and-run).

On Android, install the android-arm64.apk (android-x86_64 is for emulators and Chromebooks), open
the app and choose your game: it builds the game on the phone once, which takes a few minutes.

The installer takes a .wux/.wud disc image with its disc and Wii U common keys, a Cemu .wua
archive (no keys needed), or an extracted game folder. Supported regions and versions are in the
Compatibility table.

The builds are unsigned. On macOS 14, right-click the app and choose Open. On macOS 15 or
newer, use System Settings > Privacy & Security > Open Anyway, and keep NSMBU.app inside the
unzipped folder. On Windows, choose More info > Run anyway when SmartScreen blocks the app.

To open the installer again, hold Shift while starting (macOS, Windows) or run
nsmbu-launcher --setup (Linux). Full install steps and controls are in the
README.

Changelog

Fixed

• Windows on older Intel graphics uses classic Vulkan render passes, so the title screen no longer crashes in igvk64.dll after the intro (#60).

v0.8.3

New Super Mario Bros. U, native PC port, v0.8.3

The Wii U game rebuilt as a native program for Windows, macOS, Linux and Android. The download has no
game files, no game code and no keys: the installer builds the game on your machine from your own copy.

System	Start
Windows 10/11, x86-64 (windows-x86_64) or ARM64 (windows-arm64), Vulkan	NSMBU.exe
macOS 14+, Apple Silicon	NSMBU.app
Linux, x86-64 or arm64, glibc 2.35+, Vulkan	nsmbu-launcher
Android 13+, arm64, Vulkan	android-arm64.apk

Download the zip for your system, unzip it anywhere and start that file. The first start builds the
game once and can take a few minutes; later starts go straight to the game. The game, saves and
settings stay in the folder. On Linux you can also use the single-file .AppImage without
unzipping (Steam Deck included); it keeps them in ~/.local/share/nsmbu and ~/.config/nsmbu
instead (Ubuntu 24.04+: libfuse2t64, or --appimage-extract-and-run).

On Android, install the android-arm64.apk (android-x86_64 is for emulators and Chromebooks), open
the app and choose your game: it builds the game on the phone once, which takes a few minutes.

The installer takes a .wux/.wud disc image with its disc and Wii U common keys, a Cemu .wua
archive (no keys needed), or an extracted game folder. Supported regions and versions are in the
Compatibility table.

The builds are unsigned. On macOS 14, right-click the app and choose Open. On macOS 15 or
newer, use System Settings > Privacy & Security > Open Anyway, and keep NSMBU.app inside the
unzipped folder. On Windows, choose More info > Run anyway when SmartScreen blocks the app.

To open the installer again, hold Shift while starting (macOS, Windows) or run
nsmbu-launcher --setup (Linux). Full install steps and controls are in the
README.

Changelog

Fixed

• Opening the settings menu on the Controls tab no longer crashes when the controller diagram is shorter than its layout needs.
• The settings menu scrolls on desktop when tab content does not fit (it no longer hides the scrollbar).

v0.8.2

New Super Mario Bros. U, native PC port, v0.8.2

The Wii U game rebuilt as a native program for Windows, macOS, Linux and Android. The download has no
game files, no game code and no keys: the installer builds the game on your machine from your own copy.

System	Start
Windows 10/11, x86-64 (windows-x86_64) or ARM64 (windows-arm64), Vulkan	NSMBU.exe
macOS 14+, Apple Silicon	NSMBU.app
Linux, x86-64 or arm64, glibc 2.35+, Vulkan	nsmbu-launcher
Android 13+, arm64, Vulkan	android-arm64.apk

Download the zip for your system, unzip it anywhere and start that file. The first start builds the
game once and can take a few minutes; later starts go straight to the game. The game, saves and
settings stay in the folder. On Linux you can also use the single-file .AppImage without
unzipping (Steam Deck included); it keeps them in ~/.local/share/nsmbu and ~/.config/nsmbu
instead (Ubuntu 24.04+: libfuse2t64, or --appimage-extract-and-run).

On Android, install the android-arm64.apk (android-x86_64 is for emulators and Chromebooks), open
the app and choose your game: it builds the game on the phone once, which takes a few minutes.

The installer takes a .wux/.wud disc image with its disc and Wii U common keys, a Cemu .wua
archive (no keys needed), or an extracted game folder. Supported regions and versions are in the
Compatibility table.

The builds are unsigned. On macOS 14, right-click the app and choose Open. On macOS 15 or
newer, use System Settings > Privacy & Security > Open Anyway, and keep NSMBU.app inside the
unzipped folder. On Windows, choose More info > Run anyway when SmartScreen blocks the app.

To open the installer again, hold Shift while starting (macOS, Windows) or run
nsmbu-launcher --setup (Linux). Full install steps and controls are in the
README.

Changelog

Changed

• Once a game is ready, the Android app icon starts the game.
  The installer opens again only when you open a new version of the app.
  Long-press the icon and choose Game setup to open the installer.
• On Android, Settings > Android > Quit to the installer leaves the game and opens the installer.
• On Android, Rebuild the game is under Play.
  It runs setup again for this version of the app.

Fixed

• Windows on older Intel graphics no longer crashes after the intro when the title screen loads.
• Android setup finishes translating the game instead of stopping.
• Setup finishes translating a USA or Europe base disc.
• On Android, Quit to the installer leaves the installer open.
  Closing the game no longer closes that screen.
• On Android, the Controls tab no longer draws overlapping binding chips and leader lines.
  Touch option rows wrap cleanly.
• On Android, Controls uses one page scroll.
• On Android, the controller drawing is shown again.
  It grows until the binding columns fit.
• On Android, Controls List view stays off unless you turn it on.
• On Android, a touch on a settings tab opens that tab.
  Only the open tab is colored.
• On Android, settings text shows arrow characters.
• On Android, drag on the settings page to scroll.
• On Android, Share log includes the setup log.
  You can send a failed setup before the game has run.

v0.8.1

New Super Mario Bros. U, native PC port, v0.8.1

The Wii U game rebuilt as a native program for Windows, macOS, Linux and Android. The download has no
game files, no game code and no keys: the installer builds the game on your machine from your own copy.

System	Start
Windows 10/11, x86-64 (windows-x86_64) or ARM64 (windows-arm64), Vulkan	NSMBU.exe
macOS 14+, Apple Silicon	NSMBU.app
Linux, x86-64 or arm64, glibc 2.35+, Vulkan	nsmbu-launcher
Android 13+, arm64, Vulkan	android-arm64.apk

Download the zip for your system, unzip it anywhere and start that file. The first start builds the
game once and can take a few minutes; later starts go straight to the game. The game, saves and
settings stay in the folder. On Linux you can also use the single-file .AppImage without
unzipping (Steam Deck included); it keeps them in ~/.local/share/nsmbu and ~/.config/nsmbu
instead (Ubuntu 24.04+: libfuse2t64, or --appimage-extract-and-run).

On Android, install the android-arm64.apk (android-x86_64 is for emulators and Chromebooks), open
the app and choose your game: it builds the game on the phone once, which takes a few minutes.

The installer takes a .wux/.wud disc image with its disc and Wii U common keys, a Cemu .wua
archive (no keys needed), or an extracted game folder. Supported regions and versions are in the
Compatibility table.

The builds are unsigned. On macOS 14, right-click the app and choose Open. On macOS 15 or
newer, use System Settings > Privacy & Security > Open Anyway, and keep NSMBU.app inside the
unzipped folder. On Windows, choose More info > Run anyway when SmartScreen blocks the app.

To open the installer again, hold Shift while starting (macOS, Windows) or run
nsmbu-launcher --setup (Linux). Full install steps and controls are in the
README.

Changelog

Added

• Mods work on the USA and Europe base disc (title version 0), not only on the 1.3.0 update or combo packs.
• iOS and iPadOS build: the Metal renderer in a UIKit app with on-screen controls, game controllers, and hardware keyboards.
  Picture-in-picture puts the GamePad picture over the TV picture, where it takes touches.
• Press T in the game window to toggle between 60 fps and 120 fps frame interpolation (Vulkan SDL and macOS Metal).
• Metal decodes BC1–5 textures on upload when the GPU cannot sample them.

Changed

• The performance overlay uses a clearer layout with labeled rows for output FPS, logic rate, CPU and GPU timing, and presentation settings.
  Debug overlay sections are independent (output, graph, presentation, waits, and more).
  It no longer repeats the GPU name, driver, and Vulkan version in the corner (those stay in Copy performance report).
• Settings uses a compact header: tabs sit on the same row as the close button, without the controller help line under the title.
• Graphics card choice for the next start is at the bottom of the Graphics tab instead of Debug.
• In-between frames blend every player's head and course model animation with the camera.
  Mario's head, Luigi, and both Toads move with the rest of the body instead of staying on the 60 Hz step.
  Moving with the camera no longer leaves models half a step behind the view.
• Setup and a full recompile pick up hook changes again, so fixes that rely on new hooks ship after you rebuild.
• A full recompile no longer stops on save-debug hooks after hook files change.

Fixed

• Boost Rush no longer crashes when a Mii is drawn before its shader exists, and Boost Rush on a USA or Europe base disc no longer crashes while the course loads.
• Android setup finishes translating when the phone's Python has no multiprocessing module.
  It uses one process instead of stopping.
• Course tiles stay visible on Metal when internal resolution is above 1x.
• World-map shadows no longer flicker at 120 fps.
  The picture is taken on the in-between present, after the light maps are ready.
• 120 fps no longer steps the camera backward on the in-between frame.
  Changing the frame rate drops saved poses instead of blending across the gap.
• iOS: the on-screen stick works while the GamePad picture fills the screen, as on the world map.
• The performance overlay frame graph uses green for good frame times and fills under the line correctly when a spike appears.
• The Settings close button sits higher in the header row.

v0.8.0

New Super Mario Bros. U, native PC port, v0.8.0

The Wii U game rebuilt as a native program for Windows, macOS, Linux and Android. The download has no
game files, no game code and no keys: the installer builds the game on your machine from your own copy.

System	Start
Windows 10/11, x86-64 (windows-x86_64) or ARM64 (windows-arm64), Vulkan	NSMBU.exe
macOS 14+, Apple Silicon	NSMBU.app
Linux, x86-64 or arm64, glibc 2.35+, Vulkan	nsmbu-launcher
Android 13+, arm64, Vulkan	android-arm64.apk

Download the zip for your system, unzip it anywhere and start that file. The first start builds the
game once and can take a few minutes; later starts go straight to the game. The game, saves and
settings stay in the folder. On Linux you can also use the single-file .AppImage without
unzipping (Steam Deck included); it keeps them in ~/.local/share/nsmbu and ~/.config/nsmbu
instead (Ubuntu 24.04+: libfuse2t64, or --appimage-extract-and-run).

On Android, install the android-arm64.apk (android-x86_64 is for emulators and Chromebooks), open
the app and choose your game: it builds the game on the phone once, which takes a few minutes.

The installer takes a .wux/.wud disc image with its disc and Wii U common keys, a Cemu .wua
archive (no keys needed), or an extracted game folder. Supported regions and versions are in the
Compatibility table.

The builds are unsigned. On macOS 14, right-click the app and choose Open. On macOS 15 or
newer, use System Settings > Privacy & Security > Open Anyway, and keep NSMBU.app inside the
unzipped folder. On Windows, choose More info > Run anyway when SmartScreen blocks the app.

To open the installer again, hold Shift while starting (macOS, Windows) or run
nsmbu-launcher --setup (Linux). Full install steps and controls are in the
README.

Changelog

Added

• Android setup app for phones and emulators.
  You add your own game; the download does not include game code.
  Touch controls, full screen, and save import and export are included.
• Frame rate choices: unlocked, a custom rate from 60 to 1000, a 30 fps preset, and 360p and 540p internal resolution.
• Start and Select together, or R3, open Settings, as well as ` or F12.
• Windows on ARM64 builds.

Changed

• The GamePad screen starts off.
• High frame rates keep normal game speed.
• Android Settings is larger and easier to use with touch or a controller.
• Setup and a full recompile use every CPU core, so they finish sooner.

Fixed

• High frame rates no longer stall on black loading screens or make Mario jitter, and they hold the rate you pick.
  A logic step that runs a little long no longer drops the picture rate back to 60.
• On Android, the Controls diagram no longer overlaps the options.
• 30 fps no longer crashes on some screen changes, and switching back to 60 fps stays at 60.
• Settings text fields accept keyboard input while the overlay is open.
• You can pick which graphics card Vulkan uses.
  On Metal, used ? blocks stay visible.
  The window title no longer shows garbled punctuation.

v0.7.2

New Super Mario Bros. U, native PC port, v0.7.2

The Wii U game rebuilt as a native program for Windows, macOS and Linux. The download has no game
files, no game code and no keys: the installer builds the game on your machine from your own copy.

System	Start
Windows 10/11, x86-64, Vulkan	NSMBU.exe
macOS 14+, Apple Silicon	NSMBU.app
Linux, x86-64 or arm64, glibc 2.35+, Vulkan	nsmbu-launcher

Download the zip for your system, unzip it anywhere and start that file. The first start builds the
game once and can take a few minutes; later starts go straight to the game. The game, saves and
settings stay in the folder. On Linux you can also use the single-file .AppImage without
unzipping (Steam Deck included); it keeps them in ~/.local/share/nsmbu and ~/.config/nsmbu
instead (Ubuntu 24.04+: libfuse2t64, or --appimage-extract-and-run).

The installer takes a .wux/.wud disc image with its disc and Wii U common keys, a Cemu .wua
archive (no keys needed), or an extracted game folder. Supported regions and versions are in the
Compatibility table.

The builds are unsigned. On macOS 14, right-click the app and choose Open. On macOS 15 or
newer, use System Settings > Privacy & Security > Open Anyway, and keep NSMBU.app inside the
unzipped folder. On Windows, choose More info > Run anyway when SmartScreen blocks the app.

To open the installer again, hold Shift while starting (macOS, Windows) or run
nsmbu-launcher --setup (Linux). Full install steps and controls are in the
README.

Changelog

Fixed

• On 21:9, enemies, blocks, bushes, and other course scenery no longer pop in at the old 16:9 edge.
  The title parade stays centered.

v0.7.1

New Super Mario Bros. U, native PC port, v0.7.1

The Wii U game rebuilt as a native program for Windows, macOS and Linux. The download has no game
files, no game code and no keys: the installer builds the game on your machine from your own copy.

System	Start
Windows 10/11, x86-64, Vulkan	NSMBU.exe
macOS 14+, Apple Silicon	NSMBU.app
Linux, x86-64 or arm64, glibc 2.35+, Vulkan	nsmbu-launcher

Download the zip for your system, unzip it anywhere and start that file. The first start builds the
game once and can take a few minutes; later starts go straight to the game. The game, saves and
settings stay in the folder. On Linux you can also use the single-file .AppImage without
unzipping (Steam Deck included); it keeps them in ~/.local/share/nsmbu and ~/.config/nsmbu
instead (Ubuntu 24.04+: libfuse2t64, or --appimage-extract-and-run).

The installer takes a .wux/.wud disc image with its disc and Wii U common keys, a Cemu .wua
archive (no keys needed), or an extracted game folder. Supported regions and versions are in the
Compatibility table.

The builds are unsigned. On macOS 14, right-click the app and choose Open. On macOS 15 or
newer, use System Settings > Privacy & Security > Open Anyway, and keep NSMBU.app inside the
unzipped folder. On Windows, choose More info > Run anyway when SmartScreen blocks the app.

To open the installer again, hold Shift while starting (macOS, Windows) or run
nsmbu-launcher --setup (Linux). Full install steps and controls are in the
README.

Changelog

Changed

• Aspect ratio is under Settings → Display and is marked experimental.
• Ultrawide layouts keep edge HUD on the screen with the same side margin as 16:9.
  Centered menus and title UI stay in a 16:9 frame while the world view expands.

Fixed

• The aspect ratio chosen in Settings is restored on the next launch.
  A set NSMBU_ASPECT value still overrides the saved choice.
• Setup lets you choose Copy saves and settings from another NSMBU folder when no earlier install is detected.
• Install and setup work when the install path contains square brackets.
• On 21:9, world-map Menu, Map View, and Items labels stay on their buttons instead of clipping at the screen edge.
• On 21:9, title characters stay centered under the logo.
• On 21:9, fades fill the wide picture.
• On 21:9, file-select full-width art fills the frame; buttons and cards stay 16:9.
• On 21:9, title-screen scenery at the edges no longer pops in late.
• On 21:9, the title screen no longer shows a one-pixel bright column on the far right.
• On 21:9, the world map no longer shows dark bars just outside the old 16:9 frame.
• Ultrawide no longer stretches the GamePad picture; only the TV view grows.

Added

• Settings → Saves shows a short preview of the real game save (files, world, lives, play time) and opens that saves folder from the top of the tab.
• The performance overlay shows average fps and logic steps/s, plus GPU and CPU timing.
  Reset clears those averages; Copy performance report includes them.

Changed

• Wider and taller windows show more of the scene instead of stretching a 16:9 picture.
  The HUD stays in its original frame.
• Settings language and content-mod Restart relaunches the app, the same way as switching Metal and Vulkan.
• Setup precompiles shaders as part of install, repair, and update after the game is built.
  Menu and Ready to play keep a Recompile shaders button to run that pass again.
• Settings → Language lists only the text languages on the installed disc.
  A USA dump shows English, French, and Spanish; a European dump adds the other European languages.
• Settings tabs: Controls is first; Saves sits between Audio and Mods; Debug is capitalized.
• The window title no longer shows a live frame rate.
  Use the performance overlay for fps.
• The performance overlay no longer shows the renderer, scale, and frame-mode footer under the graph.

Fixed

• World-map shadows no longer flicker at 120/144 fps frame interpolation.
• 144 and 165 fps keep the rate you select when a frame runs early or late.
  Late frames no longer restart the schedule and settle well below the selection.
  Early world-map frames show on the next time slot instead of being dropped.
• High frame rates keep normal game speed (60 steps a second).
  Dropping every in-between frame no longer leaves the game running about twice as fast.
• The Settings restart confirmation stays centered on screen.
• The performance overlay shows the frame rate once, above the frame-time graph.