Using the Muse Research Tools works like this:
- Pair your device with Muse.
- Run MuseIO to connect to Muse.
- Receive Muse data via OSC in another program like MuseLab or MusePlayer.
So! Let’s get started:
Install the Research ToolsDownload and install the Muse Research Tools. The installer includes MuseIO, MuseLab, and MusePlayer.
On OS X, everything will be installed in
/Applications/Muse. NOTE: your bash_profile will be modified to add this directory to your PATH. If you are using another shell such as zsh, you will have to modify the appropriate configuration file yourself.
On Windows, everything will be installed in
Program Files (x86)/Muse.
On Linux, everything will be installed in
Pair Muse with your computer
Put Muse into Pairing Mode by holding the button down for five seconds until all five LEDs begin flashing on and off in unison. Release the button.
Open the Bluetooth devices menu on your system. With Bluetooth turned on and your computer discoverable, wait for Muse to appear in the list of available devices. When it does, click on it and ask to pair. If you are prompted with a passcode request, accept it. Wait for the pairing process to complete. Once paired, all five LEDs will continue to flash on and off. This will only change once a streaming connection is established.
NOTE: On some systems, when pairing, Muse will show that it is “Connected”, and then after a few seconds “Disconnected”. This is normal. Pairing is not the same as connecting. Muse will only show as permanently “Connected” once a program connects to it to stream data. More on that soon.
Make sure your Muse is paired and turned on.
Open a Terminal or Command Prompt and enter the following command:
muse-io --device MUSE_DEVICE_NAME
where MUSE_DEVICE_NAME is the name of the Muse device you previously paired. If you have the latest firmware, this will be something like “Muse-1234″.
MuseIO will begin searching for your Muse and then attempt to connect with it. This may take up to 30 seconds.
Congratulations! MuseIO is now connected to Muse and is sending out OSC messages containing Muse data to the default TCP port 5000.
NOTE: Don’t worry about that “OSC error 61″ / “TCP connection failure”. It just means that nothing is receiving the messages that MuseIO is sending out. That’s what MuseLab will do when we start it.
Start MuseLab receiving on port 5000
On Mac, with the Finder, navigate to
/Applications/Muse. Double click on the MuseLab icon.
On Windows, navigate to
C:\Program Files (x86)\Muse. Double click on the MuseLab icon.
In the Opened Ports text box, enter 5000 and Click Open Port.
You should see the incoming messages listed below a few seconds later.
Create a Scrolling Line Graph
Add Muse data streams to the graph
In the Signal Group Options box, check the Draw box for /muse/eeg/raw.
Live EEG data will start to be plotted. Click on the plot area and use the up arrow key to zoom into the graph The default graph scale is zoomed far out, so the EEG data will look small at first. Note the occasional large spikes in the waveforms – those are blinks. Go ahead, try a blink or two!
Add graphs for accelerometer and alpha session scores
- Create a new Scrolling Line Graph
- Rename it
- Add the appropriate data stream
Make sure to click on each graph and use the up/down arrows to scale it up or down to a point where you can easily see changes in it. For example, /muse/elements/alpha_session_score To play around with the session scores, try closing your eyes and relaxing for about ten seconds, then open your eyes. You should see the scores increase when you closed your eyes and decrease shortly after you opened them. ranges from 0 to 1, so make sure the scale (displayed in the top right corner of each graph) is appropriate (it starts way out at 5000 units/division).
You should end up with something like the example on the right.
Record some data
Convert your recording to a different file format
MuseLab records data in the .muse file format. To convert to a variety of other file formats or to replay Muse data from a recording over OSC to another program (say, to look at some data you recorded a while ago with MuseLab) you must use MusePlayer.
Open a Terminal or Command Prompt and enter the following command.
muse-player-f path/to/recording.muse -C recording.csv
For more information on how Muse data is stored, check out the File Formats section.
Go forth and explore!
You now know everything you need to know to get started using the Muse Research Tools to experiment with Muse! Have at it!