You mounted the PiEEG XR mask, powered it from a USB-C bank, and it's advertising over Bluetooth as PiEEG XR. This guide takes you from "it's on my head" to "it's driving an experience inside the headset" — starting with the zero-install path almost every VR user already knows.
Everything below assumes the device is already mounted and powered. If not, see the PiEEG XR connection guide — swap the mask (four buckles), mount the box under the head strap, plug in a 5 V USB-C bank.
Testing PiEEG XR: High-Quality Brainwave & Eye Blink Signal Test
Before mirroring anything into the headset, see what clean PiEEG XR signals look like — a quick live quality check with clear eye-blink and brainwave activity.
Method 1 — Cloud on Your PC, Mirrored Into the Headset (Start Here)
Best for: everyone. Zero install, zero friction — no APKs, no sideloading, no command line. Your PC opens a web page, and you already know how to bring a PC screen into your headset.
This is the recommended path. Your desktop browser natively supports Web Bluetooth, so it pairs PiEEG XR with no extra software; then you mirror that desktop into the Quest with the same screen-streaming tool you'd use for any PC VR.
Step 1 — Connect PiEEG XR in the browser (no install)
- On your PC, open cloud.pieeg.com in Chrome or Edge.
- Turn on Bluetooth. Click Connect, choose PiEEG XR (or PiEEG XR-16), pick
PiEEG XRin the pairing dialog, and grant permission. - Signals stream live. That's the whole setup — nothing was installed.
Step 2 — Mirror your desktop into the Quest
Bring that browser window into the headset with whatever you already use:
| Tool | Type | Notes |
|---|---|---|
| Meta Horizon Link / Air Link | Official (Meta) | Wired (USB-C 3.2) or wireless over 5 GHz Wi-Fi. Brings your PC desktop into the headset. Needs the Meta Horizon Link app on Windows. |
| Virtual Desktop | Third-party (paid) | Popular low-latency wireless desktop streaming. |
| Immersed | Third-party | Multi-monitor virtual desktops. |
| Steam Link | Third-party (free) | Streams your PC over Wi-Fi. |
Enable Meta Horizon Link on the headset: Meta button → Quick controls → Link (wired) or toggle Use Air Link (wireless), pick your PC, Launch.
Step 3 — Launch an experience
Your Windows desktop appears as a virtual screen in VR. Open the Cloud gallery on it and pick an experience (see starter experiences below) — you're now reading brain and facial signals inside the headset, and you installed nothing.
Method 2 — PiEEG Server on Your PC, Dashboard in the Quest Browser
Best for: no screen-mirroring; the PC holds the BLE link, the Quest's stock browser just loads a page.
Your PC pairs PiEEG XR, and the Quest's built-in browser only loads a web page over your local network — no sideloading needed.
- Install the server on your Windows PC (Python 3.10+):
pip install pieeg-server - Start it, connecting to PiEEG XR over BLE:
The WebSocket runs onpieeg-server:1616, the dashboard on:1617. - Find your PC's local IP —
ipconfig(look for the IPv4 address, e.g.192.168.1.50). PC and Quest must be on the same Wi-Fi. - In the Quest's built-in browser, open:
http://192.168.1.50:1617 - The full dashboard loads — live waveforms, FFT, signal quality, and server-fed experiences — all rendered in the headset while your PC does the Bluetooth.
Experiences launched from the server dashboard read data over the local WebSocket, so they run fine in the stock Quest browser.
Method 3 — Drive a VRChat Avatar (Cloud + Local Bridge over OSC)
Best for: your brain state animating an avatar in a real social-VR app on the Quest.
- On your PC, open cloud.pieeg.com in Chrome/Edge and connect PiEEG XR over Web Bluetooth (or use
pieeg-server). - Download and run the PiEEG Local Bridge (5 MB) — it forwards Cloud band powers to local apps via OSC.
- In Cloud, launch the VRChat OSC Bridge experience (or VRChat OSC · Brain Regions for per-region parameters).
- Run VRChat on your Quest on the same network. Your live EEG band powers stream into avatar parameters and the chatbox — focus, calm, and expressions show up on your avatar in real time.
Method 4 — BodyPress App (Native, No Browser)
Best for: a native, no-PC reader — because the Quest's Android BLE stack pairs directly.
BodyPress talks Bluetooth Low Energy and pairs straight with PiEEG XR. Its Live Signal screen offers waveform, FFT spectral, neural-state, and signal-quality views.
- Enable Developer Mode (Meta Horizon app → Menu → Devices → your headset → Developer Mode → On; reboot).
- Sideload the APK — download the release build and install via SideQuest or ADB. Full guide: Run BodyPress on Meta Quest.
- Launch BodyPress, open Live Signal, and pair
PiEEG XR. Read live biosignals in the headset — no PC, no browser.
Also on Google Play for phones and tablets.
Multitasking tip
Quest lets you pin a browser or app window in space and use it alongside others. Pin the PiEEG dashboard (the local-IP server page from Method 2) — or BodyPress — as a floating window so your live signal sits beside whatever else you're running.
Three Experiences to Try First
All live in the Cloud gallery at cloud.pieeg.com and in the open-source experiences directory.
| Experience | What it does | Why start here |
|---|---|---|
| Avatar Neurofeedback Studio v2 | Drive a VRM avatar's face directly from your EEG. Drag any electrode × band → any expression; a REST vs ACTIVE contrastive trainer ranks features by Cohen's d and auto-picks your strongest cue. | The clearest "my brain moves this" feedback loop — and it's placement-adaptive. |
| Neural Flight | Soar first-person over an endless procedural world — focus is your lift. Hold focus to climb and glide; lose it and gravity takes over. Starts in autopilot demo, switch to Live. Enter in VR or AR. | Pure fun, instant intuition for focus control. Runs immersive in the headset. |
| Face Trainer v2 | Placement-agnostic facial-EMG trainer. A 3-2-1 recording rhythm captures 3× more labelled samples per rep; a per-expression L2 + group-lasso detector shows which electrodes carry each expression. Only 3 reps needed. | Fast, honest calibration — and the channel-importance bars teach you good electrode contact. |
Recommended order
- Face Trainer v2 — quick calibration confirms your mask has clean contact and teaches the pipeline.
- Neural Flight — immediate, joyful focus control.
- Avatar Neurofeedback Studio v2 — deeper mapping once you trust your signal.
Which Method Should You Pick?
| Your situation | Method |
|---|---|
| Just want it working, nothing to install | 1 (Cloud on PC + mirror into Quest) |
| Don't want to mirror your screen | 2 (Server + local IP) |
| Want your avatar to react in VRChat | 3 (Local Bridge → OSC) |
| Want a native app, no browser at all | 4 (BodyPress) |
Troubleshooting
PiEEG XRnot in the pairing dialog — confirm the USB-C bank is powering it and it's within ~5 m. Unplug/replug the bank to restart BLE advertising.- Red signal quality — the mask electrodes need firm skin contact. Reseat the mask; blinking and chewing should produce large, obvious deflections when contact is good.
- Quest can't reach
http://<pc-ip>:1617(Method 2) — both devices must be on the same Wi-Fi; check the PC firewall isn't blocking ports 1616/1617. - Laggy or blurry mirror (Method 1) — use a 5 GHz Wi-Fi network (or a USB-C 3.2 cable for wired Link) and keep the PC and router close.
What's Next
- Experiences gallery — the full library at cloud.pieeg.com: P300 Mini-Game, Neural Sonification, Northern Lights, and more.
- Docs — PiEEG XR setup and the full software reference.
- Open source — everything is on GitHub.