+------------------------+
| uo_Ograniser  v0.9.2se |
+------------------------+

Program Information
===================
Official Website: http://hoshizora.tripod.com/uo_ograniser
    Release Date: 2006.10.10
      Powered by: LUA Player 0.20 MOD 2


Introduction
============
uo_Ograniser is an 'UnOfficial' homebrew version that extends the core
functionalities of the original program developed and released by modsyn (named
Ogranise**). This version allows you to do more things like sorting homebrew
titles automatically in alphabetical ascending or descending order, removing or
restoring corrupted data icons from the XMB menu via a 3-way folder name
inter-conversion scheme, ignoring titles you do not wish to repair in the list,
and generating a summary report at the end of the repair operation. This is
currently the only one which does it on the PSP without a USB connection.


What's New In This Release?
===========================
v0.9.2se
--------
With the breakthrough release of Dark_AleX's 2.71 SE-A Custom Firmware mod, PSP
users who has installed the mod would notice my humble little piece of homebrew
lost its magic in the GAME150 folder.

Here's the quick fix, requested by Exodus in the QJ.net forum. Enjoy! =(^-^)v


v0.9.2
------
In the forum discussion at QJ.net, Jackleone pointed out a 'missing' feature,
that is to display the list order the same way as XMB would after executing the
Organise function. After some thoughts, I came up with an idea on how to bypass
the limitations of the LUA programming language while realising the useful
feature requested by Jackleone.

In this release, uo_Ograniser allows you to SAVE your very own 'customised'
list order! To activate this feature, you need to save your customised list
order the very first time you run v0.9.2 (Hint: If you perform the Organise
function, the customised list will be automatically saved for you). The next
time you run this homebrew, a new option called CUSTOM List Order will be
available under the Sort Option.

uo_Ograniser has an enhanced new look - brand new Logo and XMB menu wallpaper.
You will also find some new screen designs in this new version. The Logo is
designed using the program name uo_Ograniser, but mainly featuring the letters
OGR. At first glance, doesn't the OGR design resembles OUR? Yes, OUR organiser!
It takes on the idea of Everyone's organiser in mind.

Last but not least, the XMB menu wallpaper design is inspired with the
expresssion of Hoshizora, which means 'Starry Sky' in Japanese. The focal of
the design was the brightest star amongst the stars. The whole artwork was
perfected and finalised after several revisions, hope you like it! I give
credits to Angel for her contribution of design ideas.

For a complete list of new features, changes and bug fixes, please read the
Changes.txt file. Enjoy this humble new release! =(^-^)=


v0.9.1
------
Well, COMPATIBILITY is the keyword in this latest release of uo_Ograniser!
Without further ado, here's a rundown of the new features:

I guess the most highly anticipated and requested feature is this: Added
support to iR Shell users by introducing a compatible folder name scheme! Yes,
iR Shell users can now fully enjoy uo_Ograniser as it was originally intended:
To hide corrupted data icons in the XMB menu by doing it all via the PSP
without a USB connection, and at the same time staying compatible with the rest
of the homebrew titles! Yay!

"Repair 'em all!" was all about it in the previous versions. Hmm... maybe not
that useful if the application folder name has changed, and as the result it
fails to run. That's why this new release has an Ignore Toggle feature! You may
cross out one or more title(s) you wish to ignore from the repair list. The
paired folder names of the marked title(s) will be left untouched during the
organising (and repair) operation!

And yes, you can now take screen shots as and when you like it. The *only one
screen capture file* limitation is lifted. Yes, you may now take up to 10,000
screen shots in one go! BTW, do you really need that many? (^-^);


Unofficial vs. Original Version
-------------------------------
This homebrew-mod version is packed with many 'extra' features. To start off
with, the user interface has a facelift! This unofficial release sport a new
graphical interface, menus and backgrounds to improve the end-user experience.

You may now sort your homebrew titles automatically in alphanumerical ascending
or descending order. If you are still unsatisfied with the order arrangement,
the manual sorting (positioning) tool will allow you to place your favourite
homebrew to your favourite spot.

Say goodbye to the corrupted data icons that may show up on the XMB menu! New
feature to this mod: uo_Ograniser allows you to repair (rename) the existing
homebrew folders in your game folder automatically by removing those corrupted
data icons. This one-time process is completely safe***, you may even reverse
the process if you wish to restore the original folder names.

And finally, before you could answer 'Yes!' to begin the organising
(finalizing) process, safety checks will be kicked in to make sure your PSP
have sufficient battery life or it is plugged into an AC-adaptor before you are
allowed to perform read/write operations on your memory stick.

Of course, a progress bar indicator will show the percentage of completion
during those long organising process. Upon completion, a Summary Report will be
generated to give you an overview on the folders that were processed and each
individual success failure result.

There you go, all these features packed into one homebrew application, and this
is currently the only one which does it on the PSP without a USB connection!

Side Notes:
**Yes, the original homebrew title is spelt that way!

***Dark_AleX and several others have developed custom firmwares for 1.50 PSP.
One of the features enable you to hide corrupted data icons from the XMB menu.
Although these custom firmware mods have been tested by many users, there is
always a possibility of bricking your PSP when writing to the flash memory, so
please be careful!


Installation
============
The zip archive contains the following files and folders:
%__SCE__uo_Ograniser
__SCE__uo_Ograniser
Changes.txt
Readme.txt

Copy the folders '%__SCE__uo_Ograniser' & '__SCE__uo_Ograniser' from the
archive to the GAME folder in your PSP memory stick:
ms0:/PSP/GAME

The folder structure should look like this after the installation:
ms0:/PSP/GAME/%__SCE__uo_Ograniser
ms0:/PSP/GAME/__SCE__uo_Ograniser

