UtahsQuest2Upgrade (Retina-Sync Override)

Selling as a Windows .exe for about $10–$15 once a storefront is ready — unless Meta wants to ship an official Performance mode first. Coming soon.

Retina-Sync Override is an open-source Meta Quest performance tool. It uses ADB to raise CPU/GPU tiers, eye-buffer resolution, refresh rate, and foveation controls — then verifies what stuck using Oculus Lenses telemetry and a Thermal Shield that can ease off when the headset gets hot.

Primary target: Meta Quest 2. The same property model often applies to later Quest devices; results vary by OS build.

---

Why this exists

Standalone VR (Quest, Pico, and peers) must protect battery and facial thermals, so stock software leaves silicon headroom unused. Tethered PCVR solves clarity with desktop GPUs; PSVR2 with a fixed console SKU; Vision Pro with a closed spatial stack. Quest’s advantage is wireless + developer-accessible system properties. Retina-Sync turns that advantage into a one-click (or CLI) enthusiast control panel.

Deep comparison: docs/VRLandscape.md

---

Features (v2.1)

• One-click deploy — push a high-performance property matrix over USB
• Omniscient Overlay — Macro / Micro / Chrono / Meta panels in one view
• Oculus Lenses — focused Micro, Macro, Chrono, and Meta workspaces
• Thermal Shield — PERFORMANCE_MAX ↔ THERMAL_BYPASS with optional auto hot-swap
• GPU focus — GPU level up to 5, GPU clock probe, Dynamic FFR, width/height eye buffers
• Gaming presets — Competitive, Cinematic, VR Clarity, Max GPU, Battery 72Hz, and more
• Chrono history — rewind / re-apply profiles; durable log on the PC
• Batched ADB — fewer USB round-trips for apply + silicon probes
• CLI — quest_cli.py for headless status, deploy, preset, shield, benchmark
• Tests — pytest unit coverage without a headset

---

Quick start

Prerequisites

1. Developer Mode enabled on the Quest (Meta Quest mobile app)
2. ADB on your system PATH
3. Python 3.8+ (or a prebuilt exe when released)

Install from source

git clone https://github.com/utahisnotastate/UtahsQuest2Upgrade.git
cd UtahsQuest2Upgrade
pip install -r requirements.txt

Run

python main.py

CLI examples:

python quest_cli.py status
python quest_cli.py deploy
python quest_cli.py preset "Max GPU"
python quest_cli.py shield --auto on
python quest_cli.py benchmark

Build a Windows exe: python build_exe.py → dist/RetinaSyncOverride.exe

Tests: pytest -q

---

Documentation

Full index: docs/README.md

Doc	Audience
Non-Technical Guide	Everyday users
Children's Guide	Kids + parents
Technical Overview	Engineers
Developer Guide	Contributors
VR Landscape	Quest vs other VR systems
Mark Zuckerberg	Open letter
Head of AI, Meta	Open letter
CEO Microsoft	Open letter
CEO Xbox	Open letter
Industry Analysts	Market / tech framing

---

Disclaimer

This software changes device system properties. It can increase heat and battery drain. Changes are typically cleared by a full headset reboot. Not affiliated with Meta, Microsoft, Sony, Apple, Valve, or ByteDance. Use at your own risk.