Quest App Launcher

An app launcher for Hoover High School's Meta Quest 2 headsets, built in Unity. Displays all installed apps in a configurable grid with tabs, supports custom icons, app name overrides, and automatic asset updates from GitHub.

Requirements

• Meta Quest 2
• Unity (see project settings for version)
• Meta XR SDK (included via Package Manager)
• Git LFS (run git lfs pull after cloning)

Building

Builds are handled by GitHub Actions — there is no local build command.

• build.yml — runs tests (on master), builds the Android APK, uploads to GitHub Releases as HooverHighQuestAppLauncher.apk
• activation.yml — manual trigger to request a Unity license activation file

Source Structure

Path	Description
Assets/Scenes/QuestAppLauncher.unity	Main scene
Assets/Plugins/Android/AppInfo.java	Android plugin: enumerates installed apps, extracts icons, reads usage stats via JNI
Assets/Scripts/	C# scripts: grid layout, app processing, settings, downloads
Assets/OVRInputSelection/	Controller ray input and pointer visualization
.github/workflows/	CI build and license activation workflows

Configuration

User settings are stored in config.json in the app's persistent data path on-device (not in the repo). Key settings:

• Grid size — rows × columns
• Sort mode — alphabetical or most recently used
• Auto category — places Quest / 2D apps into tabs automatically
• Custom category — user-defined tabs via appnames.json
• Background — skybox selection
• Auto update — downloads icon packs and app name files from configured GitHub repos

See docs.md for full configuration and customization details.

Credits

• tverona1 — original creator
• fecheva — app names & icon packs
• noxx — original app icon