Browse, download, and launch Vita homebrews!
Clone or download

README.md

Vita HomeBrew Browser GitHub All Releases

Alt text

Prerequisites

Optional:

  • PSP2SHELL: automatically send and reload app after compilation, see Running.
  • debugnet: real-time logging that can be viewed from your computer, see Logging.

Building

To build VHBB, you'll need to have the vitasdk installed and working.

Then run the following commands:

mkdir build
cd build

cmake .. -DDEBUGNET=OFF -DCMAKE_BUILD_TYPE=Release
make -j4

Running

To run VHBB:

  • send the generated .vpk to your vita:
    • start an FTP server on your vita, for example VitaShell.
    • upload the vpk to the vita using a FTP client.
  • install the .vpk on your vita using a vpk installer, for example VitaShell.
  • a new folder will be created under ux0:/app/ named /VHBB00001/.

You can also use PSP2SHELL in order to send and reload the application easily after compilation:

  • put the IP of your PS Vita in a new file psvitaip.txt
  • every time you do modifications and want to test them, you can execute make psp2shell which will automatically compile, send, and reload the application.

Logging

Debug code prints text in order to help the debugging. Currently debugnet and file logging are supported.

Instructions to use debugnet:

  • install debugnet
  • set the local IP of your computer in debugnetip.txt
  • compile VHBB using cmake .. -DDEBUGNET=ON
  • on your computer, listen to the port 18194
    • with netcat: nc -u -l -p 18194
    • with socat: socat udp-recv:18194 stdout
  • install VHBB on your PS Vita and start it. The logging should display in the terminal.

Instructions to enable file logging:

  • close VHBB
  • launch it by pressing the special text (image)

Notes

  • icon0.png, startup.png and bg.png must be using indexed palettes.
  • PNG files created in some image editors will cause the .vpk intallation to crash. You may use PNGO to optimise addition PNG files (included under /tools/), or pngquant.

License

  • Code and scripts inside the folder src\vpk_install are licensed under the terms of GNU GPLv3. Check the file src/vpk_install/license.txt for the complete conditions.
  • The rest of the files (unless specified otherwise) are licensed under the terms of CC by-nc-sa 4.0. Check the file license.txt for the complete conditions.