Case study

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.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-06
Evidence class: C2 code & docs, no demo or download

Stars: 2
Last commit: 2026-05-11
Language: Python
License (GitHub): MIT

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Observed: Code and documentation observed; no download method or demo found.
Checked: 2026-11-08

How evidence classes are assigned

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.

Cite

BibTeX

@misc{whoop4-ble-case,
  title = {{whoop4-ble: reconstructing Whoop 4.0 sensor data access}},
  howpublished = {\url{https://github.com/andyguzmaneth/whoop4-ble}},
  url = {https://github.com/andyguzmaneth/whoop4-ble},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/whoop4-ble-case/}}
}

Plain text

whoop4-ble: reconstructing Whoop 4.0 sensor data access. https://github.com/andyguzmaneth/whoop4-ble (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/whoop4-ble-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

README.md GitHub · andyguzmaneth/whoop4-ble · Revision a76ad45
docs/PROTOCOL.md GitHub · andyguzmaneth/whoop4-ble · Revision a76ad45
docs/STATUS.md GitHub · andyguzmaneth/whoop4-ble · Revision a76ad45