Homebrew On Menu Wii U

Homebrew On Menu
Homebrew On Menu
General
Author	Maschell
Type	Plugins
Version	0.1.7
License	GPL-3.0
Last Updated	2023/07/22
Links
	Download
	Website
	Source

Homebrew On Menu is an Aroma plugin that allows you to boot homebrew directly from your Wii U Menu.

Note: This plugin is included with Aroma and generally does not need to be installed separately.

Installation

Copy homebrew_on_menu.wps to sd:/wiiu/environments/aroma/plugins.

The plugin requires the following modules to be present in specific directories:

WiiUPluginLoaderBackend in sd:/wiiu/environments/aroma/module
RPXLoadingModule in sd:/wiiu/environments/aroma/modules
WUHBUtilsModule in sd:/wiiu/environments/aroma/modules
ContentRedirectionModule in sd:/wiiu/environments/aroma/modules
SDHotSwapModule in sd:/wiiu/environments/aroma/modules
NotificationModule in sd:/wiiu/environments/aroma/modules

User guide

You can place homebrew applications with file extensions .rpx or .wuhb in sd:/wiiu/apps or any of its subdirectories.

Configuration

Available options from the plugin config menu (L+D-Pad Down+Minus):

Hide all homebrew (except Homebrew Launcher):
- Hides all homebrew applications, excluding sd:/wiiu/apps/homebrew_launcher.wuhb and sd:/wiiu/apps/homebrew_launcher/homebrew_launcher.wuhb.
- Default is false.
Prefer .wuhb over .rpx:
- Hides a .rpx file from the Wii U Menu if a .wuhb file with the same name exists in the same directory.
- Default is true.
Hide all .rpx
- Hides all .rpx files from the Wii U Menu.
- Default is false.
Hide specific apps:
- A list of executables to hide can be specified via sd:/wiiu/apps/.ignore, a text file where each line contains a file/pattern to exclude. Case-insensitivity and wildcard "*" support apply.

Example sd:/wiiu/apps/.ignore content:

# Ignore any .rpx in the my_game sub directory  
my_game/*.rpx  
# Ignore any executable in the other_game sub directory  
other_game/*  
# Ignore any executable that starts with "retroarch"  
retroarch*  
*/retroarch*  
# Ignore sd:/wiiu/apps/CoolGame.wuhb  
CoolGame.wuhb

Save Data Redirection

To maintain homebrew app order when running the Wii U Menu without the plugin, the plugin redirects the Wii U Menu save data to sd:/wiiu/homebrew_on_menu_plugin/[SerialNumberOfTheConsole]/save.

If no save data is found on the SD card, the current save data is copied from the console, but subsequent updates are disabled.

When configured to hide all homebrew except Homebrew Launcher, redirection is disabled.

Media

[Wii U] New Homebrew Environment (Wii U Plugin System) by Maschell [Preview] (BullyWiiPlaza)

Changelog

v0.1.7 2023/07/22

Fix compiling with latest wut/devkippc version by @Maschell in #38
Compile with latest wut, devkitPPC and wups version.
Full Changelog: v0.1.6...v0.1.7.

v0.1.6 2023/04/03

Fix copying the save data for other accounts than the main account by @Maschell in #36.
Use a separate Wii U Menu save copy per console by @Maschell in #37.
Full Changelog: v0.1.5...v0.1.6.

v0.1.5 2023/03/29

Only parse the .ignore file when launching Wii U Menu by @Maschell in #33.
Full Changelog: v0.1.4...v0.1.5.

v0.1.4 2023/03/23

Implement /vol/save/common redirection for Wii U Menu when other titles access it by @Maschell in #27.
- This fixes displaying titles correctly in Daily Log.
Add option to hide all .rpx by @Maschell in #28.
Rename the config item to just "Hide all homebrew" if no homebrew_launcher.wuhb exists on the sd card. by @Maschell in #29.
Implement support for a .ignore file in sd:/wiiu/apps by @Maschell in #30.
- See the README for more information.
Fix crash when inserting/removing the sd card in applets while the Wii U Menu is running by @Maschell in #31.
Full Changelog: v0.1.3...v0.1.4.

v0.1.3 2022/10/09

Add option to hide .rpx if a .wuhb with the same name exists.

v0.1.2 2022/09/20

Display the correction version in the config menu.

v0.1.1 2022/09/18

Change the scope of the mutex when hooking into the FSReadfile to avoid a possible deadlook when exiting some games.

v0.1 2022/09/05

Update Dockerfile.

External links