1. Installation
2. Loading
3. Navigation
4. Customising - adding to an existing menu item
5. Customising - adding a new menu item
6. Customising - custom icons
7. Customising - custom background





1)
Installation:
Place the folder named XMBOS on your memory stick. The suggested location is in the following location PSP/COMMON/.





2)
Loading:
Go to the PSPs web browser and type in the location of the xmbos.swf. If you used the suggested file location then the url will look like file:/PSP/COMMON/XMBOS/xmbos.swf.





3)
Navigation:
The menu works in a similar way to the main menu on the PSP. Select a menu by using the arrow keys and then press X to load the highlighted link.
Note: You will have to press X initially to set the browsers focus to the flash file.





4)
Customising - adding to an existing menu item:
The main menu is stored in a folder called CONFIG which is located in the XMBOS folder. The menu is stored as an xml file called m2.xml. To edit this open it in notepad.

Initially it should look like:


<menu>
	<item>Games<subitem>
			<file>5000<url>5000.swf<type>Local</type></url></file>	
			<file>Block Commander<url>block_commander.swf<type>Local</type></url></file>
			<file>Falldown<url>falldown.swf<type>Local</type></url></file>
			<file>Heli<url>heli.swf<type>Local</type></url></file>
			<file>Jelly<url>jelly.swf<type>Local</type></url></file>
			<file>Pong<url>pong.swf<type>Local</type></url></file>
			<file>Reaction<url>reaction.swf<type>Local</type></url></file>
			<file>Snake<url>snake.swf<type>Local</type></url></file>
			<file>Tetris<url>tetris.swf<type>Local</type></url></file>
		</subitem>
	</item>

	<item>Links<subitem>
			<file>PSPFLASHGAMING<url>http://www.pspflashgaming.com<type>Web</type></url></file>
			<file>Psp-Vault<url>http://www.psp-vault.com<type>Web</type></url></file>			
			<file>Google<url>http://www.google.com<type>Web</type></url></file>
			<file>ebuddy<url>http://mob.ebuddy.com<type>Web</type></url></file>
		</subitem>
	</item>
</menu>



To add another link then you just add the following within the <subitem> and </subitem>

<file>TITLE<url>FILENAME.swf<type>Local</type></url></file>

The above shows how the information is stored and the following describes the terms:
-TITLE  here you would put the Title of the link or game as you would like it to appear in the actual OS

-FILENAME.swf  here you would put the file name (.swf for flash) if it were a web link you would just put the web address eg http://www.pspflashgaming.com.

-Local  If the file is on the memory stick then this must be Local else the file will not load, When the flash file reads this it lets it know it has to construct the url. If the file is not on the memory stick (or you want to put in the full url such as "file:/PSP/COMMON/GAMES/game.swf") then this can be whatever you want.





For example if you wanted to add the game "Snake 2" with filename "snake2.swf" to the menu you would do the following:

-The game would be put in the "Games" item with the others
	
	<item>Games<subitem>
			<file>5000<url>5000.swf<type>Local</type></url></file>	
			<file>Block Commander<url>block_commander.swf<type>Local</type></url></file>
			<file>Falldown<url>falldown.swf<type>Local</type></url></file>
			<file>Heli<url>heli.swf<type>Local</type></url></file>
			<file>Jelly<url>jelly.swf<type>Local</type></url></file>
			<file>Pong<url>pong.swf<type>Local</type></url></file>
			<file>Reaction<url>reaction.swf<type>Local</type></url></file>
			<file>Snake<url>snake.swf<type>Local</type></url></file>
			<file>Tetris<url>tetris.swf<type>Local</type></url></file>
		</subitem>
	</item>

"Games" means the flash file will construct the url if the game was in the folder "GAMES" (the case does not matter its only upper case to fit in with the rest of the folders on PSP)

Because of this you would place the game in the "GAMES" folder on the memory stick.

Then you would have to add the inforation to the "m2.xml". To do this you would add the following to the "Games" item

<file>Snake 2<url>snake2.swf<type>Local</type></url></file>


So you would get:

	<item>Games<subitem>
			<file>5000<url>5000.swf<type>Local</type></url></file>	
			<file>Block Commander<url>block_commander.swf<type>Local</type></url></file>
			<file>Falldown<url>falldown.swf<type>Local</type></url></file>
			<file>Heli<url>heli.swf<type>Local</type></url></file>
			<file>Jelly<url>jelly.swf<type>Local</type></url></file>
			<file>Pong<url>pong.swf<type>Local</type></url></file>
			<file>Reaction<url>reaction.swf<type>Local</type></url></file>
			<file>Snake<url>snake.swf<type>Local</type></url></file>
			<file>Tetris<url>tetris.swf<type>Local</type></url></file>
			<file>Snake 2<url>snake2.swf<type>Local</type></url></file>
		</subitem>
	</item>


Then when you start up XMBOS you would see the new game in the list.




5)
Customising - adding a new menu item:
You can add new menu items quite simply to the existing menu ("m2.xml" in "CONFIG" folder). You just have to add the following to the existing menu:
	
	<item>Name<subitem>
		</subitem>
	</item>

Where "Name" is the name of the menu as it will appear in the flash file.

To make things clearer we will add a link as well so there will be something in the menu.
The following would add a new menu called "Animation" with a link to the file "magicaltrevor.swf"

	<item>Animation<subitem>
			<file>Magical Trevor<url>magicaltrevor.swf<type>Local</type></url></file>
		</subitem>
	</item>

Note The file "magicaltrevor.swf" would go in a folder named "ANIMATION" which would be in the "XMBOS" folder.

Adding the item to the main menu would then give the following:

<menu>
	<item>Games<subitem>
			<file>5000<url>5000.swf<type>Local</type></url></file>	
			<file>Block Commander<url>block_commander.swf<type>Local</type></url></file>
			<file>Falldown<url>falldown.swf<type>Local</type></url></file>
			<file>Heli<url>heli.swf<type>Local</type></url></file>
			<file>Jelly<url>jelly.swf<type>Local</type></url></file>
			<file>Pong<url>pong.swf<type>Local</type></url></file>
			<file>Reaction<url>reaction.swf<type>Local</type></url></file>
			<file>Snake<url>snake.swf<type>Local</type></url></file>
			<file>Tetris<url>tetris.swf<type>Local</type></url></file>
		</subitem>
	</item>

	<item>Links<subitem>
			<file>PSPFLASHGAMING<url>http://www.pspflashgaming.com<type>Web</type></url></file>
			<file>Psp-Vault<url>http://www.psp-vault.com<type>Web</type></url></file>			
			<file>Google<url>http://www.google.com<type>Web</type></url></file>
			<file>ebuddy<url>http://mob.ebuddy.com<type>Web</type></url></file>
		</subitem>
	</item>

	<item>Animation<subitem>
			<file>Magical Trevor<url>magicaltrevor.swf<type>Local</type></url></file>
		</subitem>
	</item>
</menu>

Now your item should appear in the menu in the flash file when run.

At the moment there will not be an icon but if you read section 6 you will find out how to create a new icon for your menu.




6)
Customising - custom icons
The icons that appear in the menu can be changed. In the "CONFIG" folder there is another folder "ICONS" and in there another folder "MAIN", this is where the icons are stored.

The icons have a file extension .pfi (I made this up) they are basically jpeg or flash files (chanee the extension from .jpg or .jpeg or .swf to .pfi).

The icons are 60*60 pixels in size and flash annimations will work as well.

The icons have names which corospond to the item names in the menu, for example section 5 showed how to add a new menu item called "Animation" the icon would therefore be called "ANIMATION.PFI" (again the uppercase is just to keep in line with the rest of the PSP folders and files).




5)
Customising - custom background
The background file can be found in XMBOS/CONFIG/ where it is called "BACK.PFI" this is just a jpeg or flash file with the dimensions 480*272 and the file extension changed from .jpg or .jpeg or .swf to .pfi