# haylou-rt-tools: reconstructing Haylou RT BLE and watch-face formats

> haylou-rt-tools reconstructs selected Haylou RT LS05S watch interactions and the .tbwf watch-face format from device observation and study of the Hello Haylou app. Its Python tools query firmware and battery status, pair with the watch, show a text alert during pairing, build and check faces, and preview main text elements. The protocol notes specify BLE services, frame checksums, and command IDs.

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

## Requirements & limits

- **Prerequisites:** Python 3.10 or newer and a Haylou RT LS05S watch for device operations.
- **Testing evidence:** Documented device tests use firmware V21.01.004.2.1.1.3.51 and Hello Haylou 3.7.19; other versions are untested.
- **Limits:** Generated faces and previews have not been confirmed against a real watch screen; direct upload and firmware update code are absent.
- **License:** MIT License.

## Primary sources

1. <https://github.com/jvitorcosta/haylou-rt-tools/blob/cfb4c22ccd55f533853d4c2e3bef86e633b9b695/README.md>
2. <https://github.com/jvitorcosta/haylou-rt-tools/blob/cfb4c22ccd55f533853d4c2e3bef86e633b9b695/docs/protocol.md>
3. <https://github.com/jvitorcosta/haylou-rt-tools/blob/cfb4c22ccd55f533853d4c2e3bef86e633b9b695/docs/reverse-engineering.md>

## More in Protocols

- [DJI RC Plus 2: control protocol and gamepad bridge](https://awesomerea.org/resources/dji-rc-plus-2-controls-case/index.md) · Case study
- [AK820 Center: a Linux configurator for the AJAZZ AK820 Pro](https://awesomerea.org/resources/ak820-center-case/index.md) · Case study
- [Komimi: a Redmi Buds 6 Lite client built on its reconstructed control protocol](https://awesomerea.org/resources/komimi-case/index.md) · Case study
- [Fisher & Paykel RF505BRNUX1: decoding refrigerator board traffic](https://awesomerea.org/resources/fisher-paykel-fridge-bus-case/index.md) · Case study
- [Lightstick Vibed Studio: reconstructing the Super Junior Ver. 2 BLE controls](https://awesomerea.org/resources/lightstick-vibed-studio-case/index.md) · Case study
- [IOTBT701: BLE LED strip protocol and Windows client](https://awesomerea.org/resources/iotbt701-ambilight-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.