Hint: For existing users of uo_Ograniser, please perform a clean installation
      by removing the old '%__SCE__uo_Ograniser' & '__SCE__uo_Ograniser'
      folders before copying the folders from the archive to the GAME folder.


Program Controls
================
Splash Screen
-------------
[SELECT]                       - Take a screenshot of the current screen and
                                 save it to the memory stick
[START]                        - Go to Edit Screen


Edit Screen (Displays FW1.0/FW1.5 Homebrew):
--------------------------------------------
The buttons are assigned to perform the following tasks:
D-pad [<]                      - Display FW1.0 Homebrew list
D-pad [>]                      - Display FW1.5 Homebrew list
[TRIANGLE]                     - Cycle through the following sort options (only
                                 in FW1.5 Homebrew screen):
                                 * CUSTOM     - Restore the list back to the
                                                last saved custom list order
				 * ASCENDING  - Reorder the list in alpha-
                                                numerical ascending list order
				 * DESCENDING - Reorder the list in alpha-
                                                numerical descending list order
[SQUARE]                       - Toggle ignore option for ALL titles to be
                                 included/excluded in the repair list (only
                                 in FW1.5 Homebrew screen)
[CIRCLE]                       - Toggle ignore option for a SINGLE title to be
                                 included/excluded in the repair list (only in
                                 FW1.5 Homebrew screen)
D-pad/Analog-stick [^]+[CROSS] - Reposition the homebrew title by moving the
                                 selection up by one title (only in FW1.5
                                 Homebrew screen)
D-pad/Analog-stick [v]+[CROSS] - Reposition the homebrew title by moving the
                                 selection down by one title (only in FW1.5
                                 Homebrew screen)
[L] trigger                    - Cycle through the following display options
                                 (only in FW1.5 Homebrew screen):
                                 * FORMATTED  - Format and display the list
                                                without the extra symbols
                                 * ORIGINAL   - Display the list in its
                                                original raw form
[R] trigger                    - Cycle through the following repair options
                                 (only in FW1.5 Homebrew screen):
                                 * __SCE      - Hide the corrupted data icons
                                                in the XMB menu by renaming the
                                                folders to __SCE & %__SCE name
                                                scheme
                                 * iR Shell   - Hide the corrupted data icons
                                                in the XMB menu by renaming the
                                                folders to iR Shell compatible
                                                name scheme
                                 * F&F%       - Show the corrupted data icons
                                                in the XMB menu by renaming the
                                                folders to FOLDER & FOLDER%
                                                name scheme
                                 * ----       - No changes will be made to the
                                                folders name in the GAME folder
[SELECT]                       - Take a screen shot of the current screen and
                                 save it to the memory stick
[START]                        - Confirm screen with the option to perform the
                                 organising (or sorting if you would like to
                                 call it) task
Analog-stick [<]               - Confirm screen with the option to Quit the
                                 program or return to the Edit screen


Summary Report Screen:
----------------------
D-pad [<]                      - Display the next page of the report (if
                                 available)
D-pad [>]                      - Display the previous page of the report (if
                                 available)
[CIRCLE]                       - Return to the Summary Report screen (from the
                                 on-screen Error Codes quick reference guide)
[CROSS]                        - View the on-screen Error Codes quick reference
                                 guide
[SELECT]                       - Take a screen shot of the current screen and
                                 save it to the memory stick
[START]                        - Return to the Splash screen
Analog-stick [<]               - Confirm screen with the option to Quit the
                                 program or return to Summary Report screen


Error Codes - Quick Reference Guide
===================================
Code     Description
----     -----------
A        Error in removing a file from Shortcut folder
B        Error in reading a file from Shortcut folder
C        Error in removing the Shortcut folder
D,G,J    Error in renaming the Program folder
E,H,K    Duplicate Program folder name exists
F,I,L    Unable to find Program:Shortcut folder pair
M,N,P    Error in creating the Shortcut folder
O        Duplicate Shortcut folder name exists
Q        Error in writing a file to Shortcut folder


Credits & Feedback
==================
Special thanks goes to:
- modsyn for his initial work on the original program;
- Cools for his latest mod on the LUA Player;
- Stefano Russello for his PSP Brew;
- Exodus for always giving me fine ideas on improving this program;
- Jackleone for pointing out a 'missing' (Custom List Order) feature which was
  eventually implemented in v0.9.2;
- Dark_AleX for his amazing contributions to the PSP scene; and
- Angel for her artwork tips, support and assistance.
Suggestions? Comments? Feedbacks? Please email to hoshizora@hotmail.com


Donations
=========
This software is available to you free-of-charge. If you like this software,
please consider making a donation. You can access the PayPal Donate link from
the official website at:
http://hoshizora.tripod.com/uo_ograniser

Thank you! (^-^)/


UO_OGRANISER LICENSE AGREEMENT
==============================
NO WARRANTY
-----------
UO_OGRANISER IS DISTRIBUTED "AS IS" AND WITHOUT ANY WARRANTY AS TO
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE OR ANY OTHER WARRANTIES
EITHER EXPRESSED OR IMPLIED. THE AUTHOR WILL NOT BE LIABLE FOR DATA LOSS,
DAMAGES, LOSS OF PROFITS OR ANY OTHER KIND OF LOSS WHILE USING OR MISUSING THIS
SOFTWARE.


Distribution 
------------
You may copy the freeware version of this software and documentation as you
wish, and give exact copies of the original freeware version to anyone, and
distribute the freeware version of the software and documentation in its
unmodified form via electronic means. But you should not charge or requesting
donations for any such copies however made and from distributing the software
and/or documentation with other products without the author's written
permission.