tools_icon MusePlayer | Command Line Options


There are a variety of command line options for MusePlayer. Simply type muse-player (or muse-player.exe on Windows) followed by your desired input and output arguments. See below for a description of these arguments. You can also view this information by running muse-player with no arguments – it will be printed to your screen.

optional arguments:

-h, --help            show this help message and exit

-v, --verbose         Print status messages to stdout

-q, --as-fast-as-possible         Replay input as fast as possible instead of using original timing.

-j, --jump-data-gaps           Replay input by omitting any data gaps larger than 1 second.

-n, --no--time--data           Replay input by omitting output of current timing info.

-i FILTER_DATA [FILTER_DATA ...], --filter FILTER_DATA [FILTER_DATA ...]         Filter data by path. e.g. -i                      /muse/dsp/elements/alpha /muse/eeg

Input options:

     Only one type of input can be specified, but can be multiple files of the same type:

     -l [INPUT_OSC_PORT], --input-osc-port [INPUT_OSC_PORT]         
          Listen for OSC messages on this port (default: tcp:5000).

          Input from Muse file format.

          Input from OSC-replay files.

Output options:

     One or more outputs can be specified:

     -s [OUTPUT_OSC_URL], --output-osc-url [OUTPUT_OSC_URL]

          Output OSC messages to HOST:PORT (default:


     -F FILE, --output-muse-file FILE

          Output to a Muse file

      -M FILE, --output-matlab-file FILE

          Output to a Matlab file

      -O FILE, --output-oscreplay-file FILE

          Output to an OSC-replay file

     -C FILE, --output-csv-file FILE

          Output to an CSV file

     -D, --output-screen-dump

          Output to the screen directly


     muse-player -f my_eeg_recording.muse -s osc.tcp://localhost:7887

          This will read in the file "my_eeg_recording.muse" and send those messages as OSC to port 7887.

     muse-player -l 5555 -M matlab.mat -s 5000

          This will receive OSC messages on port 5555, save them to file, and rebroadcast them to port 5000.