Quest Tools 1.2.0

Quest Tools 1.2.0: survives updates, stays connected, does more

A big update for Quest 3 / 3S owners: Quest Tools now repairs what firmware updates undo, finds your headset on the network, sideloads games with OBB data, shows the headset on your PC, and adds modes, storage cleanup and battery insights.

🔄 Survives firmware updates

• Remembers your Horizon OS version and disabled packages per headset. When an update switches them back on, Quest Tools asks on the next start and restores the pre-update state with one key (repair update, menu r → 4).
• Protected and must-keep packages are never re-disabled.
• Automatic safety snapshot of all settings before packages are disabled, settings are restored or an update is repaired (the last 10 are kept).

📶 Wi-Fi ADB that stays

• wifi find: scans your network and reconnects to known headsets, even when the IP has changed.
• Automatic reconnect when nothing is attached.
• wifi keep on: whenever the headset is on USB and Wi-Fi ADB is off (e.g. after a reboot), it is switched back on automatically.

🎮 Sideloading with OBB data

• apps install takes APKs, OBB files or a whole game folder. Split APKs are installed together, and OBB files go to /sdcard/Android/obb/<package>/ with progress.

🖥️ Live view on your PC

• mirror (menu 7 → m): the headset picture in a window via scrcpy. One eye is cropped by default, and the display stays on without wearing the headset. Optional recording.
• scrcpy is installed automatically on first use: the latest release from GitHub, SHA-256 verified against the asset digest and SHA256SUMS.txt, kept in Quest Tools' own folder. An existing installation is used if present. install-scrcpy --update updates it.

🎚️ Modes (menu m)

• normal, streaming, battery, private (offline), plus your own saved modes. Switches performance and network settings in one go, and one undo reverts a whole switch.

🧹 Storage cleanup (menu 5 → 6)

• Overview of free space and what uses it, plus the biggest apps with their last-played date.
• Safe cache clearing (pm trim-caches): data and save games are untouched.
• Games not played for N days: back up their save games and uninstall them in one step.

🔋 Battery & temperature (menu 1 → 6)

• Warnings in the status bar for low controllers, a low headset battery and heat.
• Estimated battery health from the charge counter, drain/charge rate with time left, and a sample history.

Getting started

Download quest-tools-1.2.0.zip below, extract it and double-click Quest Tools.cmd (Windows), or run python -m questtools. Requires Python 3.10+ and adb.

⚠️ Disclaimer

Use at your own risk. Quest Tools changes system packages and settings via ADB. It is provided "as is" without warranty, and the author is not liable for any damage or data loss. Not affiliated with Meta Platforms, Inc.

Made by hemiize · MIT License

Quest Tools 1.1.0 - Repair

Quest Tools 1.1.0: Repair

This release adds a Repair area that detects and fixes the classic debloat accidents on the Quest 3 / 3S. Each fix repeats the procedure that actually solved the problem on a real headset.

🩺 New: Repair (menu r or questtools repair)

Symptom	What Repair does
Purchased apps disappear, show up under Unknown sources or say "not purchased"	re-enables the store chain (ocms, store, credentialsmanager, horizon, platform services), refreshes the library and reboots. The full purchase (entitlement) sync only runs at boot
Store apps won't download or install	the same fix. It also detects offline mode and offers to switch it off
Home panels, library and universal menu missing (only passthrough + system bar)	enables com.oculus.ocms and restarts the VR shell (optionally clears the shell's data against crash loops)
Controllers / 6DoF tracking dead	detects the crashed tracking service and reboots. It cannot be restarted from adb

• Repair check (questtools repair) looks at package states, offline mode, running services and known error lines in the system log (not in users library, Entitlement … not found, OVRLibrary: null cursor, Placement request Timeout, tracking-DSP crash), then names the fix.
• Every repair has a dry run, and every package change is journaled and can be undone.

Other changes

• doctor now reports these failure patterns and points to the matching repair.
• Forcing store or credentialsmanager off prints an explicit warning about broken purchases/installs.
• Package explanations for ocms, store and credentialsmanager now describe the exact symptoms.
• doctor shows active performance overrides in plain words (e.g. resolution 1651x1766).
• README: new Troubleshooting section.

Getting started

Download quest-tools-1.1.0.zip below, extract it and double-click Quest Tools.cmd (Windows), or run python -m questtools. Requires Python 3.10+ and adb.

⚠️ Disclaimer

Use at your own risk. Quest Tools changes system packages and settings via ADB. It is provided "as is" without warranty, and the author is not liable for any damage or data loss. Not affiliated with Meta Platforms, Inc.

Made by hemiize · MIT License

Quest Tools 1.0.0

Quest Tools 1.0.0 — first public release

Take back control of your Meta Quest 3 / 3S — debloat, kill telemetry, tune performance and back up save games & settings from a fast terminal UI. Every change is journaled and can be undone.

Highlights

• 🎛️ Menu-driven terminal UI: arrow keys, hotkeys, type-to-filter, checklists. Live status bar with headset/controller battery, temperature, refresh rate and connection.
• ↩️ Undo for everything: package toggles, properties and settings are journaled with their previous value.
• 🧹 Debloat with a curated knowledge base: packages are rated recommended / optional / caution / keep / protected, and critical services (ocms, store, credentialsmanager) are never disabled by accident.
• 🔄 Firmware-update aware: detects when a Horizon OS update re-enables packages and restores your profile in one step.
• 💾 Backups: settings snapshots with diff and selective restore; app backups that include save games (Android/data, obb).
• ⚡ Performance: CPU/GPU levels, foveated rendering, eye-buffer resolution, refresh rate, presets, live monitor.
• 🌐 Network: one-step Wi-Fi ADB, offline mode (DNS blackhole), Private DNS presets (AdGuard, Mullvad, Quad9, …).
• 🧩 Zero dependencies: Python 3.10+ standard library plus adb. Every function is also available as a CLI command with --json.

Getting started

1. Install Python 3.10+ and the Android platform tools (adb).
2. Enable developer mode on your Quest and allow USB debugging.
3. Download quest-tools-1.0.0.zip below and extract it.
4. Windows: double-click Quest Tools.cmd. Other systems: python -m questtools.

Supported headsets

Meta Quest 3 and Quest 3S (tested on Quest 3, Horizon OS v209/v210).

⚠️ Disclaimer

Use at your own risk. Quest Tools changes system packages and settings via ADB. It is provided "as is" without warranty, and the author is not liable for any damage or data loss. Not affiliated with Meta Platforms, Inc. See the README for the full disclaimer.

Made by hemiize · MIT License