Troubleshooting

Troubleshooting

I still see the default foggy / blue home, not my env

The cook didn't get loaded — the shell fell back to its default. Check, in order:

• Did you install the NoRoot-Spoof APK (not Rooted-System) on a non-rooted Quest?
• Is Haven 2025 your headset's selected home environment? The spoof replaces it in place, so your env only appears where Haven 2025 would. You don't switch to a custom env — an unrooted Quest can't; the spoof simply is Haven 2025 now.
• Did the shell relaunch? Kill com.oculus.vrshell (adb shell kill $(adb shell pidof com.oculus.vrshell)) or sleep/wake the headset to force a reload.
• Was the install actually accepted? Re-run with the headset connected and read the Cook status line. A spoof install FAILED means Haven 2025 is a non-removable system app on your device — use the rooted path (Rooted-System APK) instead.

Undo the spoof / get the real Haven 2025 back

hsr_renderer.exe --restore-haven

or click "Restore original Haven 2025" in the Cook tab. This reinstalls the original from the auto-backup (Haven2025_Backup/ beside the exe) and relaunches the shell. No backup? See Restoring Haven 2025 for re-download / factory-reset options.

Black void / nothing renders (often Quest 2)

The env loaded but draws nothing. Quest 2 has a weaker/older GPU and some ported content does not yet render there. Try the same cook on a Quest 3 / Pro to confirm the env itself is good. Faithful rendering of ported content is still a work in progress.

INSTALL_PARSE_FAILED_NO_CERTIFICATES

The APK is unsigned. Keep Auto-sign on, or sign manually:

hsr_renderer.exe --sign <file>.apk
hsr_renderer.exe --fetch-tools     # if signing reports no build-tools (needs curl + network)

On a clean PC with no Android SDK and no Java, the first sign auto-downloads the toolchain beside the exe.

adb not found / install does nothing

Put adb.exe + AdbWinApi.dll + AdbWinUsbApi.dll beside the exe (see Installation & Setup), or set HSR_ADB to your adb.exe. Verify with adb devices, and accept the USB-debugging prompt in the headset.

Wrong device when several are attached

Put the serial from adb devices in the Device field of the Cook tab.

Wi-Fi install drops / can't get root

Over Wi-Fi the root check (adb root) can briefly drop and reconnect the TCP session. If root detection is flaky over Wi-Fi, use a USB cable for the install.

Environment variables (advanced)

Var	Effect
HSR_ADB	Path to adb (overrides the beside-the-exe / PATH search).
HSR_BUILDTOOLS	Android build-tools dir (apksigner + zipalign) if you don't want auto-detect/download.
HSR_KEYSTORE	Signing keystore (else a debug keystore is auto-generated beside the exe).
HSR_COOK_OUT	Override the output APK path.
HSR_NOINSTALL	Headless/CLI cooks: skip the auto-install step.