Repository navigation
Install & Setup Guide
Lumince edited this page Oct 8, 2026
·
7 revisions
- Quest 2/3/3s/Pro headset running firmware 2.1 - Pre Sep 24th build of 2.7
- ADB Enabled (Optional)
- Metas domains blocked (See step 1 here) or internet access blocked via your router
- In the Windows Terminal app run:
winget install -e --id Google.PlatformTools - Close and re-open your terminal window you should now have adb.
- In the terminal run:
sudo apt install android-tools-adb - Close and re-open your terminal window you should now have adb.
- Follow https://brew.sh/ to install brew.
- In a terminal run:
brew install android-platform-tools
Note: This is riskier because we are granting the quest internet access before updates have been blocked
- In the quest web browser download the latest APK from releases
- IMMEDIATELY disconnect from wifi and forget the network.
- In the Quest file explorer find the downloaded apk, hit the three dots > Open With > Package Installer
- Follow the prompts to allow from unknown sources.
- Download the latest release here
- Connect your Quest to your computer with ADB enabled.
- Install Singularity with the following command
adb install -g Singularity.apk
- Open Singularity (Do NOT enable
Root on Bootfor your first root) - Setup Wireless ADB (Follow the guide that pops up)
- Before rooting, I recommend turning on the internet kill switch (along with
enable on bootfor it) in AIO Tweaks - Press Root Now (If it stops and Root Now is no longer greyed out, press it again)
- Once you gain root, it will soft reboot. Don't try to root again.
- Check If an app called Singularity-Magisk is in Unknown Sources
- If it is, open it and it should grant Singularity root (Close and Open Singularity again for this to update)
- Start adb as root with
adb root
(If you don't have adb root active, boot to your bootloader and run the following commands)
fastboot oem set-appended-cmdline androidboot.adb.rootable=1
fastboot oem set-enable-adb-on-retail 1 - Open Singularity and it will go to a setup screen.
- In your root shell, run this command
adb shell sh /storage/emulated/0/Android/data/com.lumi.singularity/files/start_root_helper.sh - Press
Checkto give the app root access - Press
Patch boot.imgand wait (it will auto flash and reboot) - Open Singularity-Magisk and grant Singularity root access <3
I take no responsibility with what you do with your headset. Anything you do with root is not my concern or my own actions. Don't flash directly to partitions or mess with things you don't understand period. If you have to ask yourself "what is root?", you should probably do your own research before rooting your headset.
This is meant too help people use their headsets how they please without Meta breathing down their neck watching them constantly and restricting what they can and can't do with their hardware.