{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/andyguzmaneth/whoop4-ble/blob/a76ad4576bda9ec76cc6347ff9ad18fbcad1cd88/docs/PROTOCOL.md",
    "https://github.com/andyguzmaneth/whoop4-ble/blob/a76ad4576bda9ec76cc6347ff9ad18fbcad1cd88/docs/STATUS.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "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.",
  "description_zh": "whoop4-ble 用 Python 客户端重建对 Whoop 4.0 传感记录的直接 BLE 访问。它记录命令帧、CRC 与历史数据导出流程；作者报告五字节 SET_CLOCK 载荷可修复停滞的闪存记录。工具可导出心率、RR 间隔和加速度数据并监看报文。",
  "entry_url": "https://awesomerea.org/resources/whoop4-ble-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/whoop4-ble-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/andyguzmaneth/whoop4-ble/blob/a76ad4576bda9ec76cc6347ff9ad18fbcad1cd88/README.md",
  "group": "cases",
  "id": "whoop4-ble-case",
  "json_url": "https://awesomerea.org/resources/whoop4-ble-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/whoop4-ble-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/whoop4-ble-case/index.md",
  "name": "whoop4-ble: reconstructing Whoop 4.0 sensor data access",
  "name_zh": "whoop4-ble：重建 Whoop 4.0 传感数据访问",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "Python 3.10 or later and a Whoop 4.0 strap are required.",
    "The strap should be unpaired from the official app before direct BLE access.",
    "Cloud-derived recovery, strain, and sleep scores are unavailable; some sensor fields remain partially decoded.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 Python 3.10 或更新版本及 Whoop 4.0 腕带。",
    "直接 BLE 访问前，应先解除腕带与官方应用的配对。",
    "无法取得云端计算的恢复、负荷和睡眠分数；部分传感字段仍只解码了一部分。",
    "采用 MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/andyguzmaneth/whoop4-ble",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}