- -- --------------------------------------------------------------------- -- -
Author      MK2k / www.mk2k.net
Name        APPSwitcher PSP
Version     1.0
Platform    PSP (Custom Firmware 3xx-5xx)
Dev-Details VSH Plugin Developed in C
- -- --------------------------------------------------------------------- -- -

- -- --------------------------------------------------------------------- -- -
I    Description
- -- --------------------------------------------------------------------- -- -
The idea for APPSwitcher grew after months of collecting homebrews on a larger
memorystick. The Sony XMB is just able to show them in one menu/location.
This prevents any chance of categorization of the software. APPSwitcher fills
in this gap and provides an easy to use mechanism to let the user put his
homebrew in categories that he/she chooses and let these categories be "loaded"
into the PSP/GAME directory one after the other by pressing a "switching"
button combination.
In fact APPSwitcher does this by renaming previously created and configured
directories to PSP/GAME etc. and vice versa.

- -- --------------------------------------------------------------------- -- -
II   Installation
- -- --------------------------------------------------------------------- -- -
Copy the seplugins directory to your memorystick, create directories that
categorize your homebrews and put the homebrews there. Delete PSP/GAME,
PSP/GAME4xx etc. (they should be empty now as you already moved the software).
Open seplugins/appswitcher.txt to fit your setup (see Section III for an
example).
If you already have plugins running for the XMB then append the content of
seplugins/vsh.txt to your seplugins/vsh.txt on the memory stick.
Go to the M33 recovery menu (hold the Right Shoulderbutton while booting the
PSP up), go to Plugins and enable the APPSwitcher in VSH mode.

- -- --------------------------------------------------------------------- -- -
III  Editing seplugins/appswitcher.txt
- -- --------------------------------------------------------------------- -- -
appswitcher.txt has a simple structure, each line there are 2 locations
separated by a semicolon ";". The first location is the target directory where
the XMB is able to find the software, for example: "ms0:/PSP/GAME" or
"ms0:/PSP/GAME150". The second location is the directory of your choice for the
category of the software, for example "ms0:/PSP/BREW_GAMES" or
"ms0:/PSP/BREW_APP".
So imagine we have the following 3 locations set up:
ms0:/PSP/BREW_APP150
ms0:/PSP/BREW_APP4XX
ms0:/PSP/BREW_GAME

they contain the software.

Our seplugins/appswitcher.txt should look like this:
ms0:/PSP/GAME150;ms0:/PSP/BREW_APP150
ms0:/PSP/GAME4XX;ms0:/PSP/BREW_APP4XX
ms0:/PSP/GAME;ms0:/PSP/BREW_GAME

that's pretty much it. DON'T forget to delete the target directories
ms0:/PSP/GAME etc. before using the software the first time.

- -- --------------------------------------------------------------------- -- -
IV   Using APPSwitcher
- -- --------------------------------------------------------------------- -- -
You can switch your categories in the XMB by pressing the
Right Shoulderbutton and the Right direction on the D-Pad simultaneously.
The currently used category will be displayed for a short time in the upper
left corner of the screen.
After switching to the category of your choice go to the far left and enable
and disable the USB connection. This is because the PSP's XMB caches the
previous entries of the PSP/GAME etc. directories, with enabling and disabling
the USB connection the contents of PSP/GAME etc. get reloaded. It isn't
necessary to have a USB cable plugged in the PSP.
If something goes wrong during the switch of categories, APPSwitcher puts some
details in the ms0:/appswitcher.log file.

- -- --------------------------------------------------------------------- -- -
V    Greets and Shouts
- -- --------------------------------------------------------------------- -- -
Thanks to:
InsertWittyName - whazilla - weltall
(without you guys I wouldn't have been able to quickly code this one up)

Shouts to:
A_Nub - jparishy - MaTiAz - Dargo - PSPdemon - SafariAl - Tomaz - ps2dev team
                           Kojote -   Greg   - Shoesy

- -- --------------------------------------------------------------------- -- -
VI   Backlog
- -- --------------------------------------------------------------------- -- -
1.0  Initial Release

- -- --------------------------------------------------------------------- -- -
VII  EOF - Visit www.mk2k.net
- -- --------------------------------------------------------------------- -- -