Artillery Shell PSP

Artillery Shell
Artillery Shell
General
Author	The Artillery Team
Type	Operating Systems
Version	0.2
License	Mixed
Last Updated	2006/05/12
Links
	Download
	Website

A shell with text reader, image viewer, mp3 player, UMD loader and customizable theme.

Installation

Copy both directories (psp and MbShell) to the root of your Memory Stick.

Check, and modify config files if necessary in: MbShell/config.

Add wallpapers to the 'wallpaper' directory.

Add homebrew to the 'games' directory or change the path in the config file. (Please use the homebrew.cfg for now)

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. If you do prefer you can change the path in the config files.

User guide

General usage

Buttons:

R - Show homebrew sidepanel
Select - Take screenshot (will take long time)
L+R+Start - Reboot

Analog Stick:

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

MP3 Player:

R/L - Next/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.

Desktop

This section contains instructions for adding homebrew to your desktop and to you Loader list:

Loader list

The file that defines what will show up on your desktop or in your homebrew loader list. In Artillery it 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.

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

There are three themes provided 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 it is advised 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.

Screenshots

Changelog

V0.2

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.

Live Fire! 2006/03/21

Updated the Live Fire! version of Artillery to the newest version including the 0.1 interface.
Added an intergrated (modified) version of MPH's 2.0 game loader. So now Artillery can launch 2.0 games directly by the use of MPH's game loader.
To use it press the second UMD icon on the desktop. Be sure to have an UMD inserted. It will even return to Artillery after you exit the game. I've tested it with the demo UMD and it seemed to work. But Live Fire! is a dev version.
Just move/copy the flash0 and flash1folders to the MbShell dir, everything else is already set up when you download the latest Live Fire! version.

Live Fire! 2006/03/19

Now supports ANY size of mp3, it will continue to the next song and it will read from the default mp3 directory as well as the MbShell mp3 directory!

V0.1 2006/03/17

New shiny theme!
LCD Information Bar: A new integral part of Artillery which gives you contextually generated information; such as current image name, current song title, current desktop wallpaper image etc.
Much more stable homebrew launcher.
Preliminary WiFi support.
Wallpaper switching in the shell.
Taskbar control - Turn USB/WiFi on/off via the taskbar.

Other features:

MP3 file streaming, play any sized mp3.
Sildeshow - display png's and jpg's up to 1280x1024 resolution.
UMD Loader.
USB Support.
Config files.
Basic textreader.
Live Fire! 2006/03/16
The Live Fire! version is now updated with panels and homebrew loading.

Live Fire! 2006/03/15

Fixed a nasty bug that would appear at random.
Added config file support (read below for further details).
Changable cursor speed.
Customizable paths for photo's, mp3 and homebrew.
Customizable bootup.
Cleaned up dirs and files.

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)

External links

Official website - http://www.artillery-shell.com (archived)