Skip to main content

Yet another MyoConnect alternative without dongles

Project description

dl-myo (Dongle-less Myo)

build status image size codecov python versions pypi version license

dl-myo is yet another MyoConnect alternative for Myo Armband without an official Myo dongle.

If you are fed up with the dongle and still want to use Myo anyway (in Python), this is the right stuff to grab.

The GATT service naming convention reflects the official BLE specification for Myo (i.e., myohw.h); however, some services and characteristics differ for a uniform naming.

See myo/profile.py for more detail.

Features

Compared to other Myo libraries/SDKs:

  • Full-scratched in Python, no dependency from other runtime (e.g., the official cpp SDK)
  • Multi-platform support based on Bleak, instead of bluepy or pybluez
  • Stream EMG data (filtered/raw) and IMU data simultaneously using asyncio
  • A sample docker image provided -- runs just off the shelf

Platform Support

Linux Raspberry Pi macOS Windows

Install

pip install dl-myo

Example

The script scans a Myo device, connect to the device, prints the GATT profile from the device, collect EMG data for 5 seconds, and then disconnect.

Any Myo Armband should have the service UUID d5060001-a904-deb9-4748-2c7f4a124842.

python examples/sample_client.py

Otherwise, you can also bind to a specific MAC address. For example,

python examples/sample_client.py --mac D2:3B:85:94:32:8E

Try the example with Docker

docker compose pull
docker compose run --rm dl-myo

Build with Poetry

Install Poetry first.

poetry build

Credits

This project was first inspired by Dongleless-myo (originally created by @mamo91 and enhanced by @MyrikLD) which provides a great starting point using bluepy.

In addition to Myo Bluetooth Official Protocol, I would like to mention that the following resources on GitHub have been very helpful:

Author

@iomz (Iori Mizutani)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dl_myo-1.0.3.tar.gz (25.1 kB view details)

Uploaded Source

Built Distribution

dl_myo-1.0.3-py3-none-any.whl (24.4 kB view details)

Uploaded Python 3

File details

Details for the file dl_myo-1.0.3.tar.gz.

File metadata

  • Download URL: dl_myo-1.0.3.tar.gz
  • Upload date:
  • Size: 25.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/4.0.1 CPython/3.11.4

File hashes

Hashes for dl_myo-1.0.3.tar.gz
Algorithm Hash digest
SHA256 60712e558879189028dd6a20a5c764c07205a6507d68bb618b305c7bf030ce5c
MD5 09faae9014e26dc7805c3ce61d360432
BLAKE2b-256 31c04ec5bd3b106d46c73a8c67381fb54939435150419ab7d44330705e960a94

See more details on using hashes here.

File details

Details for the file dl_myo-1.0.3-py3-none-any.whl.

File metadata

  • Download URL: dl_myo-1.0.3-py3-none-any.whl
  • Upload date:
  • Size: 24.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/4.0.1 CPython/3.11.4

File hashes

Hashes for dl_myo-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 ba2aced2027bcee663e44a87a81a957b74228367a295f3ae80f8a2e423338b84
MD5 9226449f7597c2d7e072d019c8419dd2
BLAKE2b-256 f1a3a6e51a4dbaaabbe98e17bd7740522cf9e550a78f92ab0341c240f7cb55ac

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page