Vita HomeBrew Browser
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 only debugnet is supported. We will probably add file logging in the future.
Instructions to use debugnet:
- install debugnet
- set the local IP of your computer in
debugnetip.txt
- compile VHBB using
make debugnet=1
- on your computer, listen to the port 18194
- install VHBB on your PS Vita and start it. The logging should display in the terminal.
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 filesrc/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.