# 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.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/gwhillhouse/ember-mug-app>
- Primary source: <https://github.com/gwhillhouse/ember-mug-app/blob/9700820d957e69a1cd62a9389fdc783ca2078734/docs/statistics-stream.md>
- Catalog page: <https://awesomerea.org/resources/ember-mug-drink-log-case/>
- Record JSON: <https://awesomerea.org/resources/ember-mug-drink-log-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/ember-mug-drink-log-case/index.md)

## 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.

## Primary sources

1. <https://github.com/gwhillhouse/ember-mug-app/blob/9700820d957e69a1cd62a9389fdc783ca2078734/docs/statistics-stream.md>
2. <https://github.com/gwhillhouse/ember-mug-app/blob/9700820d957e69a1cd62a9389fdc783ca2078734/README.md>

## More in Protocols

- [PreSonus Quantum Linux: investigating Quantum 2626 control for Linux audio](https://awesomerea.org/resources/presonus-quantum-linux-case/index.md) · Case study
- [Berbel Remote Emulator: reconstructing kitchen-hood BLE controls](https://awesomerea.org/resources/berbel-remote-emulator-case/index.md) · Case study
- [KuKirin G4: decoding BLE ride-mode notifications](https://awesomerea.org/resources/kukirin-g4-ble-mode-case/index.md) · Case study
- [Mutant Brain: mapping its SysEx configuration format](https://awesomerea.org/resources/reveng-mutantbrain-case/index.md) · Case study
- [TBBT A9 mini camera: reconstructing PPPP video login](https://awesomerea.org/resources/tbbt-a9-pppp-ha-case/index.md) · Case study
- [loxone-link-dotnet: implementing Loxone Link NAT-over-CAN devices](https://awesomerea.org/resources/loxone-link-dotnet-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.
