Categorii

	Categorii
General
Author(s)	Yossi
Type	Utility
Version	2.0-TR
Links
	Download
	Discussion
	Source
	Downloadable via the Homebrew Browser
Peripherals

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!

Wut?

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.

Use

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.

Setup

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.

Configuration

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:

... existing meta.xml contents ...
</app>

<link>
  <from>apps_here</from>
  <to>apps_there</to>
</link>

<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.

Passcode

To add a passcode, you need to add <code> tags, like this:

<link>
  <code for="wiimote">[buttons here]</code>
  <from>apps_here</from>
  <to>apps_there</to>
</link>

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

<code for="gamecube">

and it will listen on the gc controller instead (wiimote still can't get in in this case). No attribute will default to

<code for="wiimote">

The wiimote buttons are: UDLRABMP12H and are NOT case-sensitive. The GC buttons are: UDLRABXYzlrS and ARE case-sensitive (lowercase for the 3 triggers).

Premade Stuff

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 referred to as Misc, ready for you to start sorting things out into the other 6 categories. This bundle has not yet been updated to the newest version with new wiimote support.

Homebrew Sorter

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.

HBB

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.

Changelog

v2.0-TR

Recompile for new wiimotes

v2.0

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)

v1.0

Initial release

Bugs

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)

Disclaimer

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.