A Python package for streaming, visualizing, and recording EEG data from the Muse 2016 headband.
- Windows: On Windows 10, we recommend installing BlueMuse and using its GUI to find and start streaming from Muses. Alternatively, if you have a BLED112 dongle you can try Muse LSL's bgapi backend (i.e.
$ muselsl stream -b bgapi).
- Mac: BLED112 dongle required. Use the bgapi backend (default option on Mac)
- Linux: No dongle or separate install required. Use the pygatt backend (default option on Linux) and make sure to read the Common Issues
Compatible with Python 2.7 and Python 3.x
Only compatible with the 2016 model of the Muse headband
Install Muse LSL with pip
pip install muselsl
Setting Up a Stream
On Windows 10, we recommend using the BlueMuse GUI to set up an LSL stream. On Mac and Linux, the easiest way to get Muse data is to use Muse LSL directly from the command line. Use the
-h flag to get a comprehensive list of all commands and options.
To print a list of available muses:
$ muselsl list
To begin an LSL stream from the first available Muse:
$ muselsl stream
In order to connect to a specific Muse, pass the name of the device as an argument. The name of the Muse can be found on the inside of the left earpiece (e.g. Muse-41D2)
$ muselsl stream --name YOUR_DEVICE_NAME
You can also directly pass the MAC address of your Muse (this is the fastest and most reliable way):
$ muselsl stream --address YOUR_DEVICE_ADDRESS
Working with Streaming Data
Once a stream is up and running, you now have access to the following commands in another prompt:
To view data:
$ muselsl view
$ muselsl view --version 2
To record EEG data into a CSV:
$ muselsl record --duration 60
Note: this command will also save data from any LSL stream containing 'Markers' data, such as from the stimulus presentation scripts in EEG Notebooks
Alternatively, you can record data directly without using LSL through the following command:
$ muselsl record_direct --duration 60
Note: direct recording does not allow 'Markers' data to be recorded
Muse LSL was designed so that the Muse could be used to run a number of classic EEG experiments, including the P300 event-related potential and the SSVEP and SSAEP evoked potentials.
Integration into other projects
If you want to integrate Muse LSL into your own Python project, you can import and use its functions as you would any Python package. Examples are available in the
from muselsl import stream muses = stream.list_muses() stream.stream(muses['address']) # Note: Streaming is synchronous, so code here will not execute until after the stream has been closed print('Stream has ended')
What is LSL?
Lab Streaming Layer or LSL is a system designed to unify the collection of time series data for research experiments. It has become standard in the field of EEG-based brain-computer interfaces for its ability to make seperate streams of data available on a network with time synchronization and near real-time access. For more information, check out this lecture from Modern Brain-Computer Interface Design or the LSL repository
Mac and Windows
- Connection issues with BLED112 dongle:
- You may need to use the
--interfaceargument to provide the appropriate COM port value for the BLED112 device. The default value is COM9. To setup or view the device's COM port go to your OS's system settings
pygatt.exceptions.BLEError: Unexpected error when scanning: Set scan parameters failed: Operation not permitted(Linux)
- This is an issue with pygatt requiring root privileges to run a scan. Make sure you have
libcapinstalled and run
sudo setcap 'cap_net_raw,cap_net_admin+eip' `which hcitool`
pygatt.exceptions.BLEError: No characteristic found matching 273e0003-4c4d-454d-96be-f03bac821358(Linux)
- There is a problem with the most recent version of pygatt. Work around this by downgrading to 3.1.1:
pip install pygatt==3.1.1
pygatt.exceptions.BLEError: No BLE adapter found(Linux)
- Make sure your computer's Bluetooth is turned on.
pygatt.exceptions.BLEError: Unexpected error when scanning: Set scan parameters failed: Connection timed out(Linux)
- This seems to be due to a OS-level Bluetooth crash. Try turning your computer's bluetooth off and on again