Author Topic: iR Shell (A Multi-tasking PSP Shell)  (Read 51855 times)

0 Members and 1 Guest are viewing this topic.

Offline AhMan

  • Newbie
  • *
  • Posts: 37
iR Shell (A Multi-tasking PSP Shell)
« on: August 20, 2006, 05:09:16 PM »
Here is my entry with iR Shell 2.0.

iR Shell is a multi-tasking shell for the PSP which allows you to launch applications (UMD games or homebrews) via a menu driven interface.  In addition to the standard shell functionalities, it includes a plethora of advance features.  Most features can be called upon either via the icon based menu system or a shortcut combo key for fast access.

Feature Highlights:
- A true multi-tasking shell which allows you to multi-task between a UMD game/homebrew and any of the iR Shell built-in functions.
- Allow listening to any of your favorite mp3s while playing UMD games or homebrews.
- A built-in Universal iR Remote supporting over 2000 devices.
- With the built-in file browser, you can browse files on your Memory Stick, UMD Disc, your PC hard disks or DVDROM drives via USB or WiFi.  You can even open files directly from these devices by a single click, such as viewing PMP Movies, Atrac3s, PMF movies, Text files, PDF files, Bitmap Photos, Jpegs, PNG photos, PBP PSP apps, ZIP & RAR archives.
- You can choose to install your PSP homebrew applications & files on your PC harddisk and access them via USB or WiFi on your PSP.  This will eventually give your PSP unlimited storage access.  With Infrastructure WiFi, you can access these homebrew apps or files on your home PC via WiFi hotspots through Internet.
- Allow transfer of files between 2 PSPs via adhoc WiFi.
- Advanced file management functions which can be performed on a complete directory tree.
- Take snapshots of any homebrews, UMD games, MP4 movies or UMD Movies.  For MP4 movies or UMD Movies snapshot, you can use the 'Launch XMB' feature.
- Alarm clock to remind you important events.

Main Menu


DIR View (file browser)


Sample Infra-Red Remote for Xbox


iR Shell 2.0 User Guide
Menu Icon Description:
Below is the description of each function listed by icon group in the main menu:
VIEW Icons:
- ms0: Goes to ms0:/ directory view to access files under memory stick.  Under Directory View, you can open various files directly by pressing 'CROSS'.  Press 'TRIANGLE' to goto parent directory.  You can access other media, such as disc0:, nethost0: or usbhost0: by pressing 'TRIANGLE' while at 'ms0:/'.  Below is the supported file types which allow direct launching with the bundled plugins.  Pls note that your file extension must match the list below for direct launching.
    PMP: PMP Movie via PMP Mod 2.01 plugin (Use 'X' to pause/resume, TRIANGLE to exit)
    AT3: Atrac3 plugin via Atrac3 Plus Player
    PMF: PMF Movie via PMF plugin (Use 'X' to pause/resume, TRIANGLE to exit)
    ZIP: ZIP Unarchiver via AnonymousTipster's ZIP Plugin
    RAR: RAR Unarchiver via AnonymousTipster's RAR Plugin
    TXT: Text file via bookr plugin
    PDF: PDF file via bookr plugin
- Dir: Directory shortcut view.  You can pre-define a directory shortcut via iR Shell Configurator, so that this DIR shortcut view will directly jump to your pre-defined directory for faster access.
- MP3 View: MP3 view allows you to directly jump to the ms0:/PSP/MUSIC directory.  You can play any mp3 songs by pressing 'CROSS'.  You can also highlight multiple mp3 files by clicking 'CIRCLE'.  Then, press 'CROSS' after you've finished chosen your mp3 lists.  Please note that you can also highlight directories which can contain unlimited number of mp3 files.  In this case, all files in the directory will be played back 1 by 1.
- APP View: The Application View will list all your installed homebrew applications under the standard ms0:/PSP/GAME.  It supports standard firmware 1.5 kxploit naming convention (example: bookr & bookr%) and also the traditional hidden directory naming.  The new __SCE__ naming is not supported.
- iR View: iR View allows you to access the built-in Universal Infra-Red remote control function.  The iR View will list all remote controls that you've installed.  You can download another archive named "Pronto Hex Code v1.3" which included infra codes for over 2000 different devices.  If you've an unsupported device, you can visit www.remotecentral.com and download the pronto codes for your particular device and place them in the RDF file format.
- SAV View: Save View allows you to see the details of your game saves.  This will be useful to find out which save to send to your friends PSP via the Adhoc WiFi Transfer function.

RUN Icons:
- UMD: Launch the UMD Game disc.  You can switch between the UMD Game & iR Shell by pressing 'Left Trigger + Select'.
- Eboot 1 to 5: These 5 icons allows you to directly launch 5 pre-defined homebrew applications for fast access without the need to go through the APP View.  First, you'll need to install the pre-defined homebrews to any of these directories.
     ms0:/IRSHELL/HOMEBREW/RIGHT/
     ms0:/IRSHELL/HOMEBREW/RRIGHT/
     ms0:/IRSHELL/HOMEBREW/RLEFT/
     ms0:/IRSHELL/HOMEBREW/RUP/
     ms0:/IRSHELL/HOMEBREW/RDOWN/

CONNECT Icons:
- USB Mass Storage:  Toggle USB Mass Storage On or Off.
- USBHost0: Toggle usbhost0 connection.  With usbhost0, you can browse your PC hard disks or DVDROM drives via USB on your PSP.  You'll need to install the usbhostfs driver on the PC before you can use this feature.
- USBHost0 Redirection:  Toggle usbhost0 to ms0 mapping.  With usbhost0 to ms0 mapping on, all access to ms0: device will be redirected to the usbhost0:.  This will allow your existing homebrew applications to access files on the PC without modifications.
- NETHost0: Toggle nethost0 connection.  With nethost0, you can browse your PC hard disks or DVDROM drives via Infrastructure WiFi on your PSP.  See the Host File System section for details on setting up nethostfs access.
- NetHost0 Redirection:  Toggle nethost0 to ms0 mapping.  With nethost0 to ms0 mapping on, all access to ms0: device will be redirected to the nethost0:.  This will allow your existing homebrew applications to access files on the PC without modifications.
- Adhoc WiFi Transfer: With adhoc WiFi file transfer, you can send or receive files/directories to or from another PSP without any access point.

MUSIC Icons:
- These icons control the playback of mp3 songs.

TOOL Icons:
- File Management: An advance File Management function including Copy, Paste, Delete, Rename & Create Dir.  These functions can work on a single file or a complete directory tree.
- Devhook: Allow launching of devhook directly within iR Shell.  You'll have to install devhook 0.4x on the PSP before you can use this feature.  You can set the devhook firmware version under iR Shell Configurator.  The default is being set to launch fw 2.71.  Pls note the launching of devhook from iR Shell only supports original UMD games, launching ISOs are not supported.
- Launch XMB: This allows you to launch fw 1.5 XMB within iR Shell.  After launching of XMB, you can switch between XMB & iR Shell via the standard hotkey 'Left Trigger + Select'.  Together with the use of nethost0 or usbhost0 redirection, you can use the XMB Video player to playback mp4 movies on your PC harddisks.
- Alarm Clock: This allows you to setup a one time or recurring alarm.  For example, you can setup an alarm to remind you stop playing a game at certain time.
- CPU Speed: Toggle between 100, 222, 266 or 333MHz CPU Clock Speed.
- Lock iR Shell: This will lock iR Shell access until you've given a correct password.  Default password is null (nothing).

System Icons:
- Reset iR Shell: This will restart iR Shell.
- Exit iR Shell: Exit iR Shell and return back to XMB.
- iR Shell Configurator:  This will launch the iR Shell Configurator which allows you to customize iR Shell the way you want it to be.  There are over 50 options to customize.  Within the Configurator, you can also choose to install various skins.
- System Info:  Display various system information, such as battery and memory status.
- Help: Call up the Help screen descrypting shortcut key combos for every single iR Shell functions for fast & direct access.  Most functions can be access via icons or combo keys, except Snapshot (Note/Music button) and the Application Switch hotkey (Left Trigger + Select) which can only be access via key combos.

Button Config:
1. iR Shell Control:
     Arrow Keys (Digital Pad): Menu navigation
     Triangle: Go to parent directory under DIR View / Return to DIR View under Menu
     Square: View toggle.  Allow you to choose application view, RDF view, directory view or Game save view
     Cross: Item selection
     Circle: Display / Hide Icon (for APP/SAV Views)
     Analog pad left: Launch UMD
     Analog pad right, R+Analog Pad: Launch homebrew from /IRSHELL/HOMEBREW/RIGHT/EBOOT.PBP, ... (5 Homebrew shortcuts)
     Analog pad up: USB On/Off toggle
     Analog pad down: Quit iR Shell
     Left Trigger + Up Arrow: Launch XMB
     Left Trigger + Down Arrow: Alarm Clock / Stop alarm
     Left Trigger + Left Arrow: Launch Devhook
     Left Trigger + AUP: Toggle USB HostFS (usbhost0:)
     Left Trigger + ALEFT: Toggle USB HostFS to ms0 redirection (usbhost0: -> ms0:, ms0: -> ms1:)
     Left Trigger + ADOWN: Toggle WiFi HostFS (nethost0:)
     Left Trigger + ARIGHT: Toggle WiFi HostFS to ms0 redirection (nethost0: -> ms0:, ms0: -> ms1:)
     Left Trigger + Right Trigger: Restart iR Shell
     Left Trigger + Select: Switch Task between the launched app and iR Shell
     Left Trigger + Start: CPU speed toggle between 100, 222, 266 & 333
     Note button: Take snapshot (photos are placed under ms0:/PSP/PHOTO/SNAPSHOT)
     Left Trigger + Cross: Adhoc WiFi File Transfer
     Left Trigger + Square: File Manipulation
     Left Trigger + Circle: Lock iR Shell.  You'll need to enter a correct password to regain access
     Left Trigger + Triangle: Directory Shortcut (Definable under iR Configurator)
     Right Trigger + Start: Run Configurator.
     Right Trigger + Select: System Information
     Start button: Help messages
     
2. MP3 Player
     Right Trigger + Triangle: Shortcut to browse /PSP/MUSIC directory
     Circle: Mark item for Playback List (max playback list size: 10)
     Right Trigger + Square: Stop playback
     Right Trigger + Cross: Playback Pause / Playback Resume / Start Playlist
     Right Trigger + Right Arrow: Next MP3 Track
     Right Trigger + Left Arrow: Previous MP3 Track
     Right Trigger + Up Arrow: Volume Up (volume control for MP3 player only)
     Right Trigger + Down Arrow: Volume Down

3. Photo Viewer
Photo viewer is activated when selecting a BMP, PNG or JPG file under directory view. There can be a maximum of 350 photos in a directory. Below is the key description for the photo viewer.
     Square: Toggle Slide Show (Slide show interval is changeable under Configurator)
     Right: Next Picture
     Left: Previous Picture
     Cross or Triangle: Exit Photo Viewer
     Circle: Change JPEG photo scaling option (Note: Scaling option only works on JPEG files and has no effect on others)
     Left Trigger + Select: Switch to the background app


Host File System:
Introduction:
Using USB or WiFi connections, you can remotely browse your PC harddisk, CDROM, DVDROM, etc. just like local files on your Memory Stick.  You can open PC files on your PSP via the familiar iR Shell file browser (DIR View).  This allows you to play host mp3s, movies, photos, etc. on your PSP without physically copy them to the MS.  The files you selected are streamed realtime to the PSP for playback.  You can even launch PSP homebrews that are installed on your PC harddisk.  This will eventually turn your PC storage as your PSP local storage and open up all kinds of possibilities.

Some homebrews are hardcoded to open files located on ms0: device (Memory Stick).  To achieve maximum homebrew compatibility, iR Shell supports device redirection.  Once enabled, your usbhost0: or nethost0: will appear as ms0: on your PSP.  When your homebrew tries to open files under ms0:, it will be redirected to the host file system.  You can also choose to install PSP homebrew applications on your host under usbhost0:/PSP/GAME or nethost0:/PSP/GAME, similar to the way you install homebrews on ms0:.  Afterwards, you can enable the redirection and also enable the "Redirect APP View to Host" in iR Configuration.  The homebrews installed on your host harddisk will be presented to you under the regular iR Shell APP View.  You'll also notice the title of the APP View will be changed to "Homebrew Applications [HOST]".  The HOST keyword signals you that the homebrew listed are residing in your PC host.

After you've enabled redirection, files on memory stick can still be chosen via ms1: device.  Depending on the particular homebrew application, files on ms1 may or may not be seen by the homebrew.

If you've chosen to launch XMB after enabled redirection, you can even stream MP4 movies from your host harddisk via the standard XMB video player.

Installation & Configuration:
For usbhostfs support, you'll need to download & install the USB drivers on your PC (both Windows & Linux are supported).  After installation, you can start the usbhostfs.exe to enable usbhostsf support.

Code: [Select]
Usage: usbhostfs rootdir
rootdir: The defined dir will be used as root dir for PSP.  Use /cygdrive if you want the PSP to see all drives in your PC.
Example:
usbhostfs /cygdrive
This will allow you to access all drives on your PC.

For nethostfs support, it's a bit more complicated as it involves networking configurations.  After unzipping the nethostfs archive to your PC (both Windows & Linux are supported), you can launch it as follows:

nethostfs usage:
Code: [Select]
Usage: nethostfs [options] rootdir
rootdir: The defined dir will be used as root dir for PSP.  Use /cygdrive if you want the PSP to see all drives in your PC.
Options:
  -p port               : TCP port number
  -l login_password     : Password for client PSP to login
  -h                    : Print this help messages
 
Example
nethostfs -p 7513 -l mypass /cygdrive
This will allow your PSP to access all drives in your PC.  You'll also need to configure the following under iR Configurator.
- XMB Network for NetHost: Choose the network entry which you've defined under XMB Infrastructure Network Settings.
- NetHost IP/Name (AP): This is the IP address of Domain Name of your PC to provide nethostfs access.
- NetHost IP (Adhoc): This is only used for Adhoc WiFi PC connection as discussed in the next paragraph.
- NetHost Port: The TCP port to be used, such as 7513 in the example above.
- NetHost Password: The password to access nethostfs service on the PC, example mypass.

Adhoc WiFi PC Configuration:
The PSP firmware 1.5 does not allow your PSP to connect to a PC via Adhoc WiFi, the Adhoc WiFi connection only supports PSP to PSP communication.  To connect your PSP to your PC, you'll normally need an Infrastructure Access Point.  However, iR Shell utilizes a little trick by using the network drivers from firmware 1.0 to allow you to connect your PSP to your PC via Adhoc WiFi.

To use adhoc PC connection, follow these procedures below.
1. Place the following PRX modules from a 1.0 firmware dump. These files are not included with iR Shell distribution for legal reasons. It doesn't matter whether the files are encrypted or decrypted. Encrypted files are smaller in size.
ms0:/IRSHELL/SYSTEM/pspnet.prx
ms0:/IRSHELL/SYSTEM/pspnet_apctl.prx
ms0:/IRSHELL/SYSTEM/pspnet_inet.prx
ms0:/IRSHELL/SYSTEM/pspnet_resolver.prx

2. From your XMB, goto Network Settings->Infrastructure Mode.
- Enter a connection name with "adhoc" as prefix (case insensitive). Example, "Adhoc PC1". The adhoc prefix tells iR Shell this is an adhoc entry. Without adhoc prefix, iR Shell will treat it as a regular Infrastructure settings for Access Point only.
- Enter the SSID name for your adhoc network. Don't use Scan as it won't allow you to scan adhoc networks.
- Use WEP encryption to your preference.
- Choose Custom under "Address Settings", then choose "Manual IP Address Settings". Enter IP address manually, example "192.168.100.2". For "Default Router" entry, type your PC's IP Address, example "192.168.100.1". Enter an arbitrary DNS address.
- For Proxy Server, choose "Do Not Use". Then save settings and skip test connection.

3. Goto iR Configurator, select the appropriate XMB Network Config entry. Then, enter your PC IP Address under "NetHost IP (Adhoc)" entry. This PC IP Address is used for adhoc connections. For infrastructure connections, iR Shell uses the IP Address/Name defined under "Nethost IP/Name (AP)". The reason for having 2 different entries is to avoid making changes to your configurator when switching from AP to Adhoc.

4. Done. You can now use nethost0 via Adhoc mode under iR Shell.  If you enable to option "Allow Adhoc PC Connection for Homebrew" under iR Configurator, this will even allow your existing Infrastructure WiFi homebrew applications to use Adhoc WiFi to a PC.


Download file archives:
pspirshell20.zip - iR Shell 2.0 Main archive, unzip and copy to your ms0:/.
Refer to following posts for additional download modules.

Offline AhMan

  • Newbie
  • *
  • Posts: 37
Re: iR Shell (A Multi-tasking PSP Shell)
« Reply #1 on: August 20, 2006, 05:15:20 PM »
Optional downloads for usbhostfs & nethostfs for Windows PC if you want to use usbhost file system or nethost file system services.

Offline AhMan

  • Newbie
  • *
  • Posts: 37
Re: iR Shell (A Multi-tasking PSP Shell)
« Reply #2 on: August 20, 2006, 05:17:42 PM »
Optional downloads for usbhostfs & nethostfs for Linux PC if you want to use usbhost file system or nethost file system services.

Offline AhMan

  • Newbie
  • *
  • Posts: 37
Re: iR Shell (A Multi-tasking PSP Shell)
« Reply #3 on: August 20, 2006, 05:23:01 PM »
Optional download for Ponto Codes to support Universal Infra-Red Remote Control for over 2000 devices.  The standard iR Shell archive only contains Pronto Codes for a few sample devices.

Offline wraggster

  • Sr. Member
  • ****
  • Posts: 261
    • DCEmu Homebrew Network
Re: iR Shell (A Multi-tasking PSP Shell)
« Reply #4 on: August 20, 2006, 06:53:24 PM »
the best shell on the PSP without a doubt


Webmaster of DCEmu

The Worlds Only Homebrew and Gaming Network Covering All Consoles.

Offline QuickJump

  • Newbie
  • *
  • Posts: 33
    • Quick Journal / Quick Jump
Re: iR Shell (A Multi-tasking PSP Shell)
« Reply #5 on: August 20, 2006, 10:41:57 PM »
Great work AhMan, this is, by far, the best PSP Application ever released  8)

Good luck in the competition, and great release, I'm speechless :)
QJ Network (QJ.net) - All homebrew releases + gaming industry news - Updated 24/7!

Offline suloku

  • Newbie
  • *
  • Posts: 27
Re: iR Shell (A Multi-tasking PSP Shell)
« Reply #6 on: August 21, 2006, 12:54:37 AM »
Great! Irshell is my "xmb" since casual v3 cf was released, it's nice to have that great update.

But I have one request to improve it:

The option to choose a speed of 29 mHz for the processor. The reason is that music can be played well at this speed, at least in the xmb with a CF plugin, so when only listening to music the battery life will rise.

keep the good work!

Offline manaox2

  • Newbie
  • *
  • Posts: 2
Re: iR Shell (A Multi-tasking PSP Shell)
« Reply #7 on: August 21, 2006, 03:24:18 AM »
The beta testers have already tested at 29 mhz. Turns out that it hardly increases battery life at all (extremely little). I guess the screen and everything else ends up taking the rest of the electricity even when the cpu is underclocked so that it doesn't use as much.

Offline bexistbest

  • Newbie
  • *
  • Posts: 2
Re: iR Shell (A Multi-tasking PSP Shell)
« Reply #8 on: August 21, 2006, 04:14:47 AM »
thats a real nice bit of brew, can finally wave bye bye to the xmb. good work

had some problems getting nethostfs to work with /cygwin but works fine with any other path, it does however kill my net connection (never used nethostfs before so its probly that doing it)

many thanks for such a great shell

Offline suloku

  • Newbie
  • *
  • Posts: 27
Re: iR Shell (A Multi-tasking PSP Shell)
« Reply #9 on: August 21, 2006, 05:58:54 AM »
The beta testers have already tested at 29 mhz. Turns out that it hardly increases battery life at all (extremely little). I guess the screen and everything else ends up taking the rest of the electricity even when the cpu is underclocked so that it doesn't use as much.

Yeah, maybe, but when you have all songs selected, putting that speed, powering off the screen and using the hold button would make a difference right?

And a thing I forgotten before, Irshell could recognize 1.0 eboots? now with custom firmwares capable to run that eboots it would be a nice feature
« Last Edit: August 21, 2006, 06:02:28 AM by suloku »

Offline GogetaSSJ4BR

  • Jr. Member
  • **
  • Posts: 73
  • BraSileiro
Re: iR Shell (A Multi-tasking PSP Shell)
« Reply #10 on: August 21, 2006, 06:27:56 AM »
INSTANT WINNER!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
OMG MAN!
ADHOC WITH THE PC, IM TESTING IT RIGHT NOW!!!!!!  :-* :'( OMGOMGOMG  ::sm-24.gif::
...* .Gogeta§§J4BR. *...
...* Roberto Civille Rodrigues - 06/11/87 *...
...* Vila Matilde - São Paulo - SP - Brasil *...
...* roberto.cr@gmail.com - ICQ:136146274 *...

Offline Sephiroth87

  • Newbie
  • *
  • Posts: 8
Re: iR Shell (A Multi-tasking PSP Shell)
« Reply #11 on: August 21, 2006, 07:09:57 AM »
Yeah, maybe, but when you have all songs selected, putting that speed, powering off the screen and using the hold button would make a difference right?

And a thing I forgotten before, Irshell could recognize 1.0 eboots? now with custom firmwares capable to run that eboots it would be a nice feature

and also recognize _SCE_ folders would be great...

however, good work, one of the best homebrew outta here :)

Offline manaox2

  • Newbie
  • *
  • Posts: 2
Re: iR Shell (A Multi-tasking PSP Shell)
« Reply #12 on: August 21, 2006, 01:40:16 PM »
A lot of us would like to see the nokxploit and _sce_ folders idea implemented. Ahman states that that would require A LOT of kernal memory which would frankly not be possible if you ever wished to see updates.

But, seperate versions may be made possible someday I hope. With nokxploit, downgrade possibilities, and devhook, it would be nice.  Ahmans the most dedicated psp programmer I can imagine honestly. Please do not pressure  too much about what could make the GREATEST psp homebrew better as we all look for what achievement the master could come up next. He honestly should charge for programming like this.  ;) $200 is cheap when you have people as generous as this.

Offline AhMan

  • Newbie
  • *
  • Posts: 37
Re: iR Shell (A Multi-tasking PSP Shell)
« Reply #13 on: August 21, 2006, 04:21:03 PM »
The _SCE_ naming isn't supported.  IMO, you can use the traditional corrupt icon hidden trick which yields the same result.  If you're using a custom firmware, you don't even need this funny naming convention.

Offline Sephiroth87

  • Newbie
  • *
  • Posts: 8
Re: iR Shell (A Multi-tasking PSP Shell)
« Reply #14 on: August 21, 2006, 05:27:34 PM »
which one is the traditional? :P