Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/TheOfficialFloW/VitaShell

Multi-functional file manager for PS Vita
https://github.com/TheOfficialFloW/VitaShell

Last synced: about 2 months ago
JSON representation

Multi-functional file manager for PS Vita

Awesome Lists containing this project

README 

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



## Changelog

See [CHANGELOG.md](CHANGELOG.md)



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



## Building

Install [vitasdk](https://github.com/vitasdk) and build VitaShell using:



```

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