The-Homebrew-Cloud/homebrew_on_menu_plugin
2
0
Fork 0
mirror of https://github.com/wiiu-env/homebrew_on_menu_plugin.git synced 2024-11-21 18:19:15 +01:00
Code Issues Packages Projects Releases Wiki Activity
105 Commits 3 Branches 61 Tags 521 KiB
C++ 70.8%
C 22.2%
Makefile 5.4%
Shell 1.2%
Dockerfile 0.4%
dc80552d5f
Go to file
Maschell dc80552d5f Add option to hide all .rpx
2023-03-21 13:09:18 +01:00
.github/workflows CI: Use actions/checkout@v3 2023-03-21 12:14:51 +01:00
data Update the default icon 2021-04-07 17:10:11 +02:00
src Add option to hide all .rpx 2023-03-21 13:09:18 +01:00
.clang-format Format the code via clang-format 2022-02-04 15:23:07 +01:00
.gitignore Use new makefile to adopt to latest WUPS version 2020-06-17 13:44:19 +02:00
Dockerfile Update Dockerfile 2023-03-21 12:28:51 +01:00
filelist.sh WIP2 2019-11-24 14:14:45 +01:00
LICENSE Add LICENSE 2022-09-04 00:06:32 +02:00
Makefile Update the Makefile to be compatible with CLion 2022-09-19 21:29:33 +02:00
README.md Add option to hide all .rpx 2023-03-21 13:09:18 +01:00

README.md

CI-Release

Homebrew on menu

This plugin allows you to boot homebrew directly from your Wii U Menu.

Installation

([ENVIRONMENT] is a placeholder for the actual environment name.)

  1. Copy the file homebrew_on_menu.wps into sd:/wiiu/environments/[ENVIRONMENT]/plugins.
  2. Requires the WiiUPluginLoaderBackend in sd:/wiiu/environments/[ENVIRONMENT]/modules.
  3. Requires the RPXLoadingModule in sd:/wiiu/environments/[ENVIRONMENT]/modules.
  4. Requires the WUHBUtilsModule in sd:/wiiu/environments/[ENVIRONMENT]/modules.
  5. Requires the ContentRedirectionModule in sd:/wiiu/environments/[ENVIRONMENT]/modules.
  6. Requires the SDHotSwapModule in sd:/wiiu/environments/[ENVIRONMENT]/modules.

Usage

Place your homebrew (.rpx or .wuhb) in sd:/wiiu/apps or any subdirectory inside sd:/wiiu/apps.

Via the plugin config menu (press L, DPAD Down and Minus on the gamepad) you can configure the plugin. The available options are the following:

  • Features:
    • Hide all homebrew except Homebrew Launcher: (Default is false)
      • Hides all homebrew from the Wii U Menu except the sd:/wiiu/apps/homebrew_launcher.wuhb and sd:/wiiu/apps/homebrew_launcher/homebrew_launcher.wuhb
    • Prefer .wuhb over .rpx (Default is true)
      • Hides a .rpx from the Wii U Menu if a .wuhb with the same name exists in the same directory.
    • Hide all .rpx (Default is false)
      • Hides all .rpx from the Wii U Menu.

Save data redirection

In order to preserve the order of homebrew apps even when you run the Wii U Menu without this plugin, this plugin will redirect the Wii U Menu save data to sd:/wiiu/homebrew_on_menu_plugin. When no save data is found on the sd card, the current save data is copied from the console, but after that it's never updated.

If the plugin is configured to hide any homebrew except a Homebrew Launcher, the redirection is disabled.

Buildflags

Logging

Building via make only logs errors (via OSReport). To enable logging via the LoggingModule set DEBUG to 1 or VERBOSE.

make Logs errors only (via OSReport).
make DEBUG=1 Enables information and error logging via LoggingModule.
make DEBUG=VERBOSE Enables verbose information and error logging via LoggingModule.

If the LoggingModule is not present, it'll fallback to UDP (Port 4405) and CafeOS logging.

Building using the Dockerfile

It's possible to use a docker image for building. This way you don't need anything installed on your host system.

# Build docker image (only needed once)
docker build . -t homebrew_on_menu_plugin-builder

# make 
docker run -it --rm -v ${PWD}:/project homebrew_on_menu_plugin-builder make

# make clean
docker run -it --rm -v ${PWD}:/project homebrew_on_menu_plugin-builder make clean

Format the code via docker

docker run --rm -v ${PWD}:/src ghcr.io/wiiu-env/clang-format:13.0.0-2 -r ./src -i