https://github.com/timkicker/coffeeshop
Mod manager for the Wii U. Browse, install and manage SDCafiine mods
https://github.com/timkicker/coffeeshop
aroma cpp devkitpro homebrew mod-manager sdcafiine wii-u wiiu-homebrew
Last synced: about 2 hours ago
JSON representation
Mod manager for the Wii U. Browse, install and manage SDCafiine mods
- Host: GitHub
- URL: https://github.com/timkicker/coffeeshop
- Owner: timkicker
- License: gpl-3.0
- Created: 2026-02-21T13:10:16.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-30T21:15:16.000Z (about 2 months ago)
- Last Synced: 2026-04-30T21:18:19.610Z (about 2 months ago)
- Topics: aroma, cpp, devkitpro, homebrew, mod-manager, sdcafiine, wii-u, wiiu-homebrew
- Language: C++
- Homepage:
- Size: 7.36 MB
- Stars: 21
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
A mod manager for the Wii U. Browse, install and manage SDCafiine mods.
## Screenshots
## Features
- Browse and install mods from community-hosted repositories
- Per-game mod list with icons, screenshots, tags, and metadata
- Tag filtering and sort cycling (Default / Name / Version) on the Browse tab
- Concurrent download queue with per-job progress, cancel, and error recovery
- Resumable downloads. Interrupted transfers pick up where they left off.
- Optional SHA-256 verification of downloaded archives
- Atomic install. Failed extracts never leave a half-installed mod behind.
- Activate / deactivate mods without uninstalling
- Conflict detection between active mods (with file-level diff in the dialog)
- Update badges and one-press "update all" for installed mods
- Region picker for games with multiple Title IDs (US/EU/JP)
- Settings tab with repo management, cache control, and an in-app log viewer
- Crash dump captured to SD on signal faults for post-mortem debugging
- UI state (active tab, sort mode, tag filter) persisted across launches
## Installation
### Requirements
- Wii U with [Aroma](https://aroma.foryour.cafe/) installed
- SD card
### Steps
I've also created a [video tutorial on YouTube](https://youtu.be/FF4uRc8NvnI)
1. Download `wiiu_mod_store.wuhb` from the [latest release](https://github.com/timkicker/coffeeshop/releases/latest)
2. Copy it to `SD:/wiiu/apps/coffeeshop/wiiu_mod_store.wuhb`
3. Create `SD:/wiiu/apps/coffeeshop/config.json` with the [repos you want to use](#config.json-reference):
4. Launch CoffeeShop via the Homebrew Launcher
> **Note:** CoffeeShop does not come with a built-in mod repository. You need to provide your own repo URL. See [Hosting your own repo](#hosting-your-own-repo) below.
## Hosting your own repo
CoffeeShop loads mods from community-hosted repositories. Two ways to set one up:
**Easy path (no JSON editing, no command line):**
Use the [CoffeeShop Repo Builder](https://tim.kicker.dev/coffeeshop-builder/). Click together your repo in the browser, drop ZIPs to compute their SHA-256 automatically, then download a ready-to-publish ZIP. The builder also lets you import an existing `repo.json` URL and edit it.
**Manual path:**
1. Fork [coffeeshop-repo-template](https://github.com/timkicker/coffeeshop-repo-template)
2. Add your games and mods following the schema in the template README
3. Point your `config.json` at your fork's raw `repo.json` URL
The template includes a validation script and GitHub Action that checks your repo on every PR.
## config.json Reference
```json
{
"repos": [
"https://raw.githubusercontent.com/your-name/your-repo/main/repo.json",
"https://raw.githubusercontent.com/someone-else/their-repo/main/repo.json"
]
}
```
Multiple repos are supported and merged at runtime.
## Contributing
PRs are welcome. Please read [CONTRIBUTING.md](CONTRIBUTING.md) first.
Branch strategy: `dev` is active development, `main` is stable/released. PRs go to `dev`.
Tests run without devkitPro (native x86_64 Catch2 build):
```bash
cd tests && mkdir -p build && cd build
cmake .. && make && ./cupstore_tests
```
CI runs the test suite plus a matrix Cemu/hardware cross-build on every push and PR.
## License & Credits
Licensed under [GPLv3](LICENSE).
**Libraries**
- [devkitPro / WUT](https://devkitpro.org/): Wii U toolchain and runtime
- [SDL2](https://libsdl.org/): rendering, input
- [SDL2_ttf](https://github.com/libsdl-org/SDL_ttf): font rendering
- [SDL2_image](https://github.com/libsdl-org/SDL_image): image loading
- [libcurl](https://curl.se/libcurl/): HTTP downloads
- [nlohmann/json](https://github.com/nlohmann/json): JSON parsing
- [mbedTLS](https://github.com/Mbed-TLS/mbedtls): TLS for HTTPS
- [Catch2](https://github.com/catchorg/Catch2): unit testing