SideQuest is no longer maintained here, this repo is obsolete and serves as an example only.
SideQuest is designed to simplify sideloading apps onto your standalone android based headset. It should include everything you need to get started. When you first open the app it is best to open the setup screen and follow the instructions on screen to get set up.
The quest doesnt show 2D apps normally anywhere in the UI. Thankfully though SideQuest has a launcher ( install on the setup screen - scroll down to the bottom ) which appears in the unknown sources list and lets you open 2d apps. You can pick "SideQuest - Home" or "SideQuest - TV" to use the 2D app in the Oculus Home or Oculus TV environments.
VR apps dont work when launched from the app launcher currently, only 2d apps. The workaround is to launch the VR apps from the unknown sources list instead - they are usually listed there!
When you first launch SideQuest it will download the repositories and also download the ADB tools. Once this is done you should go to the Setup menu option and follow through the one time setup to get your device ready to install apps.
If you have any problems you can hit the bug icon on the top right and then open the console tab in that section to capture any errors - these will really help to find and fix bugs.
Check your antivirus hasn't blocked some parts of the ADB download - this has happened for some with Avast antivirus in particular.
We now have a really easy and powerful app manager portal to be able to manage your app listings on SideQuest.
Clone the repo.
To install the app dependencies
To start the dev stack run
To build the angular app only
To build the electron app only
yarn build --mac
yarn build --wlm
To build the app & angular app (NOT for Raspberry Pi)
To build the app & angular app on a Raspberry Pi
yarn dist --armv7l
To re-launch electron if you accidentally close it
To reset things
"/S" for silent install and "/D=<path>"
We are pretty relaxed at this point, in that we will accept arbitrary PRs, but all collaborators must agree on a way forward. We live by the Contributor Covenant