GitHub Vita Lite - Wolff's Store
Code / README | Releases | Issues
WolffsRoom/FileManager

README.md

18515 bytes ยท Original / download

File Manager for PlayStation Vita

A native file manager for PlayStation Vita, built with Sony's ScePaf interface.
Not just a file manager. A true Vita experience.

RELEASEV0.30-BETA STATUSBETA PLATFORMPS VITA LICENSEGPL-3.0

Overview - [What This Project Is](#what-this-project-is) - [Features](#features) - [Screenshots](#screenshots) - [Controls](#controls) - [Installation](#installation)
Development - [Building from Source](#building-from-source) - [Architecture](#architecture) - [Version History](#version-history) - [Current Status and Limitations](#current-status-and-limitations) - [Credits](#credits)

What This Project Is

File Manager is a file explorer designed specifically for the PlayStation Vita. Unlike most Vita homebrew file managers, its new interface is written on top of ScePaf, the PlayStation Application Framework used by Sony's own system applications. It therefore uses native widgets, sounds, transitions and dialogs that feel at home on the console.

The project carries forward the proven file-management logic of FMVita, itself based on VitaShell, while replacing the previous vita2d interface with a new native application. It has its own Title ID, FILEMGR01, and can be installed alongside VitaShell and FMVita.

File Manager - The missing piece of PlayStation Vita

[!WARNING] This beta is intended for testing on real hardware. Keep backups of important files before using copy, move, delete, rename or VPK installation features.

Features

Native Interface and Navigation

File Operations

VPK and Network Tools

Screenshots

Main storage screen Main screen folders

File operations menu Theme selection

File search Text file preview

FTP server VPK installation

File Manager LiveArea

Controls

Control Action
Cross / touch Open
Circle / lower-left button Go back
Triangle / lower-right button Options and settings
Square / long press Mark an item
Select FTP server or QR Code, configurable
Start Search in the open folder
L / R First / last list item
D-pad left / right Go back / open focused folder
L / R in a preview Previous / next file

Installation

  1. Download the latest .vpk from Releases.
  2. Transfer it to the console using USB or FTP.
  3. Install it with VitaShell, FMVita or another VPK-capable file manager.
  4. Launch File Manager from LiveArea.

File Manager uses Title ID FILEMGR01, so it installs alongside other file managers without replacing them.

Building from Source

The provided script uses the standard vitasdk/vitasdk Docker image:

sh scripts/build.sh

The resulting package is written to build/FileManager.vpk.

The build is hard-float and uses -mword-relocations. Both are required for correct ScePaf ABI and imported-variable handling. The build also needs Python 3 for the repository's RCO compiler.

PC Interface Viewer

Vita3K cannot run ScePaf applications, so tools/ui_viewer/ provides a browser-based preview for layout, themes, text and navigation-flow validation:

python tools/rcoc.py compile resource/file_manager_plugin.xml -o build/file_manager_plugin.rco -x build/generated/file_manager_plugin.h
python tools/ui_viewer/export.py
python -m http.server 8178 --directory tools/ui_viewer

Open http://localhost:8178/. The viewer validates the simulated interface only; real ScePaf behavior, system transitions, native dialogs and sounds must be tested on a PS Vita.

Architecture

src/                  New C/C++ ScePaf application
  core/               Filesystem, file operations and VPK installation
resource/             RCO interface, localization and textures
tools/rcoc.py         Open RCO compiler used by the build
tools/ui_viewer/      Browser-based interface simulator
paf/                  ScePaf-RE headers, wrappers and NIDs
legacy/               FMVita/vita2d implementation retained as reference
modules/              VitaShell kernel/user modules retained for future work

The custom RCO compiler was validated by recompiling NetStream resources and comparing the generated tag and hash ownership data with the original RCO. Its schema was also checked against firmware RCO files. No Sony acdc.exe is required.

Version History

v0.30 Beta - Native Media and File Management Update

Download v0.30 Beta

The v0.30 beta expands the original file browser into a more complete Vita-native file-management and media experience. This release remains a hardware-testing build: back up important data before using destructive operations.

Interface and Navigation

Music and Video

Preview and Editing

Protected Content, VPK and FTP

Themes and Stability

v0.1.0 Alpha - First Public Release

Download v0.1.0 Alpha

The first public alpha established File Manager as a separate native ScePaf application for PlayStation Vita. It introduced the new interface and the initial set of everyday file operations while retaining FMVita and VitaShell components as implementation references.

Foundation

Browser and File Operations

Files, Packages and Network

[!NOTE] v0.1.0 is preserved as a historical alpha. It lacks many stability fixes, protected-folder corrections, media controls and interface improvements introduced by v0.30 Beta.

Current Status and Limitations

Credits

File Manager is possible because of the following developers, libraries, applications and reference repositories:

Project Foundations and Interface Research

Libraries and Toolchain

Validation, Assets and Development Support

All third-party components remain under their respective licenses. File Manager is distributed under the GNU General Public License v3.0.