# qcywatch: a QCY Watch GT2 client built from its BLE protocol and face format

> qcywatch reconstructs QCY Watch GT2 control and watch-face upload from the QCY Android app, BLE captures and face files. Its Linux scripts create and upload faces, read device information and battery state, sync time and send notifications. The author reports using REA to recover the face container layout.

- Type: Case study
- Targets: App · Protocol
- Category: Community REA investigations
- Relationship: Author-reported mixed workflow
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/DhrubaDC1/qcywatch>
- Primary source: <https://github.com/DhrubaDC1/qcywatch/blob/a815407197235b17f7862488c02fd0d2874832d9/README.md>
- Catalog page: <https://awesomerea.org/resources/qcywatch-case/>
- Record JSON: <https://awesomerea.org/resources/qcywatch-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/qcywatch-case/index.md)

## Requirements & limits

- **Prerequisites:** Linux with recent BlueZ, Python 3.11 or newer, and a QCY Watch GT2.
- **Limits:** The watch accepts one Bluetooth connection at a time; phone Bluetooth must be off during use.
- **Testing evidence:** Other QCY watches and analog faces are untested.
- **License:** MIT license.

## Primary sources

1. <https://github.com/DhrubaDC1/qcywatch/blob/a815407197235b17f7862488c02fd0d2874832d9/README.md>
2. <https://github.com/DhrubaDC1/qcywatch/blob/a815407197235b17f7862488c02fd0d2874832d9/reference.md>

## More in Apps

- [hexgrab: rebuilding a color picker from a REA study of PowerToys](https://awesomerea.org/resources/hexgrab-case/index.md) · Case study
- [Windows Live Mail 2012: UI and resource format reconstruction](https://awesomerea.org/resources/wlm2012-research-case/index.md) · Case study
- [anova-power-cli: reconstructing G*Power one-way ANOVA calculations](https://awesomerea.org/resources/anova-power-cli-case/index.md) · Case study
- [Plaude Archiver: local Plaud Note Pro recording transfer](https://awesomerea.org/resources/plaude-archiver-case/index.md) · Case study
- [OpenPDF Studio: rebuilding PDF editing interactions from WPS PDF research](https://awesomerea.org/resources/openpdf-studio-case/index.md) · Case study
- [Keymarks: reconstructing Powermarks 3.5 bookmarks and workflows](https://awesomerea.org/resources/keymarks-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.