INSTALLATION
============

Copy zLauncher.gpu and the directory zLauncher into the ROOT (!) of your SD card.
No other directory will work. You can safely delete the zLauncher.exe (Windows) and
zLauncher (Linux) files on the SD card - its only needed for Windows/Linux.

The GnuBoy directory is a (working) example of the new ROM starting ability
(see Emulator section).

Starting zLauncher.gpu will enable the new menu (no write on the NAND will happen)
for the time the GP2x stays on. Permanently changing the menu will come in the next
versions.

When you want to quit the menu, go to Utility->Quit


CHANGES FROM 0.4 to 0.4.1
=========================
- static linking -> now it works on all firmwares and without SDL library installation
- Linux version of zLauncher finally finished :-) This may not work if you have an
  outdated version of Linux


CHANGES FROM 0.3 TO 0.4
=======================
- support for Emulators and quick ROM starting (see Emulator section)
- config file (zLauncher.cfg)
- start directories for Game/Utility individually
- battery level indication - initial test (values range from 700...1000)
- shoulder keys do page up/down in selector
- new skin language elements (colors, gradient background, options for selector, ...)
- font smoothing
- cpu speed control: In Launcher, In game
- key repetition (adjustable in config)
- config file can influence skins now
- much smaller distribution package
- now works with all firmware versions
- skin selector
- updated skin
- skin now have a new home in /zLauncher/skins and all files are inside one directory
- added "other" skin to use any skin that was originally designed for the GP2xMenu (see Skin section)
- added "original" skin that is on the NAND


Multi Platform
==============

I have supplied a Windows and Linux Version of zLauncher to test and develop new skins.
Most things work, but not all... The debug window in the background will show
you when speed changes would happen, which programs he would start, ...

Also note that some skins use the preconfigured paths /mnt/sd/ which do not exist
on your Windows installation (creating them in C:\ works though) and so you won't
see files unless you edit zLauncher.cfg or create the paths.


Speed Changer
=============
look into zLauncher.cfg and GnuBoy/zLauncher.dat


Annoyances
==========
Flickering is caused by a) wrong double buffering, b) speed changes causing the display to flicker.

I will work on that - but for now, I'll have to stick with it.


Emulator section
================
You can now easily integrate Emulators and their roms using a "zLauncher.dat" file in
the directory of the emulator. An example is provided with GnuBoy. Place the gnuboy2x.gpe
executable in the GnuBoy directory and the Roms in GnuBoy/Roms. When you now enter
the directory with the Game selector, you no longer see the Emulator. You just see
the Roms and when you select one, it'll automagically start... Easy!

The "zLauncher.dat" file also specifies which speed the emulator needs - so you have everything
in one go.


Skin section
============
zLauncher now comes with 3 skins:
- concept (the one designed by Sonic-NKT)
- default (the original [or modded] GP2x original theme)
- other (placeholder for another GP2x theme created by users)

To use the "other" skin, you need to copy a Skin inside the "other" directory.
I have tested this with the Tux Skin and it works beautifully.

!!! IT WILL NOT WORK WHEN YOU SELECT "other" BUT NO FILES ARE COPIED INTO THE DIRECTORY !!!

The skins can be changed via a menu entry (under Utility).
