# j2208-band-tools: a direct client for the J2208 fitness-band protocol

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

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

## Requirements & limits

- **Prerequisites:** A J2208-family band and Python with bleak; the companion app must release its BLE connection before the tools connect.
- **Testing evidence:** The author tested one Hume Band V2 with firmware v0.0.3.9; support for other family members is inferred.
- **Limits:** Raw PPG is reported unavailable on the tested V2 firmware.
- **License:** MIT license.

## Primary sources

1. <https://github.com/brendangooden/j2208-band-tools/blob/62ce48357e25d1c68e4c3e0bfd8d2cf1bbd745e9/PROTOCOL.md>
2. <https://github.com/brendangooden/j2208-band-tools/blob/62ce48357e25d1c68e4c3e0bfd8d2cf1bbd745e9/README.md>

## More in Protocols

- [Eufy Local Light: reconstructing BLE control for E10 and E22 lights](https://awesomerea.org/resources/eufy-local-ha-case/index.md) · Case study
- [OpenPeats: reconstructing SoundPEATS earbud controls](https://awesomerea.org/resources/openpeats-case/index.md) · Case study
- [hongtai-panel: reconstructing a cooler LCD's USB serial protocol](https://awesomerea.org/resources/hongtai-panel-case/index.md) · Case study
- [ESPHome ↔ L&S Emotion Control: reconstructing a smart-light radio client](https://awesomerea.org/resources/emotion-control-ha-case/index.md) · Case study
- [akp02: reconstructing the Ajazz AKP02 display protocol](https://awesomerea.org/resources/akp02-display-protocol-case/index.md) · Case study
- [RK M75: reconstructing wired and wireless RGB control](https://awesomerea.org/resources/rk-m75-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.