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

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/myselfshravan/miband-lit>
- Primary source: <https://github.com/myselfshravan/miband-lit/blob/fc9165c57ea90e5d8f0ecfe5274c73cce05b33f1/README.md>
- Catalog page: <https://awesomerea.org/resources/miband-lit-case/>
- Record JSON: <https://awesomerea.org/resources/miband-lit-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/miband-lit-case/index.md)

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

## Primary sources

1. <https://github.com/myselfshravan/miband-lit/blob/fc9165c57ea90e5d8f0ecfe5274c73cce05b33f1/README.md>
2. <https://github.com/myselfshravan/miband-lit/blob/fc9165c57ea90e5d8f0ecfe5274c73cce05b33f1/BLOG.md>

## More in Protocols

- [Zafro AC: replacing the I4season device cloud locally](https://awesomerea.org/resources/zafro-ha-local-case/index.md) · Case study
- [open-apt-flash: reconstructing the APT 860C UART flasher](https://awesomerea.org/resources/open-apt-flash-case/index.md) · Case study
- [MADLIONS 60 Configurator: reconstructing MAD60 USB HID configuration](https://awesomerea.org/resources/madlions-configurator-case/index.md) · Case study
- [ax206-usb-display-macos: driving the QDtech display over USB](https://awesomerea.org/resources/ax206-usb-display-macos-case/index.md) · Case study
- [SP542E MQTT ↔ BLE bridge: local control through the controller protocol](https://awesomerea.org/resources/sp542e-ha-bridge-case/index.md) · Case study
- [ESPHome — Technibel SCDF32C5I IR Climate: reconstructing air-conditioner infrared control](https://awesomerea.org/resources/esphome-technibel-scdf32-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.