krpouncy / PyMuse

A way to connect to the Muse Headset via the Muse Monitor

PyMuse

A way to connect to the Muse Headset via the Muse Monitor

Tested for Windows Python Only

Dependencies

python-osc: ">= 1.7.4"

Getting Connected

1. Connect your headband to the Muse Monitor App

[Android][Apple]

2. Check the Muse Monitor Settings

1. Set the Server IP to your computer IP address
2. Set the Server Port to 5000
3. Set the OSC Stream Brainwaves to "All Values"

3. Start the Server

Usage Examples

Getting Started

import PyMuse
headband = PyMuse.Headband()
headband.start_server()

Setting the Server IP Address and Port Number

Method 1:

headband = PyMuse.Headband(ip = "192.168.0.42", port = 8000)

(when inheriting multiple classes)

class MindReader(QObject, PyMuse.Headband):
  def __init__(self, **kwargs)
    # call the __init__ of parent classes
    QObject.__init__(self)
    PyMuse.Headband.__init__(self, **kwargs)

  def run(self):
    pass

headband = MindReader(ip = "192.168.0.42", port = 8000)

Method 2:

headband = PyMuse.Headband()
headband.setServerInfo("192.168.0.12", 5000)

Getting Derivative Brainwaves

import PyMuse

# Create a child class
class MindReader(PyMuse.Headband):
  def run(self):
  """ this method updates at 10hz """
    brainwaves = self.get_brainwaves()
    alpha_brainwaves = brainwaves["alpha"]
    theta_brainwaves = brainwaves["theta"]

    average = lambda x: sum(x)/len(x)
    if average(alpha_brainwaves) > average(theta_brainwaves):
      print("More Alpha than Theta")

# Start the server
headband = MindReader(ip = "192.168.0.42", port = 8000)
headband.start_server()

Getting Raw Brainwaves

class MindReader(PyMuse.Headband):
  def run(self):
    raw_eeg = self.get_raw_brainwaves()
    eeg1 = raw_eeg[0]
    eeg2 = raw_eeg[1]
    eeg3 = raw_eeg[2]
    eeg4 = raw_eeg[3]
    print(eeg1, eeg2, eeg3, eeg4)

headband = MindReader(ip = "192.168.0.42", port = 8000)
headband.start_server()