Case study
Ember Mug: decoding the on-device drink-log stream
The Ember Mug app decodes the undocumented fc540013 Bluetooth LE statistics stream from an Ember Mug 2 into a drink log. Its format notes describe notification fragments, record fields, timestamps, and the device's backlog behavior; the macOS menu-bar app combines decoded records with its own live readings.
- Targets
- Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
- Evidence class
- C2 code & docs, no demo or download
- Stars
- 9
- Last commit
- 2026-09-15
- Language
- Python
- License (GitHub)
- MIT
GitHub data as of 2026-11-10
Evidence
- Observed
- Code, documentation and a demo observed; no download method found.
- Checked
- 2026-11-09
Requirements & limits
- Prerequisites: An Ember mug previously set up through the Ember phone app, macOS 12+, and Python 3.11+.
- Limits: The statistics-stream findings come from one Ember Mug 2 with firmware 406; some fields remain hypotheses.
- License: MIT license.
Cite
BibTeX
@misc{ember-mug-drink-log-case,
title = {{Ember Mug: decoding the on-device drink-log stream}},
howpublished = {\url{https://github.com/gwhillhouse/ember-mug-app}},
url = {https://github.com/gwhillhouse/ember-mug-app},
urldate = {2026-11-06},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/ember-mug-drink-log-case/}}
}Plain text
Ember Mug: decoding the on-device drink-log stream. https://github.com/gwhillhouse/ember-mug-app (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/ember-mug-drink-log-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
- docs/statistics-stream.md GitHub · gwhillhouse/ember-mug-app · Revision 9700820
- README.md GitHub · gwhillhouse/ember-mug-app · Revision 9700820
More in Protocols
- PreSonus Quantum Linux: investigating Quantum 2626 control for Linux audio · Case study
- Berbel Remote Emulator: reconstructing kitchen-hood BLE controls · Case study
- KuKirin G4: decoding BLE ride-mode notifications · Case study
- Mutant Brain: mapping its SysEx configuration format · Case study
- TBBT A9 mini camera: reconstructing PPPP video login · Case study
- loxone-link-dotnet: implementing Loxone Link NAT-over-CAN devices · Case study