joel16/VitaShell
1
0
Fork 0
mirror of https://github.com/joel16/VitaShell.git synced 2024-11-23 11:49:40 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
4cdbe428c1
VitaShell/README.md
TheOfficialFloW dc50b1b1d5
Removed donation link
2018-06-24 11:57:12 +02:00

402 lines
18 KiB
Markdown
Raw Blame History

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:`. 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.
- If you wish to revert the patch, press `/\` and select `Umount USB ux0:`.
- Note that this patch is only temporary and you need to redo the procedure everytime 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.
For developers
--------------
1. Install [vitasdk](https://github.com/vitasdk)
2. Clone this repository and compile the kernel module first at `VitaShell/modules/kernel` then the user module at `VitaShell/modules/user`. Both times compile it using `mkdir build && cd build && cmake .. && make install`
3. After these modules have been successfully compiled, return to the main directory and compile with `mkdir build && cd build && cmake .. && make`
Credits
-------
* Team Molecule for HENkaku
* xerpi for ftpvitalib and vita2dlib
* wololo for the Revitalize contest
* sakya for Lightmp3
* Everybody who contributed on vitasdk
Changelog
---------
### Changelog 1.94
- Added ability to umount all partitions that you can mount.
- Fixed crash when using StorageMgr.
### Changelog 1.93
- Added xmc0: to partition list and added ability to mount xmc0:.
- Fixed ux0: mounting bug where it wasn't detected that the gamesd has already been mounted.
### Changelog 1.92
- Added ability to mount gamesd ux0:
- Fixed bug where the VitaShell kernel module was loaded but not started, thus it'd run out of memory after some launches.
### Changelog 1.91
- Added ability to create new files, thanks to abertschi.
- Added ability to skip last dir by holding L on startup.
- Added support for firmware 3.68.
### Changelog 1.9
- Added ability to open decrypted trophys, savedatas and appmetas.
- Moved `Open Decrypted` entry to main context menu for faster access.
### Changelog 1.83
- Fixed automatic network update by using rawgit. This was needed because github removed support for TLS 1.0/1.1.
- Removed changelog support, because the files at ux0:patch must now be pfs encrypted.
### Changelog 1.82
- Added support for firmware 3.65/3.67.
### Changelog 1.81
- Added adhoc file transfer feature.
- Fixed bug where it didn't count files and folders in archives correctly.
- Improved controls code.
### Changelog 1.8
- Aligned memory to 64bit for optimal I/O.
- Fixed crash when using FTP.
### Changelog 1.79
- Added ability to open .psarc files.
- Added support for multi volume rar archives.
- Added support for password encrypted zip archives.
- Added support for file property in archives, now it can show size and contains.
- Added natural sorting for filenames.
- Fixed bug where size of files in archives over 2GB where shown as 16EB.
- Fixed refresh license DB when ran from ur0:.
### Changelog 1.78
- Fixed bug where archives > 2GB couldn't be opened.
### Changelog 1.77
- Added archive support for .7z, .tar.gz, .tar.bz2 and more by using libarchive.
- Improved archive file system (opening archives should now be much faster).
- Fixed keyboard freeze after using it multiple times.
- Fixed file browser cursor correction.
- Fixed Electron theme visual glitch and added new settings look (thanks to Acemad).
### Changelog 1.76
- Added DLC refresh + restore license from Sqlite DB by VitaSmith.
- Added license database refresh by VitaSmith.
- Fixed C2-12828-1 error.
### Changelog 1.75
- Fixed bug where Memory Card was umounted after closing USB (fixed `The file is corrupt` error).
- Fixed QR download of URLs that link to files.
### Changelog 1.74
- Fixed QR download and C2-13696-5 error.
### Changelog 1.73
- Fixed crash when you pressed triangle in the home menu.
### Changelog 1.72
- Fixed pfs mounting bug where you could not export files from specific folders.
- Fixed bug where files from https could not be downloaded using QR code.
- Fixed bug with pvsd usb device mounting where microSD could not be found.
### Changelog 1.71
- Fixed pvsd usb device mounting.
- Fixed bug where uma0: options were grayed out on non PS TV models.
- Fixed bug where the QR code scanner showed the result twice.
### Changelog 1.7
- Added QR Code scanner and file downloader by cxziaho (press L+R to open the camera).
- Added option in `More->` to open applications in decrypted mode (bypass PFS). Thanks to frangarcj.
- Added ability to mount sd2vita and psvsd as usb device.
- Fixed bug where `imc0:` could not be mounted if the Memory Card was not available.
- Fixed bug where accessing the settings menu crashed if there was no Memory Card available.
- Fixed bug where automatic usb connection was not blocked, after leaving and resuming VitaShell.
- PS TV will now always open FTP when pressing SELECT.
### Changelog 1.63
- Added ability to export video files.
- Added support for PSVSD uma0: mounting.
- Fixed bug where the right analog stick was simulated when the headphone was plugged in.
### Changelog 1.62
- Fixed bug where the cursor was moving too fast when the headphone was plugged in.
### Changelog 1.61
- Fixed database corruption crash by inheriting `calendar`, `mms` and `mtp` when mounting USB ux0:.
- Fixed bug where insufficent memory dialog appeared on uma0:.
- Fixed bug where pressing triangle crashed if unsafe mode was disabled.
### 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!).
- 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 canceled.
- 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.
Reference in New Issue View Git Blame Copy Permalink