Records Muse sensor streams (EEG, PPG, accelerometer, gyroscope, etc.) to timestamped CSV files via OSC. Vibe coded by Aravind Ravi with Claude code.
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txtpython osc_recorder_pythonosc.py [port] [prefix] [output_dir] [--debug]| Argument | Default | Description |
|---|---|---|
port |
7777 | UDP port to listen on |
prefix |
(none) | OSC address prefix (e.g. /muse) |
output_dir |
. |
Directory for session folders |
--debug |
off | Print stream info and sample counts |
# Listen on default port 7777
python osc_recorder_pythonosc.py
# Custom port with debug output
python osc_recorder_pythonosc.py 7888 --debug
# Full options
python osc_recorder_pythonosc.py 7888 /muse ./data --debug- Start the script.
- Configure your Muse streaming app (e.g. Mind Monitor) to send OSC to your machine's IP and chosen port.
- Press
Ctrl+Cto stop. CSV files are saved in a timestamped session folder.
Each detected stream produces a separate CSV file (eeg.csv, acc.csv, etc.) with a timestamp column followed by channel columns.
Supported streams: eeg, ppg, optics, acc, gyro, drlref, thermistor.