# Artillery Shell 0.2 Readme -- May 12 2006

//------------- Introduction -----------------

Thank you for downloading the 0.2 beta release of Artillery Shell!
This is the second beta release for Artillery shell and after a bit
of a break we are back! Artillery 0.2 features:

+ MP3 Playlist
+ MP3 Remote support
+ Multiple themes support
+ In-Shell theme switching
+ Configurable icons on desktop
+ Custom icons on desktop (launch homebrew)
+ Extended config support
+ Extended theming support
+ Info displays added to LCD

//------------- Installation -----------------

Installation is very straight forward:

1. Copy both directories (psp and MbShell) to the root of your
   memory stick.
2. Check, and modify config files if necessary in: MbShell/config
3. Add wallpapers to the 'wallpaper' directory
4. Add homebrew to the 'games' directory or change the path in
   the config file. (Please use the homebrew.cfg for now)
5. Don't forget that you can add custom icons to the desktop,
   check below for some instructions

The shell will play mp3 and view the photo's from the default
directories, so there is no need to place them anywhere else. If
you do prefer you can change the path in the config files.


//------------ General usage -----------------

Buttons:
- Right trigger: Show homebrew sidepanel
- Select: Take screenshot (will take long time)
- Left trigger + Right trigger + start: Reboot

Analog stick:
- Moves the mouse
- Press X to 'click'
- Icons are dragable, double click on them to activate.

MP3 Player:
- Right trigger: next song
- Left trigger: previous song
- Circle: pause
- Triangle: Play/Resume
- You can use the remote to control the mp3 player too (beta)
- MP3 player will auto advance to next song and loop
- Press the "PL" button to display/hide the playlist
- You can scroll with up/down buttons in the playlist (focus the window first)

Slideshow:
- Cross: Next photo
- Square: Fullscreen
- Circle: Stop/Start auto timer
- Triangle: Hide/Show help
- Slideshow will auto advance to next image and loop

Taskbar:
- Press the USB icon to enable or disable USB.
- Press the WiFi icon to test your WiFi connection*
- Press the screen icon to show a popup with:
  + an option to advance to the next wallpaper
  + A list of themes available
    -> Click on a theme to switch to that theme, Artillery will reboot

LCD:
- Press start (when no window selected) to display:
  + Time / Date
  + Battery info (battery state + charging)
  + CPU / BUS speed info
  + Connection (USB / WIFI) info
  + Theme info
- Pressing start will loop through these displays

* WiFi support is preliminary, Artillery will try to contact
  your accesspoint with the first (static) connection found.
  Future versions will make use of the WiFi connection.

//--------------- Desktop -------------------

Adding homebrew to your desktop and to you Loader list:

In Artillery 0.2 there are some substantial changes to how the
loader list is filled up with entries (games/apps). Here is a
quick rundown on how to get your games into the list.

---------------------
|The Loader list
---------------------

The file that defines what will show up on your desktop or in
your homebrew loader list in Artillery is called icons.cfg and
is located in MbShell/themes/"theme of choice"/. This is where
we'll do the editing. Note that if you add icons to your loader
list in the artillery theme folder for example, and you switch
to the plasma theme you will have to copy/paste the additions
you made into that themes icons.cfg to have it in that theme as
well.

First let's have a look at adding entries to the loader.
The syntax for adding a homebrew icon in the list is as follows:

<JPEG VIEWER;
	path = ms0:/PSP/GAME/jpeg/eboot.pbp;
	icon = ms0:/Mbshell/icons/jview.png;
	desktop = 0;
>


In that example we are using a custom, user defined icon to show
up in the homebrew list. If you want, you can also use the icon
in the eboot located in the applications % folder. To do that,
add an entry formatted as follows:

<JPEG VIEWER;
	path = ms0:/PSP/GAME/jpeg/eboot.pbp;
	path% = ms0:/PSP/GAME/jpeg%/eboot.pbp;
	icon = _eboot;
	desktop = 0;
>

In the strings you define what name it shows in the list,  which
eboot it should load and what icon it should use. The desktop = 0;
option makes sure it wont show on the desktop. Note that the icon
size for the homebrew list is 80x50 pixels. If you use the icon
from an eboot file, it will be scaled down.

You can also sort the entries in the list via the config file.

<JPEG VIEWER;
	path = ms0:/PSP/GAME/jpeg/eboot.pbp;
	icon = ms0:/Mbshell/icons/jview.png;
	desktop = 0;
>

<DGEN V1.4;
	path = ms0:/PSP/GAME/dgen/eboot.pbp;
	icon = ms0:/Mbshell/icons/dgen.png;
	desktop = 0;
>

<SNES9XTYL V0.4;
	path = ms0:/PSP/GAME/snes9xtyl/eboot.pbp;
	icon = ms0:/Mbshell/icons/snes9x.png;
	desktop = 0;
>

In that example SNES9XTYL V0.4 will be at the top of the list,
with JPEG VIEWER at the bottom.

---------------------
|Desktop Icons
---------------------

To add custom icons to your desktop to need to edit the same file
we just looked at. Adding a desktop icons needs a few more lines:

<PSPRadio 0.38.92;
	path = ms0:/PSP/GAME/pspradio/eboot.pbp;
	icon = ms0:/Mbshell/icons/speakerbox.png;
	iconsel = ms0:/Mbshell/icons/speakerbox_sel.png;
	posx = 430;
	posy = 110;
	desktop = 1;
>

The first line defines the name. That name will show up in the "lcd"
window at the bottom of the screen when the icon is selected. 

The second line defienss the path to the homebrew eboot (note that
it should be the eboot in the folder WITHOUT a %).

The third and fourth line defines what icons you want to use, one
regular and one selected version. The next lines define where the
icon should spawn on the desktop on boot. This is linked to the 
option "gridsize = xx;" in main.cfg. Icons will automatically
snap to the grid that is defined there.

Another option in the main.cfg file that is worth noting is
panelshowdesktopicons = x; (an 0 or 1 option where 1 means "on").
This determines whether the icons you add to your desktop should
be visible in your loader list or not. 


//--------------- Themes --------------------


Artillery now supports themes, we have provided three themes with this
release, the default theme, plasma and platinum (by Ciddan). You can 
switch themes by editing the main.cfg config file and changing the 
'theme' setting to the directory containing the theme. Or use the screen
icon on the taskbar. For better results we advise you to use the icons.cfg 
config file to place the icons at different positions, or add / delete
some icons.

You can create your own theme by creating a new dir for that theme and
add / edit the theme.cfg file to your likings. Artillery will be more
adaptable with every release.


//--------------- Contact -------------------

Webpage: http://www.artillery-shell.com
Forum  : http://www.artillery-shell.com/forum
IRC    : irc.freenode.net - #artillery


//--------------- Credits -------------------

Programmer: Blue
Designer  : Affinity
Designer  : Ciddan
Webmaster : Threeballspin

Icons (from the element suite) for the plasma theme generously provided by pantoni.
http://www.infinisedesign.com/

Icons for the default theme are from Vanilla Cream by djnjpendragon.
http://djnjpendragon.deviantart.com/

And from the Crystal suite by everaldo.
www.everaldo.com

Have fun with it and drop by on our forums or IRC!

-The Artillery Team