Skip to content

Repository files navigation

Lighthouse Manager for Meta Quest Pro

Control your SteamVR Base Stations (v1.0 and v2.0) directly from your Meta Quest built-in Bluetooth — no USB dongle needed on your PC.


Features

  • Power ON / OFF all base stations from a persistent notification (no need to open the app)
  • Persistent BLE connection — pre-connects at boot while bases are in standby, so commands are near-instant
  • Auto-start on boot — service starts automatically when the headset turns on
  • Supports Base Station 1.0 (HTC Vive) and 2.0 (Valve Index)
  • Manual MAC address entry for bases that don't appear in scan
  • Zero cloud, zero account, zero tracking

Requirements

  • Meta Quest (built-in Bluetooth)
  • SteamVR Base Station 1.0 or 2.0
  • Developer Mode enabled on the headset
  • ADB (Android Debug Bridge) for installation

Installation

1. Enable Developer Mode

On your phone, open the Meta app → Headset settings → Developer Mode → ON.

2. Install the APK

Download the latest lighthouse-manager.apk from Releases.

Connect the Quest via USB, accept the USB debugging prompt inside the headset, then run:

adb install lighthouse-manager.apk

macOS/Linux:

~/Library/Android/sdk/platform-tools/adb install lighthouse-manager.apk

Or use the included setup script:

# macOS/Linux
chmod +x setup_mac.sh && ./setup_mac.sh

# Windows
setup_windows.bat

The setup script installs the APK and grants all required permissions automatically.


First Use

  1. Open Lighthouse Manager from Library → Unknown Sources
  2. Tap Escanear (Scan) — the app will find your base stations over BLE
  3. Base stations are saved automatically; no need to scan again
  4. Use All ON / All OFF from the persistent notification to control them

BS 1.0 tip: If scan doesn't find your base, tap + MAC and enter the MAC address printed on the base station label (format: AA:BB:CC:DD:EE:FF).


How it works

BLE Protocol

Base Station 1.0 Base Station 2.0
Service UUID 0000cb00-0000-1000-8000-00805f9b34fb 00001523-1212-efde-1523-785feabcd124
Char UUID 0000cb01-0000-1000-8000-00805f9b34fb 00001525-1212-efde-1523-785feabcd124
Power ON 12 00 00 28 FF FF FF FF 00… (20 bytes) 0x01
Power OFF 12 01 00 28 FF FF FF FF 00… (20 bytes) 0x00

BS 1.0 uses command 0x00 (run indefinitely, no ping needed) with broadcast ID 0xFFFFFFFF, so no label ID is required.

License

MIT

About

Control HTC Vive and Valve Index Lighthouse Base Stations directly from Meta Quest using Bluetooth LE.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages