VRChat OSC

Stream EEG band powers to VRChat via UDP OSC. Enable with --osc or from the dashboard.

pieeg-server --osc                                          # defaults
pieeg-server --osc --osc-mode chatbox --osc-interval 0.5    # chatbox only, 2 Hz

Modes

Configuration

Channel Regions

By default, OSC sends band powers averaged across all channels. Use --osc-regions-setup to define custom channel groups (e.g., EEG vs EOG, frontal vs parietal):

pieeg-server --osc-regions-setup

This creates ~/.pieeg/lsl_groups.json with your region definitions. Both OSC and LSL integrations use this file for region-specific streaming.

WebSocket Control

{"cmd": "osc_start"}
{"cmd": "osc_stop"}
{"cmd": "osc_status"}
{"cmd": "osc_config", "config": {
  "host": "127.0.0.1",
  "port": 9000,
  "mode": "both",
  "interval": 0.25,
  "channel": "avg"
}}

The osc_config command allows hot-reloading configuration while the bridge is running.

Avatar Parameters

When in parameters or both mode, band powers are sent as normalized floats (0–1) with rolling normalization: