FMVita
Multifunctional File Manager for PS Vita with a modernized interface and touchscreen compatibility.
README
File Manager Vita
File Manager Vita - Gerenciador de arquivos completo e otimizado para o PlayStation Vita.
RELEASEV0.6.2 PLATFORMPS VITA LICENSEGPL-3.0
Instalação • Recursos • Diretórios • Build & Compilação • Histórico
FMVita is an enhanced fork of VitaShell (originally created by TheFloW). This version focuses on usability, expanding touchscreen support for the PS Vita, introducing animated backgrounds, various Quality of Life (QoL) improvements, and a new program file organization under the independent directory ux0:FMVita/.
Installation
FMVita was designed to prevent conflicts with your current configuration. Therefore, it features a unique Title ID and its own dedicated folder structure.
- Zero Conflicts: It can be installed side-by-side with the original VitaShell, OneMenuPlus, MolecularShell, or any other file manager.
- How to Install: Simply transfer the FMVita
.vpkfile to your console (via FTP or USB) and install it using VitaShell (or any other file manager application you currently use).
Key Differences and New Features
Interface and Themes
- Eight Color Presets: Dark, Light, Blue, Red, Purple, Brown, Gray, and Custom. The system automatically calculates text, highlight, selection, dialog, and border colors.
- Custom Theme Support: Select the Custom preset and edit
ux0:FMVita/colors.txtto fully define every color in the interface. - Quick Action Toolbar: A new toolbar featuring 9 quick shortcuts: Move, Copy, Paste, Delete, Rename, Filter, Group, Search, and New.
- Transparency: The interface elements (topbar, cards, and buttons) feature a reduced alpha channel when using image backgrounds (GIF or PNG) for better visibility.
- Themed Scrollbar: An adaptive scrollbar that matches the theme's highlight color.
- Redesigned Address Bar: Now displays the current directory path, battery status, and clock.
- Partial Support for VitaShell Themes: Due to the nature of the original project, themes developed for VitaShell are not 100% compatible with this version, only taking advantage of certain elements such as file icons.
Animated Backgrounds
- Four Procedural Animations: Particles (floating PlayStation icons), Waves (colored mist), Stars (starfield), and Squares (PS2-styled falling rectangles).
- Animated GIF Support: Loads from
ux0:FMVita/Gif/theme.gif(Mode 4) with multiple fallbacks. Powered by anstb_imageengine featuring frame delay control, cover-fit scaling, and clipping. Requires 960×540, 8-bit color. - Static PNG Support: Native loading from
ux0:FMVita/Background/bg.png(Mode 5). Requires 960×540, 8-bit color.
Touchscreen Support
- Native Dialogs: The old system YES/NO prompt has been replaced by custom Touch Dialogs (Confirmation, Deletion, and FTP) styled with PlayStation button icons.
- Drag-and-Drop: Hold
Square+ Touch (or perform a long press) to drag files into other folders. Features Auto-scroll when moving items near the screen edges. - Swipe Gestures: Swipe Left to go Back, Swipe Right to Enter.
- Multi-tap: Double-tap and hold to open the context menu.
- Mouse Cursor: Control a mouse pointer using the right analog stick (click with
Cross), featuring a smooth fade effect after inactivity.
Navigation and Layout
- View Modes: Four layout options available under Settings → View Mode:
- List — Traditional single-column list view.
- Grid — Icon-based tile grid view.
- 2 Columns — Split-screen view showing Parent and Current folders side-by-side, each occupying exactly 50% of the screen width.
- 3 Columns — Three-panel view (Grandparent / Parent / Current) for ultra-fast directory browsing.
- Column View Touch Navigation: Highlights the active folder in gold within the upper columns and allows direct touch navigation on any column.
- Page Speed: Configurable scroll repeat speed in Settings → Page Speed, applies to both D-PAD and analog stick navigation.
- Bookmarks and Recents: The
Squareshortcut jumps directly to your bookmarks; theTriangleshortcut navigates to recent files (which automatically generate.lnksymlinks). - Search Tools: A Filter system (All/Folders/Files) on the toolbar and case-insensitive Search within the current directory.
- Enhanced Scrolling: Infinite scroll wrapping (from top to bottom and vice versa) and smooth lerp-based scrolling with acceleration.
- Transition Animations: Configurable Slide, Smooth Slide, or Fade transitions when navigating between folders. Can be disabled.
- Symlinks: Optimized tracking via a
SymlinkDirectoryPathlinked list to ensure correct navigation through shortcuts.
VPK Management
- Batch VPK Installation: Mark multiple VPK files and install them all sequentially in one go — no need to install one at a time.
- Background VPK Installation: VPK installation runs from the file browser, no longer dependent on PKGj.
- Post-Install Launch: Optionally launch the just-installed application directly after installation.
- QR Code Download & Auto-Install: Scan a QR code containing a VPK URL to download and auto-install directly.
FTP Server
- Wi-Fi Auto-Check: If Wi-Fi is off, FMVita will prompt you to enable it before starting the FTP server — no more silent failures.
- Improved Status Messages: FTP operations now display human-readable progress descriptions and current activity (upload, download, rename, etc.).
- Progress Tracking: File transfer operations show 0–100% progress in the FTP status modal.
- Auto-Refresh on Close: The current folder is automatically refreshed when the FTP server is stopped.
Image Viewer
- Open any PNG, JPEG, BMP, or GIF image directly from the file browser.
- Supports zoom, pan, and mirror operations with touch and button controls.
Undo System
- Undo Move and Copy actions directly from the context menu (
UNDO_ACTION). - Undo Move: Reverts the
sceIoRenamecommand. - Undo Copy: Cleanly deletes the file copied by mistake.
- The Undo option appears dynamically and also registers actions performed via Drag-and-Drop.
Security and Configuration
- System Protection: Renaming locks on critical system folders (verified via
isProtectedPath()) with custom error messages. - Independent Settings: Reads and writes directly to
ux0:FMVita/settings.txt(use_custom_config = 1by default; can be temporarily disabled by holdingLduring boot). - Language Switching: Change the interface language without rebooting the console — FMVita restarts itself to apply the change instantly.
- New Menu Options: USB Device (4 modes), SELECT Button (USB/FTP/QR), View Mode (List/Grid/2 Columns/3 Columns), Background Anim (7 modes), Theme Preset (8 options), Page Speed, Transition Mode, and Scroll Loop.
Removed Features and Optimizations
To keep the application lightweight and focused purely on file management, the following features from the original VitaShell have been deprecated or hidden: * HENkaku Settings menu (PSN spoofing, unsafe homebrew toggle, version spoofing). * Disable Auto-Update and Disable Warning Messages. * Rear Touchpad support.
Directory Structure Changes
FMVita completely isolates its data from the original VitaShell:
| Original (VitaShell) | FMVita |
|---|---|
ux0:VitaShell/settings.txt |
ux0:FMVita/settings.txt |
ux0:VitaShell/language/ |
ux0:FMVita/language/ |
ux0:VitaShell/theme/ |
ux0:FMVita/theme/ |
ux0:data/lastdir.txt |
ux0:FMVita/internal/lastdir.txt |
ux0:VitaShell/bookmarks/ |
ux0:FMVita/bookmarks/ |
ux0:data/recent/ |
ux0:FMVITA/recent/ |
ux0:app/VITASHELL/module/* |
ux0:FMVita/module/* |
| (Did not exist) | ux0:FMVita/Gif/theme.gif |
| (Did not exist) | ux0:FMVita/Background/bg.png |
| (Did not exist) | ux0:FMVita/colors.txt |
Technical Details and Build
Source Code Modifications
- New Modules:
modules/kernel/(loads its ownumass.skprx),modules/patch/,modules/user/, and theusbdevice/driver. - New Files: Implemented
buttons.c/.hfor PlayStation button rendering,main_context.cfor reorganized context submenus, and a GIF decoding engine usingstb_image.h. - Localization (
english_us.txt): Over 40 new entries integrated and copied to the native directory upon first launch. Language switch now restarts only FileManager, not the console. - Internal Refactoring: Added over 30 inline theme color functions in
main.h, restructuredbrowser.c(fixing D-PAD scroll issues, column views with proper 50/50 split, touch engine), and cleaned up legacy options insettings.c.
Build Instructions
Requires vitasdk and the standard toolchains properly installed and configured.
mkdir build
cd build
cmake ..
make
Or use the provided script:
export VITASDK=/usr/local/vitasdk
./build.sh
Changelog
v0.5.0 — 2026-06-17
- 2 Columns view — 50/50 split: The two-column layout now divides the screen evenly (each column gets exactly 50% width), eliminating empty space on the right.
- Improved text clipping in column modes: Filename display boundaries are now dynamic — text is correctly clipped and scrolled within each column without spilling over.
- Grandparent panel restricted to 3 Columns: The grandparent folder panel is no longer drawn in 2 Columns mode, keeping the layout clean.
- Better mouse hover in column modes: Hover highlights are now correctly bounded to the active column area only.
- Language switch restarts FileManager (not console): Changing the language in Settings now triggers a FileManager restart instead of a full console reboot.
- Custom theme preset: Added a "Custom" theme option that reads colors from
ux0:FMVita/colors.txt. - Batch VPK installation: Mark multiple VPKs and install them all in sequence.
- FTP Wi-Fi check modal: FTP now warns if Wi-Fi is disabled before starting.
- FTP status improvements: More readable transfer descriptions and 0–100% progress tracking.
- Auto-refresh on FTP close: Current folder refreshes automatically after FTP is stopped.
- Background image validation: PNG/GIF backgrounds are now validated for 960×540 resolution and 8-bit color depth.
- Page Speed via D-PAD and Analog stick: Configurable scroll repeat rate now applies to both input methods.
- Transition animation fixes: Slide and Fade transitions overhauled to avoid visual bugs.
v0.4.5
- View Mode with 3 Columns panel layout (Grandparent / Parent / Current).
- Grid view with icon tiles.
- Transition animations (Slide, Smooth Slide, Fade).
- Page speed setting for scroll rate.
- Scroll Loop toggle (wrap from top to bottom).
- Enhanced toolbar with 8 quick actions.
- Undo system for Move and Copy.
- Drag-and-drop file management with auto-scroll.
v0.4.3
- QR code download and auto-install.
- Touch-friendly confirmation dialogs (no system dialogs).
- Post-install app launch.
- VPK context menu integration.
- Video player improvements.
- PlayStation button texture rendering.
Credits
- TheFloW — Creator of the original VitaShell.
- Team Molecule — HENkaku.
- xerpi — ftpvitalib and vita2dlib libraries.
- Sean Barrett — stb_image implementation.
- Icons8 — "Liquid Glass" style icon set used by the Icons theme.
- WolffsRoom — FMVita development, visual modifications, and engine.
AI Notice
Artificial Intelligence tools were utilized as a support resource during the development of this project: * Gemini (Google DeepMind): Assisted in bug fixing, logical troubleshooting, C code optimization, and feature implementation throughout all phases. * Claude: Used for brainstorming, project structuring, and prototyping new features.