VitaShell/README.md

# VitaShell #

VitaShell is an alternative replacement of the PS Vita's LiveArea. It offers you a file manager, package installer, built-in FTP and much more.
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.

### How to use an 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:'.
- 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.
- If you wish to revert the patch, press /\ and select 'Umount USB ux0:'.

### Customization ###
You can customize those files:
- **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**: Background for settings
- **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.

The standard VitaShell theme is provided in **'VitaShellCustomization.rar'** and available in the **'release'** section.

### 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'.

The english language file is provided in **'VitaShellCustomization.rar'** and available in the **'release'** section.

### VitaShell themes and translations collection ###
This is an unofficial VitaShell themes and translations collection:

https://github.com/xy2iii/vitashell-themes

Be sure you pull request your customized design or language file there.

### In order to compile VitaShell you'll need ###
* vitasdk: https://github.com/vitasdk
* vita2dlib: https://github.com/xerpi/vita2dlib
* ftpvitalib https://github.com/xerpi/ftpvitalib
* EasyRPG libraries: https://ci.easyrpg.org/view/Toolchains/job/toolchain-vita/
* Onigmo library https://github.com/k-takata/Onigmo
* UnRAR http://www.rarlab.com/

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

### Changelog 1.60 ###
- Added ability to mount uma0: and ability to use uma0: as ux0:.
- Added ability to mount game card as usb device.
- Added possibility to refresh the livearea.
- Added scrolling text for long filenames.
- Added 'Sort by' option to context menu (R trigger combo removed).
- Added 'Electron' theme by Acemad, the winner of the VitaShell theme contest.
- Added theme selector.
- Improved property dialog animation.
- Fixed text editor bugs.
- Fixed bug where USB cable wasn't recognized.
- Fixed bug where VitaShell left to livearea after deleting the updater.
- Removed battery icon in status bar for PSTV.
- File statistics are now inherited when copying.
- I/O operations speed will now be showed in KB/s.
- Made control smoother.

### Changelog 1.51 ###
- Fixed bug where 'Please wait...' was shown instead of a specifc USB message.
- Fixed VPK installation crash.
- Fixed bug where 'theme.txt' was always resetted.
- Updated to newest libftpvita.

### Changelog 1.50 ###
- Added USB mass storage transfer support.
- Added RAR archive support (by Mayoshiroi).
- Added coredump viewer.

### Changelog 1.43 ###
- Added taiHEN config.txt reload option available in molecularShell.
- Changed default HENkaku spoofed version to 3.63.
- Fixed bug where you couldn't exit the application.

### Changelog 1.42 ###
- Added a brand new settings menu which is accessible by pressing START (design by WesleyPolicena).
  This adds the ability to disable auto-update and power options have been added where you can
  reboot, enter standby or turn off your device.
- Fixed local date being incorrect.
- The name 'molecularShell' will now be displayed if it's runned as molecularShell, otherwise 'VitaShell'.
  This will help differentiating the two applications, as molecularShell is from now on a safe homebrew
  and doesn't have the full range of features like VitaShell. Additionally in molecularShell you can see
  the HENkaku settings section which are hidden in VitaShell (note that both still share the same eboot.bin,
  only the flag is different).

### Changelog 1.41 ###
- Added ability to sort files and folders by size and date. Press R to switch sort method.
- Added the long desired 'Properties' feature. You can also check whether an eboot.bin is safe or not.

### Changelog 1.4 ###
- Added group RW permissions on files and folders when moving.
  Safe homebrews like RetroArch will now recognize files and folders
  that you have moved from 'ux0:video'.
- Added scanning for dangerous functions in packages.
- Added possibility to choose compression level.
- Fixed time information in zip archives.

### Changelog 1.31 ###
- Touching the screen on dialogs would abort the process, fixed.

### Changelog 1.3 ###
- Added ability to compress files and folders into a zip archive.
- Added scanning for unsafe fself's and imports.
- Added lrc support for audio player by Mayoshiroi.
- Added partition used/total size information, thanks to littlebalup.
- Added 'Install folder' by soarqin.

### Changelog 1.2 ###
- Added ability to export photo and music files ('More' -> 'Export media').
- Added battery percentage to system information (thanks to littlebalup).
- Added toolbox where more features will have place, by theorywrong (press START).
- Improved stability for file browser delete operation.
- Pressing L in the music player will now restart the song if the song is not at the beginning.
- VitaShell will now remove the unused updater bubble after successful updating.

### Changelog 1.1 ###
- Added cover.jpg and folder.jpg as alternative cover image.
- Fixed ID3 tag parsing.
- Play and pause icons where swapped, fixed.
- FTP does now show 'Please wait...' until it has been connected to Wi-Fi.

### Changelog 1.0 ###
- Added audio player with .MP3 and .OGG support (Press /\ to turn off the display while listening to music. Graphics by Valle).
- Added changelog to the VitaShell bubble (press /\ or hold the bubble of VitaShell in the livearea).
- Added ability to resume to the directory you've last visted before exiting VitaShell).
- Added memory card free space check. A message will pop up if you don't have enough free space for copying or installing.
- Leaving to livearea or suspending the device does no longer corrupt an IO process anymore (while copying things you can now leave VitaShell and resume).
- Improved text editor and added search feature to context menu (press /\).
- The temporary folder 'ptmp/pkg' is now cleared after cancelling or unsuccesful installation.
- Fixed bug where copying to different partitions didn't work.
- Fixed network update bug.

