Brain Recordings
The Recordings page (/recordings) is your central hub for capturing and cleaning brain signals. Connect an EEG device, record live data, check signal quality in real-time, then denoise your recording with ZUNA — all in one flow.
Connect Device → Record EEG → Check Signal Quality → Stop → Denoise with ZUNA → Compare Before/After → Download
Three Recording Modes
The page offers three modes, selectable via tabs at the top:
🧠 Live Recording
Connect your EEG headset and capture brain activity in real-time.
- Connect — Choose your device (Neurosity Crown or Muse) and click Connect. The Muse uses Web Bluetooth; Neurosity uses OAuth.
- Record — Hit Start Recording. You’ll see a live waveform and a signal quality panel showing per-channel contact quality.
- Review — Stop recording when you have enough data (minimum 6 seconds for ZUNA).
- Denoise — Click “Denoise Recording” to send your data to the ZUNA GPU for artifact removal.
Record at least 6 seconds — ZUNA processes in 5-second epochs and needs one full epoch plus a small buffer.
📁 Upload CSV
Upload a previously recorded EEG file in CSV format. The page auto-detects whether the file came from a Neurosity Crown or Muse based on channel names in the header row.
- Supported formats: CSV with channel columns (e.g.,
CP3,C3,F5,PO3,PO4,F6,C4,CP4 for Crown)
- Values should be in microvolts (µV)
- Optional timestamp column
🧪 Experiments
Run cognitive experiments (Stroop, Oddball, P300, etc.) from the built-in experiment library. An experimental panel lets you simultaneously record EEG during the experiment:
- Choose an experiment from the dropdown
- Expand the “Record EEG during experiment” panel
- Connect your device and start recording
- Run the experiment — brain activity is captured alongside
- Stop and denoise when the experiment completes
The experiment recording feature is marked as Experimental. It records EEG in parallel with the jsPsych experiment but does not yet embed event markers into the EEG timeline.
Live Signal Quality
During active recording, a Signal Quality panel appears showing:
- Bar chart — Standard deviation per channel. Green (1.5–10) = great, Yellow (10–15) = good, Red (>15) = poor contact
- Brain montage — Top-down 2D head map with electrode positions colored by quality
This helps you adjust headset fit before committing to a long recording. Once most channels are green, your data will be high quality.
ZUNA AI Denoising
After recording or uploading, the “Clean with ZUNA AI” step sends your EEG data to the ZUNA foundation model running on an NVIDIA A100 GPU.
What ZUNA Removes
| Artifact | Example |
|---|
| Eye blinks | Frontal voltage spikes from blinking |
| Muscle activity | EMG from jaw clenching, forehead tension |
| Environmental noise | 50/60 Hz line noise, cable movement |
| Drift | Slow baseline wander from electrode impedance changes |
What ZUNA Preserves
Neural oscillations (alpha, beta, theta, delta, gamma), event-related potentials (P300, N170), and other brain-generated signals.
GPU Auto-Wake
The GPU VM auto-sleeps after 30 minutes of inactivity to minimize costs. When you trigger denoising:
- If the GPU is ready — processing starts immediately (~5–15s depending on recording length)
- If the GPU is sleeping — the page automatically wakes it and retries every 15 seconds (up to 6 attempts). You’ll see status updates like “Auto-retrying in 15s… (attempt 2/6)”
- The GPU status indicator at the top of the page shows real-time availability (green = ready, yellow = starting, gray = sleeping)
You can also manually wake the GPU by clicking “Wake GPU” in the status bar.
Before / After Comparison
After denoising completes, the page shows a side-by-side comparison:
| Left Panel | Right Panel |
|---|
| Before — Raw Signal | After — ZUNA Denoised |
| Your original recording with artifacts | Cleaned signal with artifacts removed |
After Denoising
Once denoising is complete, you have several options:
- 📥 Download Denoised CSV — Export the cleaned signal as a CSV file for offline analysis in MATLAB, Python, or other tools
- 📊 View in Analysis — Navigate to the
/analysis page for deeper inspection, power spectral density, and more
- Re-record — Start a new recording and denoise again
Result Summary
The results card shows key metadata:
| Field | Description |
|---|
| Input | Number of channels and duration of your recording |
| Output | Channels and duration after processing |
| Channels | List of EEG channel names in the output |
| Sample Rate | Output sampling frequency (256 Hz) |
Supported Devices
| Device | Channels | Connection |
|---|
| Neurosity Crown | 8 (CP3, C3, F5, PO3, PO4, F6, C4, CP4) | Bluetooth + OAuth |
| Muse 2 / Muse S | 4 (TP9, AF7, AF8, TP10) | Web Bluetooth |
End-to-End Flow
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ EEG Device │────▶│ /recordings │────▶│ Backend API │────▶│ ZUNA GPU │
│ Crown/Muse │ │ Live viewer │ │ Auto-wake │ │ A100 80GB │
└──────────────┘ │ Sig quality │ │ /eeg-models │ │ Denoise │
└──────┬───────┘ └──────────────┘ └──────┬───────┘
│ │
▼ ▼
┌──────────────┐ ┌──────────────┐
│ Before/After│◀─────────────────────────│ Cleaned EEG │
│ Comparison │ │ JSON/CSV │
└──────┬───────┘ └──────────────┘
│
┌──────▼───────┐
│ Download / │
│ Analysis │
└──────────────┘
