Case study
miband-lit: reconstructing Mi Band 5 BLE heart-rate access
miband-lit implements direct BLE communication with a Mi Band 5 to authenticate, stream heart-rate readings and send notifications or vibration commands. Its write-up describes the band's 16-byte key and AES challenge-response exchange. A Streamlit dashboard displays readings, while an optional WiZ bulb integration reacts to them.
- Targets
- Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
- Evidence class
- C2 code & docs, no demo or download
- Stars
- 2
- Last commit
- 2026-06-15
- Language
- Python
- License (GitHub)
- MIT
GitHub data as of 2026-11-10
Evidence
- Observed
- Code and documentation observed; no download method or demo found.
- Checked
- 2026-11-08
Requirements & limits
- Prerequisites: A Mi Band 5, macOS with Bluetooth access, Python dependencies, and the band's 16-byte key from the user's Zepp account are required.
- Limits: The author reports intermittent heart-rate sessions and a reading cadence of only one value every few seconds.
- License: MIT license.
Cite
BibTeX
@misc{miband-lit-case,
title = {{miband-lit: reconstructing Mi Band 5 BLE heart-rate access}},
howpublished = {\url{https://github.com/myselfshravan/miband-lit}},
url = {https://github.com/myselfshravan/miband-lit},
urldate = {2026-11-06},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/miband-lit-case/}}
}Plain text
miband-lit: reconstructing Mi Band 5 BLE heart-rate access. https://github.com/myselfshravan/miband-lit (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/miband-lit-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
More in Protocols
- Zafro AC: replacing the I4season device cloud locally · Case study
- open-apt-flash: reconstructing the APT 860C UART flasher · Case study
- MADLIONS 60 Configurator: reconstructing MAD60 USB HID configuration · Case study
- ax206-usb-display-macos: driving the QDtech display over USB · Case study
- SP542E MQTT ↔ BLE bridge: local control through the controller protocol · Case study
- ESPHome — Technibel SCDF32C5I IR Climate: reconstructing air-conditioner infrared control · Case study