Skip to content

Latest commit

 

History

History
83 lines (57 loc) · 3.27 KB

README.md

File metadata and controls

83 lines (57 loc) · 3.27 KB

VitaCompanion

Vitacompanion 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

This fork contains some UX and other internal improvements

Build

Use VDSuite

Install

The main plugin vitacompanion.suprx requires QuickMenuReborn, to install it see instructions here

The kernel plugin is to be installed normally run VitaShell on your PS Vita, press SELECT to activate the FTP server and copy VCKernel.skprx to ur0:/tai. Finally, add the following line to ur0:/tai/config.txt under the *KERNEL section:

ur0:tai/VCKernel.skprx

Usage

FTP server

You can upload stuff to your vita by running:

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

Or you can use your regular FTP client.

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

Use the help command for usage information, you can also see include/command_definitions.h
See src/command_definitions.cpp for sauce or to add your own commands

Command Arguments Explanation
destroy none kill all running applications
launch <TITLEID> launch an application by titleid (for system apps on vs0: it open livearea)
reboot none reboot the console
screen on or off turn screen on or off
skprx <load,unload,find> <path,id,name> Load a kernel plugin from path, unload from id, or find ID by name using VCKernel
suprx <load,unload> <path,id> Load a shell plugin from path or unload by id
tai <load,unload> <path,id> Load a kernel plugin from path or unload from id using taihen
usb <mount,unmount> <device> Mount or unmount the vita's storage for usb transfer
self <path> Load a SELF file and run it
prom <path> Promote and install an application from folder
vpk <path> Extract and install an application from a VPK file
exists <path> Check if a file or folder exists

Kernel Plugin

This fork of vitacompanion also provides an accompanying kernel plugin (titled VCKernel) which is required for the following commands to function

  • usb
  • self
  • skprx (tai command will work without it)

Integration in IDE's

VSCode

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

Note: Integration for commands specific to this fork is not present.

Acknowledgements

Thanks to @devnoname120 and all the others behind the original vitacompanion.
Thanks to @GrapheneCt for ScePaf & SceCommonGuiDialog reversing.
Thanks to @theOfficialFlow and @Teakhanirons for VitaShell and EmergencyMount which make the base for my USB code