2016-08-06 06:59:41 +00:00
# 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.
2016-08-27 10:49:03 +00:00
### Customization ###
2016-08-28 14:36:27 +00:00
You can customize those files:
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/colors.txt'**: All colors adjustable
2016-09-03 21:40:50 +00:00
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/bg_browser.png'**: Background for file browser
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/bg_hexeditor.png'**: Background for hex editor
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/bg_texteditor.png'**: Background for text editor
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/bg_photoviewer.png'**: Background for photo viewer
2016-09-12 15:19:33 +00:00
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/bg_audioplayer.png'**: Background for audio player
2016-08-28 14:36:27 +00:00
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/wallpaper.png'**: Wallpaper #1
2016-08-28 15:47:47 +00:00
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/wallpaperX.png'**: Wallpaper #X (X is a value from 2-10)
2016-08-28 14:36:27 +00:00
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/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).
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/context.png'**: Context menu image (Can be any size. Suggestion: It will look great if you add alpha channel to your image).
2016-09-09 21:16:49 +00:00
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/context_more.png'**: Context menu more image (Can be any size. Suggestion: It will look great if you add alpha channel to your image).
2016-08-28 14:36:27 +00:00
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/battery.png'**: Battery border icon
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/battery_bar_green.png'**: Green battery bar
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/battery_bar_red.png'**: Red battery bar
2016-09-03 19:43:15 +00:00
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/battery_bar_charge.png'**: Charging battery bar
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/ftp.png'**: Ftp icon
2016-09-04 12:37:42 +00:00
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/audio_icon.png'**: Audio icon
2016-09-03 19:43:15 +00:00
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/archive_icon.png'**: Archive icon
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/file_icon.png'**: File icon
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/folder_icon.png'**: Folder icon
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/image_icon.png'**: Image icon
2016-09-04 12:37:42 +00:00
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/sfo_icon.png'**: SFO icon
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/text_icon.png'**: Text icon
2016-09-12 15:19:33 +00:00
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/cover.png'**: Default album cover
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/play.png'**: Play icon
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/pause.png'**: Pause icon
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/fastforward.png'**: Fastforward icon
- **'ux0:VitaShell/theme/YOUR_THEME_NAME/fastrewind.png'**: Fastrewind icon
2016-09-04 12:37:42 +00:00
2016-08-28 14:36:27 +00:00
2016-09-03 20:21:12 +00:00
**Theme setting:** VitaShell will load the theme that is set in ** 'ux0:VitaShell/theme/theme.txt'** (THEME_NAME = "YOUR_THEME_NAME")
2016-08-28 14:37:56 +00:00
2016-09-03 20:21:12 +00:00
**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.
2016-08-28 14:37:56 +00:00
2016-09-03 20:21:12 +00:00
**Wallpapers info:** Wallpapers overlay background images. You can have **ten wallpapers** which VitaShell will display at random interval. If no wallpaper is available, **BACKGROUND_COLOR** from ** 'colors.txt'** will be used.
2016-08-28 14:37:56 +00:00
2016-08-28 14:50:58 +00:00
**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.
2016-08-28 14:36:27 +00:00
2016-08-28 14:51:41 +00:00
The standard VitaShell theme is provided in ** 'VitaShellCustomization.rar'** and available in the ** 'release'** section.
2016-08-27 10:49:03 +00:00
### Multi-language ###
2016-08-27 11:04:44 +00:00
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:**
2016-08-27 10:49:03 +00:00
2016-08-27 10:50:27 +00:00
- japanese
- english_us
- french
- spanish
- german
- italian
- dutch
- portuguese
- russian
- korean
- chinese_t
- chinese_s
- finnish
- swedish
- danish
- norwegian
- polish
- portuguese_br
2016-09-03 21:02:40 +00:00
- turkish
2016-08-27 10:49:03 +00:00
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'.
2016-08-28 14:51:41 +00:00
The english language file is provided in ** 'VitaShellCustomization.rar'** and available in the ** 'release'** section.
2016-08-06 06:59:41 +00:00
2016-08-27 23:29:13 +00:00
### VitaShell themes and translations collection ###
2016-08-27 23:31:04 +00:00
This is an unofficial VitaShell themes and translations collection:
2016-08-27 23:30:18 +00:00
2016-08-27 23:29:13 +00:00
https://github.com/xy2iii/vitashell-themes
2016-08-27 23:30:18 +00:00
2016-08-27 23:31:04 +00:00
Be sure you pull request your customized design or language file there.
2016-08-27 23:29:13 +00:00
2016-09-12 20:34:03 +00:00
### 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/
2016-09-26 10:15:08 +00:00
* Onigmo library https://github.com/k-takata/Onigmo
2016-09-12 20:34:03 +00:00
### Credits ###
* Team Molecule for HENkaku
* xerpi for ftpvitalib and vita2dlib
* wololo for the Revitalize contest
2016-09-12 20:57:16 +00:00
* sakya for Lightmp3
2016-09-12 20:34:03 +00:00
* Everybody who contributed on vitasdk
2016-10-27 18:17:20 +00:00
### Changelog 1.4 ###
2016-10-27 17:48:05 +00:00
- 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'.
2016-10-27 18:17:20 +00:00
- Added scanning for dangerous functions in packages.
2016-10-27 16:38:21 +00:00
- Added possibility to choose compression level.
- Fixed time information in zip archives.
2016-10-15 16:57:27 +00:00
### Changelog 1.31 ###
- Touching the screen on dialogs would abort the process, fixed.
2016-10-15 15:58:12 +00:00
### 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.
2016-09-20 14:28:33 +00:00
### 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.
2016-09-13 21:09:47 +00:00
### 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 ###
2016-09-12 20:34:03 +00:00
- 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).
2016-09-13 21:09:47 +00:00
- Added memory card free space check. A message will pop up if you don't have enough free space for copying or installing.
2016-09-12 20:57:16 +00:00
- 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).
2016-09-12 20:34:03 +00:00
- Improved text editor and added search feature to context menu (press /\).
2016-09-13 21:09:47 +00:00
- The temporary folder 'ptmp/pkg' is now cleared after cancelling or unsuccesful installation.
2016-09-12 20:34:03 +00:00
- Fixed bug where copying to different partitions didn't work.
2016-09-12 20:57:16 +00:00
- Fixed network update bug.
2016-09-12 20:34:03 +00:00
2016-09-09 18:24:51 +00:00
### Changelog 0.95 ###
2016-09-09 17:50:19 +00:00
- 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.
2016-09-04 11:03:18 +00:00
### 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.
2016-09-03 20:42:49 +00:00
### Changelog 0.9 ###
2016-09-03 20:21:12 +00:00
- Added possibility to use specific background for file browser, hex editor, text editor, photo viewer.
2016-09-03 20:42:49 +00:00
- Added files and folder icons by littlebalup.
2016-09-03 19:43:15 +00:00
- Added charging battery icon by ribbid987.
- Added sfo reader by theorywrong.
2016-09-03 19:24:37 +00:00
- Added translation support for turkish (english_gb uses the same id as turkish, fix it Sony!).
2016-09-03 21:57:23 +00:00
- ~~Updated to latest libftpvita which fixed file size string > 2GB and added APPE command.~~
2016-09-03 19:24:37 +00:00
- Fixed bug where copied files and folders of archives didn't stay on clipboard.
- Allow auto screen-off.
2016-09-03 20:42:49 +00:00
- System information trigger combo changed to START instead of L+R+START.
System information can now also be translated, thanks to littlebalup.
2016-09-03 19:24:37 +00:00
2016-08-30 17:48:45 +00:00
### 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.
2016-08-28 14:36:27 +00:00
### 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'.
2016-08-28 15:03:35 +00:00
- Fixed russian and korean language support.
2016-08-28 14:36:27 +00:00
2016-08-27 23:30:18 +00:00
### Changelog 0.8 ###
2016-08-23 12:50:39 +00:00
- Added support for >2GB zip archives (dropped support for 7zip and rar though).
2016-08-23 12:55:51 +00:00
- Added cache system for zipfs (faster file reading when browsing in zip archives).
2016-08-27 10:49:03 +00:00
- Added possibility to customize the application's UI.
- Added possibility to translate the application.
2016-08-23 12:50:39 +00:00
- Fixed 12h time conversion.
2016-08-06 06:59:41 +00:00
### 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.
2016-09-12 20:57:16 +00:00
- The application now cleans itself before launching homebrews.
