research toolsTools | MuseIO

Muse-io is only available on Mac and Linux and only supports Muse 2014 headbands. For new projects, we recommend using Muse 2016 with Muse Direct on Windows 10.


MuseIO connects to and streams data from Muse. It is the first program you need to run when using the Research Tools. The idea is simple: pair Muse with your computer, run MuseIO, and voila, it will send a stream of OSC messages containing Muse data that other programs can receive.

So, for example, you could send all that data to MuseLab, our tool for graphing and recording Muse data. Or, you could send the data to a program of your own making – OSC is supported by almost all major programming languages . Or, you could use a tool like OSCulator to map the OSC messages to MIDI notes to control a program like Ableton Live. Anything that can receive OSC can receive and use Muse data from MuseIO.

The example on the right shows MuseIO running in its default configuration on a Mac.

Tell MuseIO the name of the Muse it should connect to and it will attempt to connect. Upon connecting it will print out a list of useful information about your Muse and where/how the Muse OSC data is being sent over the network.

Getting Started

Have a look at the overall guide for the Muse Research Tools. It covers everything you need to know to get up and running with MuseIO.

Available Data

MuseIO provides access to raw EEG, power bands (alpha, beta, delta, gamma, and theta), blink + jaw clench detection, concentration and mellow classifiers, and more. For a list of all available data, see the Available Data subsection.

Command Line Options

MuseIO is a flexible tool. There are many options that you can pass to it to configure various things like which port(s) the data will be sent to, how the data will be named, configuring the 50/60Hz notch filter, and much more. For a complete list of options, see here.