             X   xX XXXX XXX  XXXX X    X        irc.efnet.net    
              X XX  X    X  X X    X    X        #team-xedev
               XX   XXX  X  X XXX   X  X
              XX X  X    X  X X     X  X
             Xx   X XXXX XXX  XXXX   XX

****
    at time of this writing, this is ONLY compatible with freeBOOT 0.03x
    releases built with the included patch set which expects launch.xex
	to be installed to system flash.
****

================================================================================
    Overview - what it does
================================================================================
- It will launch a XeX or CON file from the path you specified in the launch.ini
    as long as it's a valid boot path
- Depending on the button you hold when the xbox is trying to load the NXE, it
    will divert to the xex/con tied to that button or return to default as
    defined in launch.ini
- allows one to patch kernel/xam at bootup with a freeBOOT patch style bin file
    from usb or hdd (in that order) must be in root of the device and be named
    "kxam.patch" and be no larger than 0x4000 bytes. Again, kxam.patch binary
    format is the same as a compiled freeboot patch bin, but use real virtual
    address rather than offset (address - 0x80000000)
- with the included patch set, launch.xex acts as a helper to detect when
    xbox1 emulator loads, allowing memory unlock patch and xbox1 emulator
    to function together

================================================================================
    Known Bugs
================================================================================
- will very rarely wind up at NXE, usually related to ODD activity

================================================================================
    Installation - some example installtion scenarios
================================================================================
*EVERY* File management operation describe herein can be done using the pc
    util of your choice as long as it works properly for the device you are
    working with.

Option 1: You keep your internal hdd hooked up at all times, if this is the case
    then follow #1

Option 2: You keep your internal hdd hooked up most of the time, but sometimes
    launch your dashboard from usb, if this is the case then follow #2

Option 3: You prefer to keep vital files in your NAND at the expense of easily
    updating your launch options, if this is the case then follow #3
    (see INI notes, multiple ini files are supported)

#1 = Copy the patch suitable for your console to the bin\ folder of your
    freeboot image folder, then compile as per the instructions included in the
    readme for freeboot. After doing so, edit the launch.ini so that it fits
    your needs by following the examples it sets. Once having done that, launch
    either Freestyle Dash or XeXMenu and ftp the files to the root of HDD1 turn
    off your console and turn back on, and the settings you have chosen in the
    launch.ini will have taken affect.

#2 = Copy the patch suitable for your console to the bin\ folder of your
    freeboot image folder, then compile as per the instructions included in the
    readme for freeboot. After doing so, edit the launch.ini so that it fits
    your needs by following the examples it sets. In the dashlaunch folder, you
    will see a folder named flash_installer, connect to your xbox via ftp with
    the option of your choosing, and upload this folder to the root of your
    xbox(optional, just know where you uploaded it to).  Open the file manager
    and navigate to that folder and launch the default.xex(NOT the launch.xex),
    follow the on screen prompts and it will install launch.xex file for you.

    At this point you have three steps left to complete. Connect again to your
    Xbox via ftp and transfer the launch.ini file to your internal hdd(HDD1),
    after doing so(assuming you have your USB drive hooked up), ftp that
    launch.ini file to the root of your usb drive as well. Restart your xbox and
    you will have the desired results.

#3 = Copy the patch suitable for your console to the bin\ folder of your
    freeboot image folder, then compile as per the instructions included in the
    readme for freeboot. After doing so, edit the launch.ini so that it fits
    your needs by following the examples it sets. In the dashlaunch folder, you
    will see a folder named flash_installer, copy the launch.ini into this
    folder without changing its name, connect to your xbox via ftp with the
    option of your choosing, and upload this folder to the root of your xbox
    (optional, just know where you uploaded it to).  Open the file manager and
    navigate to that folder and launch the default.xex(NOT the launch.xex),
    follow the on screen prompts and it will install the launch.xex and
    launch.ini files for you.

================================================================================
    Important - some notes on use
================================================================================
- if you have a default launch item set, you MUST hold RB (right bumper) when
    doing things like exiting via miniblade to system settings else it will just
    load your default dash
- if you need to go back to NXE and have default item set, HOLD RB while
    doing so

================================================================================
    INI notes - some info about the ini file
================================================================================
-it's possible to have multiple ini files, priority is: USB, HDD, FLASH
    (** it is NOT recommended to launch USB con/xex from hdd ini **)
    -see http://code.jellycan.com/simpleini/ for more info on the ini parser

================================================================================
    Caveats
================================================================================
The work herein is presented as-is, any risk is solely the end users
    responsibility. While all of us are sorry when unforseen things happen, not
    every situation or mistake can be accounted for before they have been
    spotted. Please use responsibly.

================================================================================
    Thanks
================================================================================
-Big thanks to those who opened the way and those who made it even more usable.
-Thanks to the other members of XeDev. Thanks to Tux, Arbiter and Corrupted for
    all the bugs you caught trying to sneak by!
-Thanks to Arbiter for contributing installation instructions.

~brought to you by XeDev/cOz~
04/05/2010

================================================================================
    ChangeLog
================================================================================

v1.0
- added other devices for launch targets
- added flash for location to load launch.ini
- added flash installer supports flashing launch.xex and launch.ini
- with help of freeboot patches, fixes issues with xbox1 emulator on memory
    unlocked patchset
- overhaul ini parser with simpleIni, support for most buttons and a default
- added dll/plugin loading support
- added hooking/return to launch app instead of NXE (hold RB to bypass)
- added kernel/xam boot time/one time patch engine
- added export to allow the loading of other system modules

v0.02 changes
- added a small delay to allow XBR users to launch CON
- implemented a simple ini file parser and fileExist
- auto detects LIVE and XEX2 to use the appropriate launch method
- fails to dash reliably now

v0.01
-initial release
