Software Setup
Software Setup Options
Choose one of the following methods to install and run the BodyPress application:
Option A: Work Directly in VR (Recommended)
Install the native VR app from the Meta Quest Store to view and analyze your bio-signal data directly inside your headset.
- 📱 App Store: BodyPress on Meta Quest Store (opens in a new tab)
- 🎬 Launch Tutorial: How to Launch In-App (YouTube Short) (opens in a new tab)
- 💡 Usage Example: VR Data Overlay Demo (YouTube) (opens in a new tab)
Example of using:
📱 Play Tennis With PiEEG XR and BodyPress (opens in a new tab)
Option B: Mobile Setup (Android)
Alternatively, test and stream device data on your Android mobile device using the official Google Play application.
- 📱 Google Play: BodyPress on Google Play Store (opens in a new tab)
🚀 VRChat Fast start
1. Running PiEEG XR on Meta Quest
Learn how to deploy and configure PiEEG XR on Meta Quest. This covers hardware setup, software dependencies, and running real-time EEG processing in XR.
- Guide: PiEEG XR Meta Quest Tutorial (opens in a new tab)
- Video: YouTube Demonstration (opens in a new tab)
2. Brain-Reactive VRChat Avatar (OSC Configuration)
Configure Open Sound Control (OSC) to send real-time EEG brainwave metrics into VRChat to control avatar animations, parameters, and visual effects dynamically.
- Manual: Brain-Reactive VRChat Avatar Manual (opens in a new tab)
- Video: YouTube Setup Guide (opens in a new tab)
Device test
This page is a short introduction to getting PiEEG XR running with the software. For full details, follow the linked videos below.
[!NOTE] You don't need a Meta Quest to try PiEEG XR — you can test it directly through the PiEEG Server in your browser.
1. Connect via the Live Demo
- Open pieeg.com (opens in a new tab) and click Try Live Demo.
- Make sure Bluetooth is turned on on your device.
- Connect to the
PiEEG XRdevice over BLE.
Once connected, live data begins streaming.
2. Test the Signal
- Put the mask on your face.
- Watch the incoming data and run a few simple tests — blinking and chewing produce clear, visible signals.
- Experiment with the band-pass filter and other settings.
- Save your data, or test facial mimics through the built-in mini-games.
[!TIP] To test mimics, open Mini-Games and choose Face Trainer.
Learn More
Full software documentation is on the PiEEG Software page.