# Overview
TODO adjust opening
The Nintendo Wii U was a commercial failure of a console. It was left for dead nearly as soon as it arrived, with little attention being given to it by first or third party developers alike. Most of the console's killer apps have been ported to the Nintendo Switch by now. However, owning this console allows you to play nearly the entire Nintendo back catalog in a single device, thanks to mods.
The Nintendo Wii U can run games from the following consoles natively, thanks to the backwards compatibility features of the hardware, **Nintendont** and **USB Loader GX** (more on those later):
- Wii U
- Wii
- GameCube
It can also emulate games from the following consoles flawlessly, thanks to the Virtual Console software features and, more specifically, **Virtual Console injects** (more on that later, too):
- Nintendo Entertainment System
- Super Nintendo Entertainment System
- Nintendo 64
- Nintendo Game Boy
- Nintendo Game Boy Color
- Nintendo Game Boy Advance
- Nintendo DS
- TurboGrafx-16
TODO recap
# Modding
## Installing Aroma
TODO
Aroma plugin to block prompt to auto-format usb drive (since vWii can't use USB drive for USB loader GX if it is formatted for Wii U)
## Controller Support
### Wii U Gamepad
> [!SUCCESS] Wii & GameCube Games in vWii Mode
> Wii & GameCube games do not support controller input from the Wii U Gamepad out of the box. However, you can create **custom vWii Virtual Console Injects** using [TeconmoonWiiVCInjector](https://github.com/piratesephiroth/TeconmoonWiiVCInjector) on your PC, and transfer them to your Wii U.
### Official Nintendo GameCube Controller Adapter
> [!SUCCESS] GameCube Games in vWii Mode via Nintendont on USB Loader GX
> **Nintendont** supports the Official Nintendo GameCube Controller Adapter, meaning GameCube games launched via **USB Loader GX** will work with the adapter out of the box.
> [!WARNING] Wii Games in vWii Mode
> Wii games that supported the GameCube Controller such as **Super Smash Bros. Brawl** and **Sonic Riders Zero Gravity** need to be patched on a per-game basis to support the Official Nintendo GameCube Controller Adapter. As such, **most Wii games that support the GameCube Controller are unsupported at this time**. See [this link](https://www.reddit.com/r/wiiu/comments/12v067v/can_you_use_the_gamecube_adapter_for_wii_games/) for more info.
> [!ERROR] Wii U Games & Software in Wii U Mode
> **Wii U games do not support the Official Nintendo GameCube Controller Adapter at this time**. The exception is, of course, **Super Smash Bros. for Wii U**.
### Other Controllers
> [!SUCCESS] Wii & GameCube Games in vWii Mode
> [fakemote](https://github.com/xerpi/fakemote) adds support for various USB controllers on the vWii. It emulates Wiimote input using various features of the DualShock line of controllers. This application only works in vWii Mode, so it cannot support the Wii U Mode for Wii U Games or Software.
> [!SUCCESS] Wii U Games & Software in Wii U Mode
> [Bloopair](https://github.com/GaryOderNichts/Bloopair) adds support for various Bluetooth controllers on the Wii U. This application only works in Wii U mode, so it cannot support the vWii for Wii or GameCube games.
## Optimizing HD Display Output
The image quality that you can get out of a stock GameCube, Wii, or vWii is severely lacking compared to what is available with mods. This section intends to highlight all the optimizations that can be made to your games to make them look as crisp as possible.
Most of this section can be credited to [Wobbling Pixels](https://www.youtube.com/@wobblingpixels3921) on YouTube for their amazing video [How to Remaster the Nintendo Wii Image (2023) - NO PC Emulation!](https://www.youtube.com/watch?v=sjECzM61atg).
### vWii Forced Resolution Sync with Wii U
By default, the Wii U, when booting into vWii mode, will force the vWii to output at the same resolution that is configured in the **Wii U Settings Menu**. This will cause the Wii U to upscale the image to that resolution. However, the algorithm used to upscale the image causes a strong **blur effect** on the image.
The **Wii Settings Menu** found on all Wii consoles has been removed from the vWii, meaning that there is no way to specify a different resolution for both the vWii and the Wii U.
To prevent the need to switch resolutions in the **Wii U Settings Menu** every time you want to switch between Wii U and Wii gaming, you can make use of [Boot2vWii](https://github.com/WiiDatabase/Boot2vWii). This tool will allow you to **generate forwarders with specific settings** to apply to the **vWii Home Menu** or **vWii Channels** for use on the **Wii U Home Menu** in conjunction with **Aroma**.
### vWii Forced Cropping of Overscan
Overscan is a behavior in certain television sets, in which part of the input picture is cut off by the visible bounds of the screen. It is a behavior from CRTs that is not present in modern displays.
[evWii](https://github.com/GaryOderNichts/evwii) is a plugin for **Aroma** which allows setting custom viewport values in the console's firmware. This can undo the forced cropping of overscan in vWii mode, allowing you to see the full video image in all of your games on modern displays.
### Flicker Filter
The GameCube, Wii, and vWii make use of what's known as a **flicker filter**. The purpose of this filter was to prevent fine details from 'flickering' up and down by one line when displaying in interlaced mode (480i) on a CRT TV.
A flicker filter is completely unnecessary on CRT TVs that support progressive scan video modes (480p), as well as modern displays, which use completely different techniques to render images than the CRTs of the past. Unfortunately, these consoles apply the flicker filter to all video signal modes, regardless if its interlaced or progressive scan.
What this means is that using these consoles **on modern displays** will cause a **blurring effect** across the entire image. There is no universal setting for any of these consoles to disable this filter out of the box.
Fortunately, the Wii Homebrew application [USB Loader GX](https://github.com/wiidev/usbloadergx) has a setting under **Loader Settings** called **Deflicker Filter**, which can be set to **Off (Extended)** to address this for any game launched from this application.
### 480p Bug
A **bug** was discovered in 2019 by [Extrems](https://twitter.com/Extrems) in the **original Nintendo Wii SDK** that causes **blurry outline rendering** to all images rendered **at 480p**. This means that **all Wii games** on the console **are affected** by the bug.
Fortunately again, **USB Loader GX** has a setting under **Loader Settings** called **480p Pixel Fix Patch** which can be set to **On** to address this issue for any game launched from this application.
### Video Width Issue
The Wii renders widescreen Wii games at a resolution of 640x480, then **stretches the image** to a resolution of 720x480. This is another cause of **blur** across the image. Fortunately again, **USB Loader GX** has a setting under **Loader Settings** called **Video Width** which can be set to **Framebuffer** to address this issue for any game launched from this application by disabling the image stretching behavior.
### Aspect Ratio
Some Wii games achieve their 16:9 aspect ratio by **stretching UI elements** to fit the display. **USB Loader GX** has a setting under **Loader Settings** called **Aspect Ratio** which can be set to **Force 4:3** to address this issue for any game launched from this application.
### Post Processing Effects
Post processing effects such as bloom, motion blur, and depth of field are used to hide pixelation in various GameCube and Wii games. If you want to **disable some of these effects**, you can enable **Gecko cheat codes** via **USB Loader GX** on a **per-game basis**.
To enable the use of Gecko cheat codes, there is a setting under **Loader Settings** called **Ocarina** which can be set to **On**.
Navigate to the **Settings** menu of the particular game you wish to configure, then into the **Ocarina** menu. If you see a **No cheatfile found** error, click **Download Now** to get a copy of the latest cheat codes. You can now toggle any cheats you wish, and click **Create** to enable those cheats when you launch the game.
### Using an External Upscaler
Devices such as the [RetroTINK-4K](https://www.retrotink.com/product-page/retrotink-4k) can be used to upscale the now-optimized image of these games to a 4K resolution. Given that this is a rather pricey option, you could also consider the [RetroTINK-5X Pro](https://www.retrotink.com/product-page/5x-pro).
## Creating Game Backups
> [!ERROR] GameCube Games in vWii Mode
> [Cleanrip](https://github.com/emukidid/cleanrip) allows you to create dumps of your GameCube games, but does not work on a Wii U console, since the Wii U disc drive does not support GameCube game discs natively.
> [!SUCCESS] Wii Games in vWii Mode
> [Cleanrip](https://github.com/emukidid/cleanrip) allows you to create dumps of your Wii games directly from the Wii U console, since the Wii U disc drive supports Wii game discs natively.
> [!SUCCESS] Wii U Games
> [Dumpling](https://github.com/emiyl/dumpling) allows you to create dumps of your Wii U games directly from the Wii U console.
# Notes
## Why a Wii U over a Wii or GameCube?
Some will attest to the fact that the Wii U provides an enhanced Wii & GameCube game experience:
> [!QUOTE] Comment by [@PFBM86](https://www.youtube.com/channel/UCdRikGoLPH1EIcxHFb-P9vA) on [The Best Console to Play GameCube Games - GCN vs. Wii vs. Wii U](https://www.youtube.com/watch?v=3wP524MF3P0) YouTube Video by [Good Vibes Gaming](https://www.youtube.com/@GVG)
> John you neglected to mention that loading Gamecube games through Nintendont on Wii or Wii U causes them to run at the native clock rate of the Wii. (I've also heard some people claim that the Wii U can run Wii homebrew at the U's own native clock speed but as far as I can tell that's not correct.) So playing Gamecube games on Wii or Wii U through Nintendont results in a 50% performance increase, thereby reducing or completely eliminating framerate drops in a number of games that suffer from them. It even allows you to run a few games such as Mario Sunshine at 60 fps that were limited to only 30 fps on the Cube! (You can still apply the Gecko hack to unlock the framerate on the Cube as well but the game won't achieve 60 fps most of the time without the 50% CPU and GPU clock boost.) This makes the Wii and Wii U FAR better options for playing Gamecube games compared to the extremely minute differences in image quality that you had to zoom in like 64x for us to even notice.
> [!QUOTE] Comment by [@larsjorgenlorenzen656](https://www.youtube.com/channel/UCn5HbVR_rVqsa1soVtRDnUA) on [Wii Games on Wii U (Backward Compatibility) vs Wii - Do Wii Games really look worse on Wii U?!](https://www.youtube.com/watch?v=XSrMqLPKkTI&t=166s) YouTube Video by [Wobbling Pixels](https://www.youtube.com/@wobblingpixels3921)
> What I noticed when I made a direct comparison at home: Wii games sound much more powerful than on the original analog Wii thanks to the digital sound transmission through the Wii U. In particular, Metroid Prime and Mario Galaxy sound phenomenal on the Wii U.
> [!QUOTE] Comment by [@jonnyallison489](https://www.youtube.com/channel/UCktpMvle2T67Y63BdLP20bQ) on [Wii Games on Wii U (Backward Compatibility) vs Wii - Do Wii Games really look worse on Wii U?!](https://www.youtube.com/watch?v=XSrMqLPKkTI&t=166s) YouTube Video by [Wobbling Pixels](https://www.youtube.com/@wobblingpixels3921)
> I've run a number of tests on this over the years myself. In all cases I have found the Wii U does a better job of displaying Wii games on modern sets than the Wii itself can, regardless of being in 480/720 or 1080p modes.
# Other
Hold B while booting to directly enter vWii mode. (But don't do it since the mods won't apply)
Largest SD card size is???
Can SD card be used for vWii and Wii U???
Nintendont can play games on SD card, so can USB Loader GX
USB Loader GX integrates Nintendont, so you don't need to use the nintendont app
USB Loader GX can install any Wii disc you insert into the Wii U console (it can also backup GC games, but only on the original Wii)
USB Loader GX only supports GC games on an SD Card???
USB Loader GX needs to be set to SD Card mode
https://www.youtube.com/watch?v=RjXmQ24bLxs - hack vwii guide
https://www.youtube.com/watch?v=3O6Zbj36d-I - aroma guide
https://www.youtube.com/watch?v=MAomojfKaZs - best homebrew channels wii u
https://www.youtube.com/watch?v=14n5r1rRB9s - bricked console fix
https://www.youtube.com/watch?v=3VogNCQNUuo - gba games with custom manuals