{"id":15715653,"url":"https://github.com/crazyvito11/vita-hello-world-docker","last_synced_at":"2026-04-02T18:52:49.138Z","repository":{"id":247961522,"uuid":"827348430","full_name":"CrazyVito11/vita-hello-world-docker","owner":"CrazyVito11","description":"A simple Hello World application for the Vita, build with VitaSDK via Docker","archived":false,"fork":false,"pushed_at":"2024-07-14T19:42:13.000Z","size":33,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-29T17:05:52.846Z","etag":null,"topics":["boilerplate","cmake","cpp","docker","docker-compose","hello-world","homebrew","playstation-vita","ps-vita","vita-companion","vitasdk"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CrazyVito11.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-11T13:29:44.000Z","updated_at":"2025-05-10T21:56:41.000Z","dependencies_parsed_at":"2024-07-14T20:54:56.296Z","dependency_job_id":null,"html_url":"https://github.com/CrazyVito11/vita-hello-world-docker","commit_stats":null,"previous_names":["crazyvito11/vita-hello-world-docker"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/CrazyVito11/vita-hello-world-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CrazyVito11%2Fvita-hello-world-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CrazyVito11%2Fvita-hello-world-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CrazyVito11%2Fvita-hello-world-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CrazyVito11%2Fvita-hello-world-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CrazyVito11","download_url":"https://codeload.github.com/CrazyVito11/vita-hello-world-docker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CrazyVito11%2Fvita-hello-world-docker/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262632335,"owners_count":23340214,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["boilerplate","cmake","cpp","docker","docker-compose","hello-world","homebrew","playstation-vita","ps-vita","vita-companion","vitasdk"],"created_at":"2024-10-03T21:42:15.059Z","updated_at":"2025-12-30T22:21:17.544Z","avatar_url":"https://github.com/CrazyVito11.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vita Hello World Docker\nA simple Hello World application for the Vita, build with VitaSDK via Docker.\n\n\n## Why?\nWhile setting up VitaSDK manually isn't that difficult, doing it via Docker should lower the barrier to entry even further.\n\nThis repository contains the Hello World C++ example from VitaSDK as a proof of concept.\n\n\n## Setup\nTo get started with this example, simply follow these steps.\n\n### Copy the example `vita.env` file\nWe first want to create the environment file that we will then use inside the container, this file contains information about your Vita console.\n\nAn `vita.env.example` file has been provided, so you only have to make a copy of it and fill it in.\n\nStore the environment file as `vita.env`, this way it should be picked up by our container later on.\n\n### Fill in the `vita.env` file\nNow that you have an Vita environment file, we can enter information about our Vita console.\n\n\u003e [!TIP]\n\u003e It's recommended that you assign a static IP address to your Vita console.\n\n### Install the Vita Companion plugin\nTo use the `build-and-test-app.sh` script, your Vita also needs to have the [Vita Companion plugin](https://github.com/Ibrahim778/vitacompanion) installed.\n\nSimply follow the steps on their GitHub page.\n\n\u003e [!NOTE]\n\u003e This is a fork of [devnoname120's Vita Companion](https://github.com/devnoname120/vitacompanion) that also allows installing VPK files remotely.\n\n\u003e [!TIP]\n\u003e Don't forget to also enable the \"CMD/FTP Servers\" option in the quick start menu, as otherwise you won't be able to connect to your Vita.\n\n### Start the container\nWe should now be ready to start the container!\n\nYou can start it using `docker compose up -d`, it should automatically build the image if it's the first time.\n\n\u003e [!TIP]\n\u003e If you need to rebuild the image, you can add `--build` at the end of the command.\n\n### Create `Intellisense-src` directory (Recommended)\nWhile this step is optional, it is highly recommended to make the development experience a lot easier.\n\n\u003e [!NOTE]\n\u003e In this example we will be using VS Code, but this likely will also work for other IDE's.\n\nFirst, install the \"C/C++\" extension from Microsoft.\nThis can be installed by pressing CTRL + P, and then running `ext install ms-vscode.cpptools`.\n\n\u003e [!TIP]\n\u003e If you can't find the extension, you might be running an unofficial build of VS Code that doesn't have Microsoft extensions.\n\u003e\n\u003e You can install the extension manually by downloading the [.vsix file straight from Microsoft's website](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools).\n\nOnce you have the extension installed, simply run `./configure-intellisense.sh` in a terminal on your host to copy the relevant files to your host machine.\n\nYour editor should now be able to find the sources and provide you with proper Intellisense.\n\n\n\n## Building + Testing\nFirst, enter the Bash shell of the contain with `docker compose exec builder bash`.\n\nYou should now be inside the `/src` directory, in which is the source code of our application and 2 scripts.\n\nIf you only want to compile the application, simply run `./build-app.sh` to receive the application in vpk form, which you can then copy to the Vita manually.\n\n\u003e [!NOTE]\n\u003e `./build-app.sh` builds the application as a Release candidate, meaning it will have better performance.\n\n\nIf you also want to transfer it to your Vita console over the network with Vita Companion, run `./build-and-test-app.sh` instead.\nThis should automatically transfer, install and run the application.\n\n\u003e [!WARNING]\n\u003e Running the `build-and-test-app.sh` script will close all running applications on the Vita, so keep that in mind.\n\n\u003e [!NOTE]\n\u003e `build-and-test-app.sh` builds the application as a Debug release, meaning it has worse performance but with better debug information.\n\n## Debugging\nIf your application crashes, you can use the `vita-parse-core.sh` script to parse the crash dump and get more information about what went wrong.\n\nFirst, copy the crash dump file from your Vita and store it in the `crashdumps` directory.\n\n\u003e [!TIP]\n\u003e If you have multiple crash dumps at `ux0:data/`, check the Vita error screen, as it should show the filename of the current crash.\n\nOnce you have copied the crash dump file over to your machine, once again enter the builder container.\nInside the container run the following command: `vita-parse-core.sh /crashdumps/\u003cYOUR_CRASH_DUMP_FILE\u003e.psp2dmp build/\u003cYOUR_PROJECT_TECHNICAL_NAME\u003e`\n\nHere is an example: `vita-parse-core.sh /crashdumps/psp2core-1720985303-0x0002492929-eboot.bin.psp2dmp build/hello_cpp_world`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrazyvito11%2Fvita-hello-world-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcrazyvito11%2Fvita-hello-world-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrazyvito11%2Fvita-hello-world-docker/lists"}