Vitacompanion Plugin

vitacompanion
General
Author	devnoname120
Type	Plugins
Version	1.02
License	MIT License
Last Updated	2026/07/09
Links
Download
Website
Source

vitacompanion by devnoname120 is a user module which makes developing homebrews for the PS Vita device easier. It does two things:

• Open a FTP server on port 1337.
• Listen to commands on port 1338.

Installation

Run VitaShell on your PS Vita, press Select to activate the FTP server and copy vitacompanion.suprx to ur0:tai/.

Finally, add the following line to ur0:tai/config.txt

*main
ur0:tai/vitacompanion.suprx

User guide

FTP server

You can upload stuff to your vita by running:

curl -T somefile.zip ftp://IP_TO_VITA:1337/ux0:/somedir/somefile.zip

Or you can use your regular FTP client. The server accepts both Vita-style paths such as ux0:/somedir/ and FTP absolute paths such as /ux0:/somedir/. It also supports EPSV, PASV, LIST, NLST, and MDTM for compatibility with generic FTP clients.

If you want curl to send the full FTP path directly instead of changing directories first, use the double-slash URL form:

curl --ftp-method nocwd ftp://IP_TO_VITA:1337//ux0:/somedir/

Command server

Send a command by opening a TCP connection to the port 1338 of your Vita.

For example, you can reboot your vita by running:

echo reboot | nc IP_TO_PSVITA 1338

Note that you need to append a newline character to the command that you send. echo already adds one, which is why it works here.

Available commands

Command	Arguments	Explanation
help	none	display the help screen
destroy	none	kill all running applications
launch	<TITLEID>	launch an application by id e.g. launch VHBB00001 to launch the Vita Homebrew Browser
kill	<TITLEID>	kill an application by id
nosleep	on, off or status	enable or disable automatic suspend prevention. This is enabled by default at boot
reboot	none	reboot the console
screen	on or off	turn screen on or off

Note: Commands are defined in src/cmd_definitions.c, you can add new commands there.

Integration in IDE's

VSCode - https://github.com/imcquee/vitacompanion-VSCODE

Changelog

1.02

• Fixed a regression where no-argument FTP commands such as LIST were parsed as their own path argument.
• Restored plain LIST support for clients such as lftp and FileZilla after changing into a directory.
• Bumped module metadata to version 1.02.

1.01

• Added help output, application kill-by-title-id support, and command-controlled no-sleep mode.
• Hardened command server input handling.
• Fixed startup behavior when Wi-Fi is already connected.
• Expanded FTP compatibility with uma0/imc0 drive support, vendored libftpvita path handling fixes, EPSV, NLST, and MDTM.

Credits

Thanks to xerpi for his vita-ftploader plugin, I stole a lot of his code (with his permission).

Thanks to cpasjuste for PSP2SHELL Vita, it inspired me to create this tool.

External links

• GitHub - https://github.com/devnoname120/vitacompanion
• VitaDB - https://www.rinnegatamante.eu/vitadb/#/info/488