https://github.com/sccn/muse_osc
https://github.com/sccn/muse_osc
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/sccn/muse_osc
- Owner: sccn
- Created: 2026-04-17T23:14:51.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-17T23:21:39.000Z (3 months ago)
- Last Synced: 2026-04-18T01:23:48.555Z (3 months ago)
- Language: Python
- Size: 1.95 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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
```bash
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
```
## Usage
```bash
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
```bash
# 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`.