Skip to content

README.md

Latest commit

 

History

History
50 lines (35 loc) · 1.42 KB

README.md

File metadata and controls

50 lines (35 loc) · 1.42 KB
Raw

Muse OSC Recorder

Records Muse sensor streams (EEG, PPG, accelerometer, gyroscope, etc.) to timestamped CSV files via OSC. Vibe coded by Aravind Ravi with Claude code.

Setup

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Usage

python 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

Examples

# 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

Recording

  1. Start the script.
  2. Configure your Muse streaming app (e.g. Mind Monitor) to send OSC to your machine's IP and chosen port.
  3. Press Ctrl+C to stop. CSV files are saved in a timestamped session folder.

Output

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.