Home

Quest Home Editor — Wiki

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 it exactly as the headset would, 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.

Quick start (the happy path)

1. Get a build from Releases (pick the compat zip if your CPU is older than ~2013).
2. Put adb.exe, AdbWinApi.dll, AdbWinUsbApi.dll next to the exe → Installation & Setup. Linux/macOS need just adb.
3. Plug the Quest in over USB and accept the "Allow USB debugging" prompt in the headset.
4. Drag the old home (env.apk / .gltf.ovrscene / .opa) onto the window.
5. Open the Cook tab, leave the defaults, press COOK + SIGN + INSTALL.
6. 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.

Pages

Using it

• 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.

Deep dive (how it works)

• 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_hotswap overlay + 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.

What you need

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.