Homebrew Official [release] Homebrew App Store (for WiiU)


Well-Known Member
Jan 31, 2016
United States

Homebrew Launcher Compatible
Homebrew App Store v1.5 - Use Homebrew Launcher and install to SD under /wiiu/apps/appstore
source code: https://github.com/vgmoose/hbas
github release: https://github.com/vgmoose/hbas/releases/tag/1.5

You can install it quickly to your console by visiting wiiubru.com/go on your Wii U.

This will let you run the App Store, where you can install it from itself. You will need a FAT32 SD card inserted. It will only modify the SD card, unless you also install Haxchi.
Run Homebrew Launcher to use it after installing, which you can also download from itself.


Homebrew App Store allows you to download homebrew apps for HBL directly in the app. Installed apps can also be reinstalled, updated, or deleted. It is an attempt at a poor man's Cydia for Wii U!

Apps featured within HBAS are made by other homebrew developers. If anyone takes an issue with their work being distributed in this manner, contact the respective repository owner.

Although "store" is in the name, the apps within are all free-- If a specific homebrew developer wants to charge for their app, they would have to do so outside of HBAS. The name just refers to the concept of an App Store.

- Internet connection
- SD card
- A way to run HBL (see stickies)

How to Use
Unzip the "appstore" folder from the zip at the above download link. This is the bundled HBAS app. Place this folder inside the /apps/wiiu/ folder on your SD card. After this, run HBL and select it from the menu.

Once the app launches, press A or touch the screen to dismiss the splash screen. You can scroll with either stick, the D-pad or the touch screen. To download an app, touch its icon and choose "GET".

LOCAL - An app that is only on your SD card
INSTALLED - An app on your SD card and the server
UPDATE - An app on your SD card and the server, with a different version number
GET - An app only on the server

Default Repository
The app bundle that I provide above features http://wiiubru.com/appstore as the default repository, courtesy of @pwsincd . The apps featured there are hosted on his server.

Thank you @pwsincd ! :toot:

Known Repos
- (default) Wiiubru - http://wiiubru.com/appstore
- Utools - http://coc4tm.github.io/Utools/web
- Wii U Utilities - http://wiiu.3utilities.com
- My apps - http://hbas.vgmoose.com

A future update will provide support for multiple repos and priority sorting. Until then, the repo can be specified by putting one of the URLs in a repository.txt (see Customization below) with no newlines.

Duplicates of apps from my sd - HBAS tries to figure out which apps you have installed by going by the app's folder name. You can safely ignore this, or delete your local copy.
Update was a downgrade - Upgrading relies on the repository maintainer to keep the version numbers up to date. Since versions don't have to be numbers, the update check is != rather than >
Crashed with white text on black text! - post a photo of what your screen looks like and how you got it
Seems to have froze - describe what you were doing when it froze, and were you able to scroll still or was it truly frozen?
No apps are listed, only local ones - This happens when the server can't be reached. Tubehax dns may be down, or your repo may be down.
HBL/HBAS won't load anymore! - One of the apps got corrupted, redo your SD card to contain only a fresh HBL
Button enlarged, but no window opened - Pressing the buttons waits for the server to respond, so it may respond once fully the download is complete.

There are three components that can currently be customized:
- The splash screen: place your own "splash.png" in sd:/wiiu/apps/appstore/resources/splash.png
- The music: place your own "slimers.mp3" in sd:/wiiu/apps/appstore/resources/slimers.mp3
- The repository: place a "repository.txt" file in sd:/wiiu/apps/appstore/repository.txt

For the images and music, they must be png and mp3 respectively. For repository.txt, it should be a file that contains only the desired repository url, no newlines or anything. And it does include the http://

There's no real need to self-host your own HBAS repo, but if you're interested you can check out the web folder. Inside there's a python script that can assist in building a directory, which can then be hosted locally or on a server.

The HBAS binary currently expects a /directory12.yaml file, and then a /apps/ folder, which contains HBL-compatible apps folder (like sd:/wiiu/apps/). You can setup the directory12.yaml file without using the python script, but the script makes it easier. Once your have your server setup, you will need to create repository.txt on your SD card to point HBAS to it (see Customization).

See the issues page on github: https://github.com/vgmoose/hbas/issues
In short, I want the following things:
- smoother scrolling
- permissions for apps
- multiple repo management
- json instead of yaml for the directory
- handle corrupt apps/icons

If you'd like to contribute to any of the above, check out the code and help me out! It would be much appreciated.

I wouldn't have been able to make this without any help :)

@pwsincd - Helped design the web interface and worked directly with me to get the wiiubru repo setup
@brienj - Provided many, many development tips and help, this guy!
@dimok - The HBAS code is based off HBL directly, as well as making heavy use of his custom libraries.

@QuarkTheAwesome - Development help, as well as their exception handler
@CreeperMario - Porting over some old apps to HBL format
@Dylon99 - Participated in "extreme" beta testing
@Marionumber1 - For reluctantly being a 5.5.x enabler

The in-app music is Slimers by (T-T)b, who I probably should've asked more formally about including.

If you like Homebrew App Store, check out my youtube and twitter!

Homebrew App Store is licensed under the GPL3 license, so it can be freely modified and used as long as the source remains public. Slimers is copyright (T-T)b and is not to be distributed or used outside of an official HBAS binary.

This app is open source and free to distribute because the users (yes you!) deserve it.
“Free software” means software that respects users' freedom and community. Roughly, it means that the users have the freedom to run, copy, distribute, study, change and improve the software. Thus, “free software” is a matter of liberty, not price. To understand the concept, you should think of “free” as in “free speech,” not as in “free beer”. We sometimes call it “libre software” to show we do not mean it is gratis.

We campaign for these freedoms because everyone deserves them. With these freedoms, the users (both individually and collectively) control the program and what it does for them.
Last edited by vgmoose,


Well-Known Member
Dec 31, 2012
A game
  • Like
Reactions: CeeDee


May 30, 2016
Goldenrod City
United States
If it matters, I wrote something that generates geckiine .elfs with your IP set.
Until the day comes when the IP can be selected from within the console, maybe you could have it download that to the SD. It still has to be run on Windows to actually make/change the elf, but... I mean, it's better than having something on the store you can't really use at all. Plus it's nice to know there's a way to change it without having to download it all over again. But hey, I didn't make this thing. Wonder what OatmealDome thinks.

...It would actually be pretty cool if there were a way to use something like this store to put in an IP and download a patched elf that way. I wonder.


Well-Known Member
Jan 26, 2012
United States
looks great nice job ;)
reminds me of the good old homebrew browser for the wii good times

Was gonna say the same thing.

It works great! Once we get more brew uploaded, it will be so much more convenient for the average person. I hope this continues to be updated and worked on throughout the wii u scenes life span.

Deleted User

One of the apps got corrupted, redo your SD card to contain only a fresh HBL
This actually happened to me during a beta trial. I found that the icon.png and meta.xml contained only the following content:
The icon and metadata were also missing on the web front-end, but @pwsincd fixed it (with some interesting icons, I must say).

This will prove convenient for many, many people. I would personally love to see @dimok include this with HBL distributions. :P
  • Like
Reactions: vgmoose
General chit-chat
Help Users
    Veho @ Veho: For when you're stuck in place and can't move.