question mark FAQ

There are a few ways. Depending on what you are intending to do, you may prefer one of them. For example, if you’re building an app, you’ll want to use LibMuse. If you need to quickly and easily record data, you’ll want to use MuseIO and MuseLab.

  1. Use LibMuse on Android or iOS to build an app that directly connects to Muse.
  2. Use MuseIO to connect to Muse and stream data over OSC to another program running an OSC server.
  3. Implement the Muse Communication Protocol, which defines how Muse packets are encoded and compressed.
You should not have to manually install any dependencies to use the Research Tools. The Research Tools come packaged as a standalone installer. Older versions required the manual installation of several packages, including things like Google Protocol Buffers. However, this is no longer necessary. We highly recommend uninstalling old versions of the SDK/Research Tools and using the latest one, as it will require much less manual configuration, and you’ll be able to get started much faster. Download the latest Research Tools here.
Many kinds of data are available in the Muse SDK including raw EEG data, raw accelerometer, raw FFT coefficients, relative and absolute band powers for Alpha, Beta, Delta, Theta, and Gamma waves, blink and jaw clench detection, and more.

To see the data available from the Muse Research Tools, see their Available Data section.

To see the data available from LibMuse, see the respective API Reference for your platform of choice:

Please refer to the Bluetooth Connectivity section for help.

Yes, pairing mode does not end because a pairing is completed. The only exception to this rule is on iOS mobile devices, which will immediately connect after a pairing.
This is the expected behaviour when you pair Muse with your Mac. The pairing process only establishes the pairing. Once it pairs, it disconnects until some other program requests to connect at a later time. So it will initially show “Connected”, then after a short time “Disconnected” in the Bluetooth device menu when pairing with Muse.

You must run MuseIO to connect with Muse.

Make sure your Muse has the latest firmware. The latest Muse firmware is available exclusively through the Muse app. Pair Muse with an iOS or Android device, open the Muse app, start a session, and you will prompted to update if your firmware is out of date.

Often Bluetooth connectivity issues can be alleviated by using an external USB Bluetooth dongle. See the Bluetooth Connectivity section for details.

Please refer to the Timing and Synchronization section.

If your computer asks you for a PIN, type in “1234”. If “1234” does not work, use “0000”.
Fit is very important for good signal quality. It is essential that the headband be flat and firmly pressed against your forehead with no hair whatsoever in the way. For the ear electrodes, make sure they are contacting as much skin as possible. If you have long hair, it can help a lot to tie it back into a ponytail or bun. If you wear glasses, consider removing them. The exercises in the Calm app require you to keep your eyes closed, in any case, so you won’t require your glasses until after.

Dry skin can also cause bad signal. Consider gently cleaning your forehead and around your ears to potentially improve the connection.

Make sure the Muse electrodes are clean. You can do this buy gently wiping them with a cloth dipped in a moderate amount of rubbing alcohol or hand sanitizer.

Lastly, it is important to sit still for 20-30 seconds after adjusting the headband. The signals from Muse will take a little while to settle down after the headband has been moved. The skin-electrode connection improves gradually over time as a small layer of moisture builds and the electrochemical state reaches an equilibrium. Every time the headband moves relative to the skin, this equilibrium is somewhat interrupted and must be given time to recover.

If you continue to have signal quality issues after following the above instructions, please contact

To get this working, you would synchronize the clocks on each computer Muse is connected to. Usually you would use NTP for this, which is made to sync clocks on different computers. This is available on all major operating systems.
As soon as it is ready! Sign up for the dev mailing list to get the news ASAP:

Research Tools

Go to the installation directory and run the uninstaller. You cannot install a new version of the Research Tools to the same folder, the installer will ask you to uninstall the older version first. If you store muse data in the same folder it will not be deleted.


The LibMuse installer doesn’t change your environment variables, so there is no need for an uninstaller. Just delete the installation directory.

The previously published experimental values “Mellow” and “Concentrate” are NOT the values used in the Muse application for the meditation experience. We have removed these values from the SDK because we do not believe they reflect the quality of experience that we would like our users to have. If you would like to put similar values back into your application, we suggest you follow the published algorithm described in the documentation below.

The following recipe is based on an algorithm developed for the Muse by a team across the following institutions: Rotman Research Institute, Toronto, Canada; Max Planck Institute for Cognitive and Brain Science, Leipzig, Germany; Department of Neurology, Charité –Universitätsmedizin Berlin, Berlin, Germany; and Department of Psychology, University of Toronto, Ontario, Canada.

The team published a paper that is available free to the public:
‘My Virtual Dream’: Collective Neurofeedback in an Immersive Art Environment by Natasha Kovacevic, Petra Ritter, William Tays, Sylvain Moreno, Anthony Randal McIntosh which can be accessed from

Mellow and Concentrate are based on Relative Band Powers that are described in the Muse Developers web site at

Mellow is based on the relative spectral power of alpha (7.5 – 13 Hz) called RSPa. RSPa uses Relative Band Powers from the Muse SDK called alpha_relative whose values range between 0 and 1. These values are sent out every 100 ms so we recommend taking a moving average of the last 20 values.

Concentrate is based on the relative spectral power of gamma(30 – 44 Hz) called RSPb. RSPb uses Relative Band Powers from the Muse SDK called gamma_relative whose values range between 0 and 1. These values are sent out every 100 ms so we recommend taking a moving average of the last 20 values. Note that the My Virtual Dream paper mentioned above used the beta band instead of the gamma band.