African-Neurodata-Research-Lab-ANR-LAB/ANR-Muse-EEG-Recorder

# ANR Muse EEG Recorder **African NeuroData Research Lab (ANR)** Browser-based Muse EEG acquisition with event markers and **MNE-ready research export**. Website: africanneurodataresearch.org Research enquiries: anrlab.ng@gmail.com ## What the recorder does - Connects directly to Muse through Web Bluetooth. - Displays four live EEG channels: TP9, AF7, AF8, TP10. - Records raw EEG at 256 Hz. - Supports manual and repeated automatic research event markers. - Shows acquisition/contact-status indicators. - Exports an MNE-ready ZIP immediately after recording stops. ## MNE-ready export A completed session downloads as: ```text ANR_ _ _MNE_READY.zip ``` Containing: ```text ├── *_raw_eeg.csv ├── *_events.tsv ├── *_eeg_metadata.json └── README.txt ``` The raw CSV includes deterministic `time_s`: ```text time_s = sample_index / 256 ``` This removes dependence on browser wall-clock timestamps when reconstructing the EEG in MNE. ### Raw CSV fields ```text sample_index time_s timestamp_ms iso_time session_code protocol stop_reason TP9_uV AF7_uV AF8_uV TP10_uV event_marker ``` The EEG values remain raw microvolt values in the browser export. The ANR analysis pipeline converts them to volts when creating an MNE Raw object. ## Events The separate `events.tsv` file contains one event per row: ```text onset duration description source ``` This prevents repeated adjacent CSV marker rows from being interpreted as multiple experimental events. ## Analyze with MNE-Python Use the companion repository: **ANR EEG Analysis Pipeline** African-Neurodata-Research-… Its guided Google Colab notebook imports the ANR export, creates an MNE Raw object, runs technical QC and preprocessing, calculates PSD/band power, and exports a true `.fif` file and HTML report. ## Recording procedure New users should read: **Research Recording Procedure** For the exact MNE-ready file specification: **MNE Export Fo …