Vita:VitaShell: Difference between revisions

From ConsoleMods Wiki
Jump to navigation Jump to search
(Add FTP instructions here)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
[https://github.com/TheOfficialFloW/VitaShell VitaShell] is an advanced file manager, package installer, text editor, and video/photo player. It has built-in FTP, allows mounting Vita as a flash drive, and allows mounting a USB flash drive as a drive on the Vita. This homebrew was an entry of the Revitalize PS Vita homebrew competition and won the first prize. HENkaku's molecularShell is also based on VitaShell.
[https://github.com/TheOfficialFloW/VitaShell VitaShell] is an advanced file manager, package installer, text editor, and video/photo player. It has built-in FTP, allows mounting Vita as a flash drive, and allows mounting a USB flash drive as a drive on the Vita. This homebrew was an entry of the Revitalize PS Vita homebrew competition and won the first prize. HENkaku's molecularShell is also based on VitaShell.


== Installation ==
== Installation (>=3.65) ==
VitaShell is included with [[Vita:VitaDeploy|VitaDeploy]]. However, it is recommended to also install it standalone for easier access.  
VitaShell is included with [[Vita:VitaDeploy|VitaDeploy]]. However, it is recommended to also install it standalone for easier access.  


It is also recommended to use [https://github.com/LiEnby/VitaShell LiEnby's fork of VitaShell], as it comes with some fixes and allows for refreshing PSP/PS1 and PSM content in the LiveArea.
# [https://github.com/RealYoti/VitaShell/releases/latest Download the latest build of VitaShell.]
 
# Install VitaDeploy through [[Vita:HENlo|henlo_jb]].
# [https://github.com/LiEnby/VitaShell/releases/latest Download the latest build of VitaShell.]
# Start the application for VitaDeploy and select `File Manger` to access its built-in VitaShell.
# Install VitaDeploy through [https://github.com/SKGleba/henlo_jb henlo_jb].
# Start the application for VitaDeploy and select its built in VitaShell.
# With USB or FTP, transfer the VPK of VitaShell to a folder inside the ux0:/ partition.
# With USB or FTP, transfer the VPK of VitaShell to a folder inside the ux0:/ partition.
# Navigate to the location of the VPK while on the Vita, highlight the file, and press X to install it.
# Navigate to the location of the VPK while on the Vita, highlight the file, and press X to install it.
Line 32: Line 30:
* Once <code>uma0:</code> is listed under the partitions, press <code>▲</code> again and choose <code>Mount USB ux0:</code>. This will copy important apps like VitaShell, molecularShell, and other files.
* Once <code>uma0:</code> is listed under the partitions, press <code>▲</code> again and choose <code>Mount USB ux0:</code>. This will copy important apps like VitaShell, molecularShell, and other files.
* Your USB flash drive is now acting as a Memory Card.
* Your USB flash drive is now acting as a Memory Card.
* To sync all your apps on your USB flash drive, press <code>▲</code> and choose <code>Refresh livearea</code>. This will NOT refresh PSP games.
* To sync all your apps on your USB flash drive, press <code>▲</code> and choose <code>Refresh livearea</code>. This will NOT refresh PSP games unless you have NoPspEmuDrm.
* If you wish to revert the patch, press <code>▲</code> and select <code>Unmount USB ux0:</code>.
* If you wish to revert the patch, press <code>▲</code> and select <code>Unmount USB ux0:</code>.
* Note that this patch is only temporary and you need to redo the procedure every time you launch your PS TV.
* Note that this patch is only temporary and you need to redo the procedure every time you launch your PS TV.

Latest revision as of 16:39, 19 August 2024

VitaShell is an advanced file manager, package installer, text editor, and video/photo player. It has built-in FTP, allows mounting Vita as a flash drive, and allows mounting a USB flash drive as a drive on the Vita. This homebrew was an entry of the Revitalize PS Vita homebrew competition and won the first prize. HENkaku's molecularShell is also based on VitaShell.

Installation (>=3.65)

VitaShell is included with VitaDeploy. However, it is recommended to also install it standalone for easier access.

  1. Download the latest build of VitaShell.
  2. Install VitaDeploy through henlo_jb.
  3. Start the application for VitaDeploy and select File Manger to access its built-in VitaShell.
  4. With USB or FTP, transfer the VPK of VitaShell to a folder inside the ux0:/ partition.
  5. Navigate to the location of the VPK while on the Vita, highlight the file, and press X to install it.

Changelog

See CHANGELOG.md

Files can be transferred to and from your PS Vita using File Transfer Protocol (FTP) programs.

Transferring Files with FTP

  1. Open VitaShell.
  2. Press Start.
  3. Press Dpad Down twice to Select button option.
  4. Make sure the option is set to FTP, if it isn't press Cross.
  5. Press Circle or Start to back out to the main menu.
  6. Press Select to enable the FTP service.
  7. On your choice of FTP Browser, enter the provided IP address with the port as 1337.
  8. You now you have an FTP connection to your PS Vita.

How to use a USB flash drive as Memory Card on a PS TV

  • Format your USB flash drive as exFAT or FAT32.
  • Launch VitaShell and press in the home section.
  • Select Mount uma0: and attach your USB flash drive. You can now copy stuff from/to your USB stick.
  • Once uma0: is listed under the partitions, press again and choose Mount USB ux0:. This will copy important apps like VitaShell, molecularShell, and other files.
  • Your USB flash drive is now acting as a Memory Card.
  • To sync all your apps on your USB flash drive, press and choose Refresh livearea. This will NOT refresh PSP games unless you have NoPspEmuDrm.
  • If you wish to revert the patch, press and select Unmount USB ux0:.
  • Note that this patch is only temporary and you need to redo the procedure every time you launch your PS TV.

Customization

You can customize those files:

File Note
colors.txt All colors adjustable
archive_icon.png Archive icon
audio_icon.png Audio icon
battery.png Battery border icon
battery_bar_charge.png Charging battery bar
battery_bar_green.png Green battery bar
battery_bar_red.png Red battery bar
bg_audioplayer.png Background for audio player
bg_browser.png Background for file browser
bg_hexeditor.png Background for hex editor
bg_photoviewer.png Background for photo viewer
bg_texteditor.png Background for text editor
context.png Context menu image (Can be any size. Suggestion: It will look great if you add alpha channel to your image)
context_more.png Context menu more image (Can be any size. Suggestion: It will look great if you add alpha channel to your image)
cover.png Default album cover
dialog.png Dialog menu image (Can be any size. This image file will be stretched by VitaShell to fit the dialog box. Suggestion: Don't use motives, as it will not look good with wrong proportion)
fastforward.png Fastforward icon
fastrewind.png Fastrewind icon
file_icon.png File icon
folder_icon.png Folder icon
ftp.png FTP icon
image_icon.png Image icon
pause.png Pause icon
play.png Play icon
settings.png Settings icon
sfo_icon.png SFO icon
text_icon.png Text icon
wallpaper.png Wallpaper

Theme setting: VitaShell will load the theme that is set in ux0:VitaShell/theme/theme.txt (THEME_NAME = "YOUR_THEME_NAME")

General info: You don't need to have all these files in your custom theme, if one of them is missing, the default image file will be loaded instead.

Dialog and context image: If these files are not available, the colors DIALOG_BG_COLOR and CONTEXT_MENU_COLOR from colors.txt will be used instead.

Multi-language

Put your language file at ux0:VitaShell/language/x.txt, where the file must be UTF-8 encoded and x is one of the language listed below:

  • japanese
  • english_us
  • french
  • spanish
  • german
  • italian
  • dutch
  • portuguese
  • russian
  • korean
  • chinese_t
  • chinese_s
  • finnish
  • swedish
  • danish
  • norwegian
  • polish
  • portuguese_br
  • turkish

VitaShell does automatically load the language that matches to the current system language. If your system language is for example french, it will load from ux0:VitaShell/language/french.txt.

Languages files are available in the l10n folder of this repository.

Credits

  • Team Molecule for HENkaku
  • xerpi for ftpvitalib and vita2dlib
  • wololo for the Revitalize contest
  • sakya for Lightmp3
  • Everybody who contributed on vitasdk

Useful tips

  • The Start button opens the menu options. See "SELECT button" option in the menu to switch between FTP or USB mounting (Wireless or using USB cable)
  • The Triangle gives you options on the current file/folder
  • The X Button goes into a folder, the O Button goes back up. Square allows selecting multiple folders/files.
  • Menu contains options for Reboot, Power off and Standby