Skip to main content

Python Library for Ember Mugs.

Project description

Python Ember Mug

pypi python Build Status codecov Project Maintenance

Python Library for interacting with Ember Mugs over Bluetooth

Summary

This is an unofficial library to attempt to interact with Ember Mugs via Bluetooth. This was created for use with my Home Assistant integration, but could be useful separately and has a simple CLI interface too.

Note: Should work with the standard Ember Mugs (1 and 2), but the thermoses have not been tested.

Features

  • Finding mugs
  • Connecting to Mugs
  • Reading Information (Colour, temp, liquid level, etc.)
  • Writing (Desired temp, colour, temperature unit)*
  • Polling for changes

*** Writing only works if the mug has been set up in the app previously

Usage

Python

from ember_mug.scanner import find_mug, discover_mugs
from ember_mug.mug import EmberMug

# if first time with mug in pairing
mugs = await discover_mugs()
device = mugs[0]
# after paired you can simply use
device = await find_mug()
mug = EmberMug(device)
async with mug.connection() as con:
    print('Connected.\nFetching Info')
    await con.update_all()
    print(mug.formatted_data)

CLI

It can also be run via command line either directly with ember-mug --help or as a module with python -m ember_mug --help There are four options with different subsections. You can see them by specifying them before help. eg ember-mug poll --help

ember-mug discover  # Finds the mug in pairing mode for the first time
ember-mug poll  # fetches info and keeps listening for notifications
ember-mug get name target-temp  # Prints name and target temp of mug
ember-mug set --name "My mug" --target-temp 56.8  # Sets the name and target temp to specified values

Basic options:

Command Use
discover Find/List all detected unpaired mugs in pairing mode
find Find one already paired mugs
info Connect to one mug and print its current state
poll Connect to one mug and print its current state and keep watching for changes
get Get the value(s) of one or more attribute(s) by name
set Set one or more values on the mug

CLI Example

Caveats

  • Since this api is not public, a lot of guesswork and reverse engineering is involved, so it's not perfect.
  • If the mug has not been set up in the app since it was reset, writing is not allowed. I don't know what they set in the app, but it changes something, and it doesn't work without it.
  • Once that mug has been set up in the app, you should ideally forget the device or at least turn off bluetooth whilst using it here, or you will probably get disconnected often
  • I haven't figured out some attributes like udsk, dsk, location and timezone.

Troubleshooting

'Operation failed with ATT error: 0x0e' or another connection error

This seems to be caused by the bluetooth adaptor being in some sort of passive mode. I have not yet figured out how to wake it programmatically so sadly, you need to manually open bluetoothctl to do so. Please ensure the mug is in pairing mode (ie the light is flashing blue) and run the bluetoothctl command. You don,t need to type anything. run it and wait until the mug connects.

Todo

  • Test with other devices. Please let me know if you have tried it with others.

Credits

This package was created with Cookiecutter and the waynerv/cookiecutter-pypackage project template.

Notice of Non-Affiliation and Disclaimer

This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with Ember.

The name Ember as well as related names, marks, emblems and images are registered trademarks of their respective owners.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

python_ember_mug-0.6.0b8.tar.gz (26.7 kB view details)

Uploaded Source

Built Distribution

python_ember_mug-0.6.0b8-py3-none-any.whl (20.4 kB view details)

Uploaded Python 3

File details

Details for the file python_ember_mug-0.6.0b8.tar.gz.

File metadata

  • Download URL: python_ember_mug-0.6.0b8.tar.gz
  • Upload date:
  • Size: 26.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.2

File hashes

Hashes for python_ember_mug-0.6.0b8.tar.gz
Algorithm Hash digest
SHA256 40a32ef0634c08c7559f9cdf71402c2a67e1752f8b411fc70cc0d3e74854c03a
MD5 282e87d2a5075ae076f45ce1df9df39f
BLAKE2b-256 47ee9bd8d1c73171f552a1d08c5df4f013dc09be3fd6abdeda62cea09286a2c5

See more details on using hashes here.

File details

Details for the file python_ember_mug-0.6.0b8-py3-none-any.whl.

File metadata

File hashes

Hashes for python_ember_mug-0.6.0b8-py3-none-any.whl
Algorithm Hash digest
SHA256 93d59cec79a7394e44837aa68a26d698045ac92b1787152673a760c7b6f0a23c
MD5 1bb0e5293c5cf5644b4489c301128b2b
BLAKE2b-256 3a1337dd5233f55da87df667eafed47771e8e188505162bf94f6f6b2c1a972dd

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