research toolsResearch Tools | MusePlayer

BitbucketFork Me


NOTE: The research tools are compatible with the Muse 2014 headband. Support for the Muse 2016 headband is coming soon. To purchase a Muse 2014 headband please contact


MusePlayer is a utility for recording, replaying, rerouting, and converting EEG and accelerometer data from Muse. It can save to and convert between the native Muse file format (.muse), Matlab (HDF5), CSV, and .txt (OSC replay) formats.

It is an open source project. All the source code and examples are available on Bitbucket.

Currently muse-player supports the following inputs and output file formats:

Supported InputsSupported Outputs
OSC network streamOSC network stream
Muse file format v1Muse file format v2
Muse file format v2.mat (MATLAB)
.txt (oscreplay).txt (oscreplay)
Print to screen



MusePlayer takes Muse data in a variety of formats and then outputs Muse data in a variety of formats.

NOTE: these examples are for Mac and Linux, but the only difference on Windows is that you may have to include a “.exe” suffix on the muse-player command.

Some simple examples:

muse-player -l 5000

Listens for Muse data over TCP (default) one port 5000 and prints it to the screen (default).

muse-player -l 5000 -M path/to/recording/muse_recording.mat

Listens for Muse OSC data over TCP on port 5000, and records it to a MATLAB file in path/to/recording/muse_recording.mat

MusePlayer can also replay recorded Muse data. For example, if you have a Muse file you recorded some time ago called my_muse_file.muse, you could replay it (and then, say, look at it being plotted in MuseLab receiving TCP on port 5000) like this:

muse-player -f my_muse_file.muse -s osc.tcp://localhost:5000

Command Line Options

For more information on all the options for MusePlayer including message filtering options, type “muse-player –help” in your shell to see the help docs, or refer to the Command Line Options page.