Skip to content

timkicker/coffeeshop

Repository files navigation

CoffeeShop

A mod manager for the Wii U. Browse, install and manage SDCafiine mods.

CI Release License Platform

Screenshots

Mod details App Settings

Browse mods

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 installed
  • SD card

Steps

I've also created a video tutorial on YouTube

  1. Download wiiu_mod_store.wuhb from the latest release
  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:
  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 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. 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
  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

{
  "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 first.

Branch strategy: dev is active development, main is stable/released. PRs go to dev.

Tests run without devkitPro (native x86_64 Catch2 build):

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.

Libraries

About

Mod manager for the Wii U. Browse, install and manage SDCafiine mods

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages