{
  "added_at": "2026-11-06",
  "additional_evidence_urls": [
    "https://github.com/brendangooden/j2208-band-tools/blob/62ce48357e25d1c68e4c3e0bfd8d2cf1bbd745e9/README.md"
  ],
  "category": "reconstruction-cases",
  "description_en": "j2208-band-tools implements a direct BLE client for J2208-family fitness bands using protocol findings recovered from the FitTrack Health companion app. Its Python tools read stored health history and live sensor values, probe GATT services and collect readings into SQLite. The author checked the documented 16-byte frame protocol against one Hume Band V2.",
  "description_zh": "j2208-band-tools 根据从 FitTrack Health 配套应用恢复的协议，实现 J2208 系列健身手环的直连 BLE 客户端。Python 工具可读取历史健康记录与实时传感器数据、探测 GATT 服务，并将采集结果存入 SQLite。作者在一只 Hume Band V2 上核对了文档所述的 16 字节帧协议。",
  "entry_url": "https://awesomerea.org/resources/j2208-band-tools-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/j2208-band-tools-case/",
  "evidence_url": "https://github.com/brendangooden/j2208-band-tools/blob/62ce48357e25d1c68e4c3e0bfd8d2cf1bbd745e9/PROTOCOL.md",
  "group": "cases",
  "id": "j2208-band-tools-case",
  "json_url": "https://awesomerea.org/resources/j2208-band-tools-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/j2208-band-tools-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/j2208-band-tools-case/index.md",
  "name": "j2208-band-tools: a direct client for the J2208 fitness-band protocol",
  "name_zh": "j2208-band-tools：基于 J2208 手环协议的直连客户端",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "testing",
    "limits",
    "license"
  ],
  "requirements": [
    "A J2208-family band and Python with bleak; the companion app must release its BLE connection before the tools connect.",
    "The author tested one Hume Band V2 with firmware v0.0.3.9; support for other family members is inferred.",
    "Raw PPG is reported unavailable on the tested V2 firmware.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 J2208 系列手环、Python 和 bleak；连接前需让配套应用断开蓝牙连接。",
    "作者只测试了一只运行 v0.0.3.9 固件的 Hume Band V2；对其他同系列设备的支持属于推断。",
    "作者报告所测 V2 固件无法提供原始 PPG 数据。",
    "采用 MIT 许可证。"
  ],
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/brendangooden/j2208-band-tools",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}