-
Notifications
You must be signed in to change notification settings - Fork 2
Home
Turn an old (V79-era) Meta Quest Home into an APK you can install on a current Quest 2 / 3 / Pro. One binary loads the old home, renders a close preview of how the headset shows it (the Quest is the real renderer — verify cooks on-device), lets you edit it like a tiny Blender, then cooks it into a modern HSL environment APK, signs it, and installs it for you — root-aware, with automatic Haven 2025 backup.
✅ The pipeline is solid. Whole official V79 homes port today: geometry, textures (lossless ASTC pass-through, sRGB-correct), baked lightmaps, materials (authored blend/cutout/additive), full-length animations (node motion, UV scrolls, spritesheet flipbooks, material tint cycles, skeletal skinned meshes, VAT) and background audio. Still a research project — some PBR variants and effects are being polished env by env.
- Get a build from Releases
(the
.exe, or the.zipwhich also bundles the UI font). Runs on any 64-bit CPU. - Put
adb.exe,AdbWinApi.dll,AdbWinUsbApi.dllnext to the exe → Installation & Setup. Linux/macOS need justadb. - Plug the Quest in over USB and accept the "Allow USB debugging" prompt in the headset.
- Drag the old home (
env.apk/.gltf.ovrscene/.opa) onto the window. - Open the Cook tab, leave the defaults, press
COOK + SIGN + INSTALL. - Put the headset on — your env loads in place of Haven 2025 (the original is backed up automatically; one click restores it). Rooted headsets get the env under its own package instead.
- Installation & Setup — adb, Developer Mode, signing toolchain, all 3 OSes.
- Cooking a Home — the Cook tab, every option explained.
- Editor Guide — gizmos, scene components (chairs / navmesh / wall placements / spawns), material & texture tools, knife, prefabs, Blender round-trip.
- The Two APKs — spoofed (no-root) vs own-package (rooted), and why the spoof exists.
- Restoring Haven 2025 — the automatic backup and how to put the stock home back.
- Troubleshooting — foggy default home, instant crash on old CPUs, signing/adb errors.
- Architecture — one binary = editor + renderer + cooker; the bridges; the golden rules.
- Animation System — the four V79 animation systems and how each ports 1:1.
- File Formats — OPA (skin/anim/skel/sanim) ↔ V205 HSL (RENDMESH/MATL/HSTF/HZAN/RENDTXTR).
-
Device Patching — the Magisk
vrshell_hotswapoverlay + reboot persistence + HSL bridge. - Developer Guide — building on Windows/Linux/macOS, env flags, the cook-preview oracle.
- Roadmap / Board — what's done / in progress / backlog.
- How to Contribute — pick a lane (translations, docs, editor features, RE), build once, ship a PR.
- Reverse Engineering & Contributing — the full IDA / Ghidra guide + the verified libshell env-load gate map.
- 💬 Discord — fastest place for help, questions, screenshots, and sharing ports.
- 🗣️ GitHub Discussions — Q&A, show-and-tell, ideas.
- 🐛 Issues — only a cook/device/libshell bug (attach the home file + a marked-up screenshot + the Logcat Export) or an editor QOL idea; everything else → Discord / Discussions.
| Need | Why |
|---|---|
| A build of the editor (Releases) | The editor + cooker (one binary). |
| A GPU with Vulkan | The renderer replicates the Quest's Vulkan pipeline (macOS: MoltenVK, bundled in the .dmg). |
adb beside the exe |
Installs the cooked APK to the headset. |
| A Quest in Developer Mode | To allow USB/Wi-Fi installs. |
| An old home file |
.apk / .gltf.ovrscene / .opa to port. |