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

2.1 KiB Raw Blame History Unescape Escape