Skip to content

Xziip/UTheme

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

67 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

UTheme

A Wii U theme manager and installer with network download support. Download, preview, install and manage Wii U themes directly from your console!

Features

  • 🎨 Browse & Download Themes - Access themes from online repository
  • πŸ–ΌοΈ HD Preview - View high-quality theme previews before installing
  • πŸ“¦ One-Click Install - Automatic theme patching.
  • πŸ—‚οΈ Theme Management - View, update, and uninstall installed themes
  • 🌍 Multi-Language - Support for Chinese, English, and Japanese
  • βš™οΈ Settings - Customize logging, language, and music preferences

Make sure to update to Aroma or Tiramisu to use this application.

UTheme powered by Themezer API!

Thanks to Themezer for providing the public API; without it, this software wouldn't exist.

Installation

  1. Download the latest release from the Releases page
  2. Extract UTheme.wuhb to sd:/wiiu/apps/ (It will automatically download the StyleMiiU plugin on first launch. This plugin allows you to easily load custom themes.)

Screenshots

Main Menu and ThemeDetailScreen

Usage

Download Themes

  1. Select "Download Themes" from the main menu
  2. Browse available themes with preview images
  3. Touch or press A to view theme details
  4. Press A again to download and install

Manage Themes

  1. Select "Manage Themes" from the main menu
  2. View all installed themes
  3. Select a theme to view details, or uninstall

Settings

  • Logging: Enable detailed logging for troubleshooting
  • Language: Switch between Chinese, English, and Japanese
  • Background Music: Toggle BGM on/off (auto-downloads BGM on first launch)

Background Music

UTheme automatically downloads background music on first launch. The BGM is downloaded from:

https://raw.githubusercontent.com/xziip/utheme/main/data/BGM.mp3

You can customize the BGM by:

  • Placing your own BGM.mp3 or BGM.ogg in sd:/UTheme/
  • Editing sd:/wiiu/utheme.cfg and changing the bgmurl= line

Building

For building you need:

  • wut
  • wiiu-sdl2
  • wiiu-sdl2_ttf
  • wiiu-sdl2_image
  • wiiu-sdl2_mixer
  • wiiu-curl
  • wiiu-mbedtls
  • wiiu-zlib

Build with Docker

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

# Build the project
docker run -it --rm -v ${PWD}:/project utheme_builder make

# Clean build files
docker run -it --rm -v ${PWD}:/project utheme_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 ./source -i

File Structure

sd:/
β”œβ”€β”€ wiiu/
β”‚   β”œβ”€β”€ apps/
β”‚   β”‚   └── UTheme/
β”‚   β”‚       └── UTheme.wuhb
β”‚   β”œβ”€β”€ themes/            # Downloaded themes
β”‚   └── utheme.cfg         # Configuration file
└── UTheme/
    β”œβ”€β”€ installed/         # Installed theme metadata
    β”œβ”€β”€ cache/             # Theme list cache
    └── BGM.mp3           # Background music (auto-downloaded)
                          # BGM source : Shop - nico's nextbots

Credits

  • LingoBrew Most of the app's core functionality is based on LingoBrew.
  • Themiify. The app's patch and installation functionality is based on Themiify.
  • WiiUIdent. The GUI is based on WiiUIdent.
  • haxcopy. The app is also based on haxcopy.
  • FontAwesome for the icons.
  • libwebp Provides webp decoding functionality.
  • MiniZIP Provide .utheme file decompression functionality
  • Hips Provide patch functionality.
  • Themezer for providing the public API.
  • Terminus Font for the monospace font.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

If you encounter any issues or have questions:

  • Check the logs in sd:/wiiu/logs/utheme.log (enable logging in settings)
  • Open an issue on github.

Support Me

Support me on ko-fi

About

A Wii U theme manager and installer with network download support.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages