Vita:VitaShell: Difference between revisions
(Mostly copied text from GitHub page, with extras added lie useful tips and a better description for non-homebrew people on the first line) |
|||
(8 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
[https://github.com/TheOfficialFloW/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 (>=3.65) == | |||
VitaShell is included with [[Vita:VitaDeploy|VitaDeploy]]. However, it is recommended to also install it standalone for easier access. | |||
# [https://github.com/RealYoti/VitaShell/releases/latest Download the latest build of VitaShell.] | |||
# Install VitaDeploy through [[Vita:HENlo|henlo_jb]]. | |||
# Start the application for VitaDeploy and select `File Manger` to access its built-in VitaShell. | |||
# 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. | |||
== Changelog == | == Changelog == | ||
See CHANGELOG.md | [https://github.com/TheOfficialFloW/VitaShell/blob/master/CHANGELOG.md See CHANGELOG.md] | ||
== How to use | Files can be transferred to and from your PS Vita using File Transfer Protocol (FTP) programs. | ||
==Transferring Files with FTP == | |||
#Open [[Vita:VitaShell|VitaShell]]. | |||
#Press {{Button|PSvita|Start}}. | |||
#Press {{Button|PSvita|Dpad Down}} twice to {{Button|PSvita|Select}} button option. | |||
#Make sure the option is set to FTP, if it isn't press {{Button|PSvita|Cross}}. | |||
#Press {{Button|PSvita|Circle}} or {{Button|PSvita|Start}} to back out to the main menu. | |||
#Press {{Button|PSvita|Select}} to enable the FTP service. | |||
# On your choice of FTP Browser, enter the provided IP address with the port as `1337`. | |||
#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. | * Format your USB flash drive as exFAT or FAT32. | ||
Line 17: | 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> | * 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 | * Note that this patch is only temporary and you need to redo the procedure every time you launch your PS TV. | ||
== Customization == | == Customization == | ||
Line 143: | Line 156: | ||
Languages files are available in the <code>l10n</code> folder of this repository. | Languages files are available in the <code>l10n</code> folder of this repository. | ||
== Credits == | == Credits == | ||
Line 157: | Line 166: | ||
== Useful tips == | == 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 | |||
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 | |||
Button | |||
Menu contains options for Reboot, Power off and Standby |
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.
- Download the latest build of VitaShell.
- Install VitaDeploy through henlo_jb.
- Start the application for VitaDeploy and select
File Manger
to access its built-in VitaShell. - 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.
Changelog
Files can be transferred to and from your PS Vita using File Transfer Protocol (FTP) programs.
Transferring Files with FTP
- Open VitaShell.
- Press
.
- Press
twice to
button option.
- Make sure the option is set to FTP, if it isn't press
.
- Press
or
to back out to the main menu.
- Press
to enable the FTP service.
- On your choice of FTP Browser, enter the provided IP address with the port as
1337
. - 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 thehome
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 chooseMount 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 chooseRefresh livearea
. This will NOT refresh PSP games unless you have NoPspEmuDrm. - If you wish to revert the patch, press
▲
and selectUnmount 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