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.1.tar.gz (25.2 kB view details)

Uploaded Source

Built Distribution

dl_myo-1.0.1-py3-none-any.whl (25.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: dl_myo-1.0.1.tar.gz
  • Upload date:
  • Size: 25.2 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.1.tar.gz
Algorithm Hash digest
SHA256 0c49b0f0301610ba10b710740cbe64a925bc24c3c5e0dd61a845565e261988a4
MD5 37d5406dcbd56ce7fa5df0229d379c3b
BLAKE2b-256 5c662127dbf594448e013413874d656e9367e6ad5cf87542adbdbe0a0b30c50d

See more details on using hashes here.

Provenance

File details

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

File metadata

  • Download URL: dl_myo-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 25.0 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 33aec85e05a3fcf237a4fd8b24add6493ae4c03d708ba37b729b15fdaf3395e5
MD5 e94d06943488e19cfb5adef2c20ae46f
BLAKE2b-256 505a6d952d517436520254772ddf4a67f71e5cb13a7c67a0333234f6361dba3b

See more details on using hashes here.

Provenance

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