From GameBrew - a wiki dedicated to Video Game Homebrew.
Do you have too many apps listed in your HBC? Do you rarely play apps starting with "W" anymore because it takes too long to scroll all the way down to there? Have you ever installed an app but never played it because it got lost in the clutter? Your misery ends now. Introducing, Categorii!
This app, when used effectively, will give the impression that the HBC has categories. How? By renaming your apps/ directory.
It will appear just like a regular app. When you run it, it will do it's thing with no input from you, and exit. When HBC comes up again, the apps in the destination category show up.
There are several different ways you could set this up.
- You could have each category link to the next category in a big loop (games->utilities->demos etc. back around to games) (linked list).
- You could have the same thing but have a link back every time as well (games->utilities->demos etc. while at the same time demos->utilities->games etc.) (double linked list).
- You could have one category (lets call it apps_root) that consists only of links to all the other categories, and all the other categories would have a link back to apps_root (tree).
- You could have every category linked to every other category (web).
- Or you could have random links to wherever, and end up stuck in some category you forgot to link out of, or out of some category you forgot to link in to.
- Open up your SD card and create a directory in the root for each category you want to have (apps_utitlites/, apps_games/, etc.).
- Sort your homebrew from the apps/ directory to the correct category directories.
- Put a copy of Categorii into each category for each link out of that category (more on this later). Be sure to give each one a unique directory name (categorii_utilities, categorii_games, ect.).
- For each link, edit some files.
- Required: Edit meta.xml
- Recommended: Create an icon.png
- Don't forget to rename one of the categories back to apps/ so that HBC can find it.
The included meta.xml is preconfigured for a link from apps_/ to apps_/ (nowhere). You will want to change this as needed for each link. A simple icon.png with the name of the destination would be a nice finishing touch.
If you already have an existing 1.0 setup, you don't need to worry about this <link> stuff, the new 2.0 boot.dol will take care of it for you.
The <link> tag goes after the closing </app> tag of meta.xml (the included meta.xml already has this). The format for a link is as follows: <source lang="xml"> ... existing meta.xml contents ... </app>
<from> is what to rename the current apps/ to when we leave, and <to> is where we are going to.
You may want to make the <name> of each link start with a space so the HBC lists it first.
To add a passcode, you need to add <code> tags, like this: <source lang="xml"> <link>
[buttons here]<from>apps_here</from> <to>apps_there</to>
Now the program will ask for the passcode. You have 30 seconds to enter it. It can not be longer than 10 keystrokes. As soon as the right combo is pressed, it continues. You can add an attribute like so
and it will listen on the gc controller instead (wiimote still can't get in in this case). No attribute will default to
The wiimote buttons are: UDLRABMP12H and are NOT case-sensitive. The GC buttons are: UDLRABXYzlrS and ARE case-sensitive (lowercase for the 3 triggers).
There are some very nice icons here.
There is also a (mostly) tree setup available here, based on the work of Capple123 and PidGin128 and using Elisherer's icons. Just unrar this to the root of your SD card and your existing apps folder will be refered to as Misc, ready for you to start sorting things out into the other 6 categories.
This is similar to Homebrew Sorter. Categorii is much faster than Homebrew Sorter when switching categories, and it gives you more freedom with what categories you can have, but you can't have one copy of an app be in 2 categories (Homebrew Sorter can) and categorii is MUCH harder to set up. Homebrew Sorter has a nice GUI for setting it up while the SD card is still in the wii, while setting up categorii requires putting the SD card in a computer and spending some time. If you don't want to take your card out, you definitely want to use Homebrew Sorter instead.
As it stands now, this will not work so well with the homebrew browser. I think a standard naming convention for categories should be apps_[hbb category] for the apps folders, and categorii_[where it points to] for the categorii app itself. Hopefully this will make it easier to add support for it to the browser.
- Fixed embarrassing situation where categorii would rename apps and then fail on the second rename leaving you with NO folder named apps.
- Removed 1/2 second pause off the end.
- Deprecated config.xml in favor of keeping link information in meta.xml
- Added colored text to indicate success or failure at a glance.
- Added password capability.
- Automatically converts from 1.0 style configuration, to new style. (You only need to replace the old boot.dol with the new boot.dol file)
- Initial release
- After an upgrade from 1.0 to 2.0 style, the <version> tag in meta.xml is at the bottom. You can only notice this if you look in meta.xml (HBC is fine)
All the usual blah blah blah. If your filesystem on the card gets messed up, this is NOT my fault. It's libfat's fault.