Aroma plugins and tools for a Wii U, including Wii Virtual Console injection on Apple Silicon Macs.
hometidy-wiiu
v1.0.5 · Nov 11, 2026
An Aroma app that sorts the Wii U Menu folders and Home pages and marks games as completed. It backs up the layout file, writes, then reads it back to check.
Latest changes
HomeTidy v1.0.5
Same code as v1.0.4, rebuilt from main so the tag points at merged code (v1.0.4 was tagged on a branch made before the merges). The only change is the version label shown in the app.
What the app does (unchanged from v1.0.4, which was confirmed on a real console):
Sort Home: unnamed system icons first, then apps A-Z (system apps and SD homebrew), then the folders in their current order, with no empty positions; the games of each folder A-Z, series by release year, articles ignored.
Mark as completed: green check on a game icon; press A again to remove it. A check made by another tool is removed approximately (checked on a desktop copy of an icon, not on the console).
Install
Copy HomeTidy.wuhb to sd:/wiiu/apps/HomeTidy/ and start it from the Wii U Menu or Aroma. Press Y on the first screen to switch between English and Portuguese (BR).
Status
This binary is a new build and has not been run on a console yet; v1.0.4 was the validated one.
A Wii U with Aroma and the Mocha CFW (the same setup used by FTPiiU).
The Homebrew on Menu plugin, if you want to start it from the Wii U Menu.
1
Download the app
Get HomeTidy.wuhb from the latest release.
2
Copy it to the SD card
Put it at sd:/wiiu/apps/HomeTidy/HomeTidy.wuhb.
3
Restart the console
This lets the Homebrew on Menu plugin list the app.
4
Start HomeTidy
Open it from the Wii U Menu or from the Aroma menu. Press Y on the first screen to switch between English and Brazilian Portuguese.
TeconmoonWiiVCInjector
v1.2.3-macos · Nov 10, 2026
A fork of TeconMoon's Wii Virtual Console Injector with a native macOS (Apple Silicon) port. It builds Wii U installable packages from Wii and GameCube images without needing Windows.
Latest changes
Install
Paste this in Terminal. It downloads this release, checks the SHA-256 and installs it in /Applications without the quarantine flag, so macOS does not block the app:
Running it again updates an existing install. If you download the zip in the browser instead, macOS shows "WiiVCInjector.app was not opened". Fix it with:
The main window now always opens maximized (not full screen, so the menu bar and the title bar stay visible).
From 1.2.2, 1.2.1 and 1.2.0
Convert several games in one run: on the Source files tab, "Choose games and convert..." builds every Wii Retail or GC Retail game you pick with the GamePad Emulation Mode and advanced options currently set, using the icons and banners of Cucholix's repo.
The Build tab shows the progress of each game, and its Requirements card is green when every game has its images in Cucholix's repo (red with the count when some do not). Games without images are skipped and listed in the final summary, with no "open the folder" question.
A Wii game as an ISO or WBFS file. NKit and NASOS input is not supported on macOS.
A Wii U with homebrew able to install the finished package.
Heads up. A Wii game package was installed and runs on a real Wii U. The ISO, GameCube, WiiWare and homebrew DOL paths were only run with synthetic inputs.
1
Run the installer
Use this command instead of a browser download. The app is ad-hoc signed, not notarized, so Gatekeeper blocks a zip saved from a browser.
The window layout matches the original Windows tool.
3
Build the package
Choose your game image, fill in the title and images, then start the build. A 6.78 GB WBFS produces a 6.4 GiB package.
4
Install on the Wii U
Copy the result to the console and install it with your usual title installer.
evwii
v0.4-finer-presets · Nov 4, 2026
A fork of GaryOderNichts/evwii, an Aroma plugin that improves the Wii U's virtual Wii mode. This fork adds finer TV viewport presets, so the black borders of injected Wii games can be hidden without editing the JSON. For example, 688 wide by 456 high hides them on a 16:9 TV.
Latest changes
evWii v0.4 with finer centered TV viewport presets (fork of GaryOderNichts/evwii, the official repository).
What is new: TV width 720 to 640 in steps of 4 to 16 px, TV height 480p 480 to 432 and 576i 576 to 480, all centered. The original preset values are unchanged, so existing configs keep working. For example, 688 wide by 456 high hides the black borders of injected Wii games on a 16:9 TV. The plugin menu header shows v0.4-finer-presets.
Install: copy evwii.wps to wiiu/environments/aroma/plugins/, replacing the current evWii, and reboot.
Status: tested on one console (PAL, injected Wii games, 480p, 16:9 TV): the presets show up in the menu and the borders stay gone.
Build: the attached evwii.wps is built from main at c2c414d (includes the version label from PR #2). The git tag still points to the earlier commit f439937, which has the same code but the plain v0.4 label.
Heads up. The plugin is not active when you boot vWii with the Boot Selector. These builds are not yet verified on hardware beyond compiling.
1
Download the plugin
Get evwii.wps from the latest release.
2
Copy it to the SD card
Put it in wiiu/environments/aroma/plugins/.
3
Reboot the console
Aroma loads the plugin at boot.
4
Pick a viewport
Open the Aroma plugin menu (L + Down + Minus) and choose the TV viewport width and height that hide your borders.
wiiscreenoff
v0.5.0 · Nov 4, 2026
An Aroma plugin that turns the Wii U GamePad screen off while you play Wii (vWii) games.
Latest changes
Aroma plugin that turns the GamePad screen off while a vWii (Wii) game runs.
Install: copy wiiscreenoff.wps to wiiu/environments/aroma/plugins/ and reboot.
Status: v0.4 (same behavior, plus SD debug logging) was tested on one console with injected Wii games: GamePad dark, TV normal. v0.5.0 removes the logging and enables the DMCU patch by default, so it is lightly tested. Please open an issue if it misbehaves.
Recovery: use "Turn GamePad screen back on now" in the plugin menu (L + Down + Minus), or turn off "Blank GamePad via DMCU patch" and reboot. Last resort: delete the .wps.
The Aroma plugin menu (L + Down + Minus) has a master switch, the DMCU blanking patch and a button to turn the GamePad screen back on.
homeswap
v0.2.0 · Nov 7, 2026
An Aroma plugin that shows the Wii U Home on the TV and the Mii plaza on the GamePad. It only acts in the Wii U Menu.
Latest changes
Aroma plugin that shows the Wii U Home on the TV and the Mii plaza on the GamePad, only in the Wii U Menu. It starts active, with no combo, and games and apps keep their normal screens.
New in v0.2.0
X toggles the swap in the Home. Press X once and the Home goes to the GamePad with the Mii plaza on the TV, the original behavior. Press X again and the Home goes back to the TV. The choice is not saved, so every boot starts with the swap on.
X is hidden from the Wii U Menu in the Home. The menu swaps the screens on X by itself, and the two swaps added up. Now only the plugin acts on X there. In games, in other apps and while the plugin menu is open, X is untouched.
Less per-frame work. The scratch buffer used to resolve anti-aliased frames is kept between frames instead of being allocated and freed on every frame. This was not benchmarked.
Install: copy homeswap.wps to wiiu/environments/aroma/plugins/ and reboot. It needs the MemoryMappingModule that comes with Aroma. If you also run SwipSwapMe, remove it: two screen-swap plugins fight over the same screens.
Settings: one item in the plugin menu (L + Down + Minus), "Home on the TV (Wii U Menu only)". The swap is off while that menu is open.
Limits: while the Home is on the TV, the GamePad shows the plaza, so there is no cursor on the TV. Use the D-pad, the stick and the buttons. Touch is untested. Audio is not changed. Pressing X in the Home no longer does the menu's own X action.
Status: tested by the author on one console. The X toggle and the swap work in the Home. The final build differs from the tested one only in the version string. Please open an issue if it misbehaves on your setup.
Recovery: turn the item off in the plugin menu, or delete homeswap.wps.