# whoop4-ble: reconstructing Whoop 4.0 sensor data access

> whoop4-ble reconstructs direct BLE access to Whoop 4.0 sensor records in a Python client. It documents command framing, CRCs, historical-data draining, and a five-byte SET_CLOCK payload that the author reports fixes stalled flash recording; tools export HR, RR, and accelerometer samples and monitor packets.

- 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/andyguzmaneth/whoop4-ble>
- Primary source: <https://github.com/andyguzmaneth/whoop4-ble/blob/a76ad4576bda9ec76cc6347ff9ad18fbcad1cd88/README.md>
- Catalog page: <https://awesomerea.org/resources/whoop4-ble-case/>
- Record JSON: <https://awesomerea.org/resources/whoop4-ble-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/whoop4-ble-case/index.md)

## Requirements & limits

- **Prerequisites:** Python 3.10 or later and a Whoop 4.0 strap are required.
- **Prerequisites:** The strap should be unpaired from the official app before direct BLE access.
- **Limits:** Cloud-derived recovery, strain, and sleep scores are unavailable; some sensor fields remain partially decoded.
- **License:** MIT license.

## Primary sources

1. <https://github.com/andyguzmaneth/whoop4-ble/blob/a76ad4576bda9ec76cc6347ff9ad18fbcad1cd88/README.md>
2. <https://github.com/andyguzmaneth/whoop4-ble/blob/a76ad4576bda9ec76cc6347ff9ad18fbcad1cd88/docs/PROTOCOL.md>
3. <https://github.com/andyguzmaneth/whoop4-ble/blob/a76ad4576bda9ec76cc6347ff9ad18fbcad1cd88/docs/STATUS.md>

## More in Protocols

- [MSI Mystic Light RGB Web Control Panel: reconstructing B760M-A lighting control](https://awesomerea.org/resources/msi-mystic-light-web-case/index.md) · Case study
- [Open Trofeo LCD: implementing Thermalright Trofeo USB display control](https://awesomerea.org/resources/open-trofeo-lcd-case/index.md) · Case study
- [Soundpeats Mini Pro HS Controller: rebuilding earbud controls over Bluetooth](https://awesomerea.org/resources/soundpeats-mini-pro-hs-controller-case/index.md) · Case study
- [breezyd: reconstructing local control of Twinfresh Breezy ventilators](https://awesomerea.org/resources/breezyd-twinfresh-protocol-case/index.md) · Case study
- [ebkn-m61-protocol: reconstructing biometric terminal communications](https://awesomerea.org/resources/ebkn-m61-protocol-case/index.md) · Case study
- [Divoom Times Frame: partial cloud and local API reconstruction](https://awesomerea.org/resources/divoom-times-frame-research-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.