alexandrebarachant/muse-lsl

Python script to stream EEG data from the muse 2016 headset

What it solves

It provides a way to stream, visualize, and record electroencephalography (EEG) data from Muse headbands (Muse 2, Muse S, and the classic Muse) into a standardized format for research and analysis. It bridges the gap between proprietary hardware and the Lab Streaming Layer (LSL) system, which is the field standard for time-synchronized data collection in brain-computer interface (BCI) research.

How it works

The package acts as a bridge between the Muse device and the computer. It uses various Bluetooth backends (such as bleak) to connect to the headband and then broadcasts the EEG data over the network using the Lab Streaming Layer (LSL) protocol. This allows other software to access the data in near real-time with precise time synchronization.

Who it’s for

Researchers, developers, and hobbyists working with brain-computer interfaces, EEG-based experiments, and neurotechnology who use Muse devices.

Highlights

  • Multi-device support: Compatible with Muse 2, Muse S, and the original 2016 Muse.
  • Flexible usage: Available as both a standalone command-line tool and a Python library for integration into other projects.
  • Comprehensive data capture: Supports EEG data as well as accelerometer, gyroscope, and photoplethysmography (PPG) sensors (on Muse 2).
  • Built-in utilities: Includes tools to view data streams in real-time and record data directly to CSV files.

Related

  • Project
    huangjunsen0406/py-xiaozhi

    py‑xiaozhi is a Python‑based, async‑first framework for building multimodal AI assistants that can listen, speak, see, and control hardware. It offers real‑time Opus voice streaming, offline wake‑word detection, vision‑language integration, a JSON‑RPC tool server, and secure WebSocket/MQTT communication. Runs on Windows/macOS/Linux desktops and on edge boards (Raspberry Pi, Jetson Nano). Provides GUI (PySide6/QML), CLI, and GPIO modes, and a plugin system for easy extension.

  • Project
    mne-tools/mne-python

    An open-source Python package for exploring, visualizing, and analyzing human neurophysiological data like MEG and EEG.

  • Project
    KoljaB/RealtimeTTS

    A Python library for low-latency text-to-speech that converts strings and LLM token streams into audio using a wide variety of local and cloud engines.

  • Project
    sipeed/MaixPy

    A Python SDK and ecosystem for creating AI projects on edge devices, providing simple APIs for AI vision, audio, and LLMs on MaixCAM hardware.

  • Project
    elevenlabs/elevenlabs-python

    The official Python SDK for ElevenLabs, enabling developers to integrate lifelike AI text-to-speech, voice cloning, and real-time conversational AI agents into their applications.