### Changelog 0.95 ###
- Added ability to install update files as .vpk (for Vitamin).
- Added patch to make .vpk installation appearing as full version instead of test version.
- Added text editor by BigBoot (WIP).
- Added 'More' entry to the context menu.
- Added 'Install all' feature to install all packages available in the folder (by ribbid987).
- Added 'Calculate SHA1' feature by xerpia64.
- Added support for ftp promoting for https://github.com/soywiz/vitaorganizer.
- Fixed 'Move' operation. Now it does integrate into folders and replace files.
- Dropped GENERAL_COLOR, now all colors are adjustable.

### Changelog 0.91 ###
- Added automatic network update. VitaShell will now notify you when there's a new update.
  You'll then be able to download it within the VitaShell application and it will update both
  molecularShell and VitaShell to the newest verison.
- Added text and audio file icon by littlebalup.
- Updated to latest libftpvita which fixed file size string > 2GB and added APPE command.

### Changelog 0.9 ###
- Added possibility to use specific background for file browser, hex editor, text editor, photo viewer.
- Added files and folder icons by littlebalup.
- Added charging battery icon by ribbid987.
- Added sfo reader by theorywrong.
- Added translation support for turkish (english_gb uses the same id as turkish, fix it Sony!).
- ~~Updated to latest libftpvita which fixed file size string > 2GB and added APPE command.~~
- Fixed bug where copied files and folders of archives didn't stay on clipboard.
- Allow auto screen-off.
- System information trigger combo changed to START instead of L+R+START.
  System information can now also be translated, thanks to littlebalup.

### Changelog 0.86 ###
- Added dialog box animation and aligned dialog box y to make it look better.
- Fixed wrong time string for files and folders. Thanks to persona5.
- Fixed INSTALL_WARNING text crash.
- Added default files creating.

### Changelog 0.85 ###
- Added customization possibility for ftp icon, battery, dialog and context menu.
- Added random wallpaper feature.
- Changed location of themes to 'ux0:VitaShell/theme/YOUR_THEME_NAME'.
- Fixed russian and korean language support.

### Changelog 0.8 ###
- Added support for >2GB zip archives (dropped support for 7zip and rar though).
- Added cache system for zipfs (faster file reading when browsing in zip archives).
- Added possibility to customize the application's UI.
- Added possibility to translate the application.
- Fixed 12h time conversion.

### Changelog 0.7 ###
- Ported to HENkaku (support for renaming/creating folders and for analog stick for fast movement).
- Added custom dialogs.
- Added graphics by Freakler.
- Added possibility to use FTP in background.
- I/O operations can now be cancelled.
- Removed misc stuff, shader compiler, homebrew loading, PBOOT.PBP signing, network host.
- Fixed various bugs.

### Changelog 0.6 ###
- Fixed size string of files, again.
- Optimized I/O operations regarding speed.

### Changelog 0.5 ###
- Increased homebrew force-exit compatbility and stability.
- Added network host mountpoint.
- Added ability to compile shader programs (use the _v.cg suffix for vertexes and _f.cg for fragments).
- Finished photo viewer. Use the right analog stick to zoom in/out. Left analog stick to move.
  L/R to rotate and X/O to change display mode.
- Updated to newest vita2dlib which fixed many bugs with images.
- Improved 'New folder' by extending to 'New folder (X)', where 'X' is an increasing number.
- Improved message dialog texts.
- Limited filenames so it doesn't overlap with the size/folder text. 
- Fixed infinite loop when copying the src to its subfolder by an error result.
- Fixed FTP client crashes and added support for Turboclient Android.
- Fixed alphabetical sorting, finally.

### Changelog 0.4 ###
- Added experimental feature: Holding START to force exit homebrews.
- Added battery symbol by Ruben_Wolf.
- Switched to official PGF font.
- Changed triangle-menu animation to ease-out.
- Improved mark all/unmark all feature.
- Fixed percentage precision in progress bar.
- Fixed small bug in move operation.

### Changelog 0.3 ###
- Added translation support. See translation_readme.txt for more details.
- Added move ability (only possible within same partition).
- Added tabulator support in text viewer.
- Removed 'Paste', 'Delete', 'Rename' and 'New folder' in read-only partitions.
- Fixed size string of files over 1GB.
- Fixed alphabetical sorting.
- Fixed battery percent bug being -1% on PSM Dev Assistant.

### Changelog 0.2 ###
- Added ability to sign PSP homebrews.
- Added sleep prevention when using FTP, deleting and copying files.
- Added a scrollbar.
- Added date and time to info bar.
- Added correct enter and cancel buttons assignment.
- Added some cosmetic changes.
- Fixed crash when deleting marked entries.
- Copied entries now still rest in clipboard after pasting them.
- The application now cleans itself before launching homebrews.