myo-python - Python bindings for the Myo SDK

This module is a ctypes based wrapper for the Thalmic Myo SDK that is compatible with Python 2 and 3. The source is hosted on GitHub.

There are two ways to use the myo-python bindings: You can either implement a myo.DeviceListener (this is the preferred method as it includes the least overhead) or you can use the myo.Feed object to read the most recent data when you really need it.

Notifications

The preferred method to use the Myo SDK is to implement the myo.DeviceListener interface. It defines a number of functions that will be invoked on various events and when data becomes available.

from time import sleep
from myo import init, Hub, DeviceListener

class Listener(DeviceListener):

    def on_pair(self, myo, timestamp, firmware_version):
        print("Hello, Myo!")

    def on_unpair(self, myo, timestamp):
        print("Goodbye, Myo!")

    def on_orientation_data(self, myo, timestamp, quat):
        print("Orientation:", quat.x, quat.y, quat.z, quat.w)

init()
listener = DeviceListener()
hub = Hub()
hub.run(1000, listener)

try:
  while True: sleep(0.5)
finally:
  hub.shutdown()  # !! crucial

Data Polling

In many cases, it is much easier to just read the most recent data from a Myo armband when you actually need it. The myo.Feed is an implementation of the myo.DeviceListener interface that creates a myo.Feed.MyoProxy object for each connected Myo which always contains the most recent data. These proxy objects are thread-safe.

from myo import init, Hub, Feed

init()
feed = Feed()
hub = Hub()
hub.run(1000, feed)

try:
  myo = feed.wait_for_single_device(timeout=2.0)
  if not myo:
    print("No Myo connected after 2 seconds")
  print("Hello, Myo!")
  while hub.running and myo.connected:
    quat = myo.orientation
    print('Orientation:', quat.x, quat.y, quat.z, quat.w)
finally:
  hub.shutdown()  # !! crucial

Installation

Since the Thalmic Myo SDK is only available for Windows and Mac, myo-python can only be used on these two platforms.

  1. Install myo-python via Pip: pip install myo-python
  2. Download the Myo SDK
  3. Make sure the library can find the Myo SDK. - PATH on Windows - DYLD_LIBRARY_PATH on Mac. You can add something like this to your ~/.bashrc, export DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:/Developer/myo_sdk/myo.framework

Note

You can also pass the path to the shared library to myo.init().

Indices and tables