# QCYbutMOD: a QCY earbuds client built from reconstructed BLE commands

> QCYbutMOD is an Android client built from reverse engineering of the BLE GATT commands used by QCY earbuds with Wuqi WQ7033 and WQ7034 chips. It reads separate earbud and case battery values from characteristic 0008, sends a command to mute firmware voice prompts, and reads back gesture mappings. Device test notes record command acknowledgments and unanswered multipoint queries.

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

## Requirements & limits

- **Prerequisites:** Android 8.0 to 16+ and a supported QCY earbud model using a Wuqi WQ7033 or WQ7034 chip.
- **Prerequisites:** Building from source requires JDK 17 and Android SDK 36 with Build Tools 36.0.0 or newer.
- **Limits:** The author reports that firmware on the tested device did not respond to multipoint queries 0x4D and 0x4F.
- **License:** MIT license.

## Primary sources

1. <https://github.com/MrSpy00/QCYbutMOD/blob/c0a4b2ad8e982660970b90cf682950f222806ee3/README.md>
2. <https://github.com/MrSpy00/QCYbutMOD/blob/c0a4b2ad8e982660970b90cf682950f222806ee3/ADB_LIVE_TEST_NOTES.md>

## More in Protocols

- [Lian Li UNI HUB SL V2: mapping fan and lighting USB commands](https://awesomerea.org/resources/lian-li-uni-hub-sl-v2-protocol-case/index.md) · Case study
- [SAC9010QC/SAC12010QC: reconstructing an air-conditioner IR protocol](https://awesomerea.org/resources/sac9010qc-sac12010qc-ir-case/index.md) · Case study
- [hydrao-dump: decoding Hydrao shower-head Bluetooth data](https://awesomerea.org/resources/hydrao-dump-case/index.md) · Case study
- [LibreConga: investigating the Conga 5490 communication protocol](https://awesomerea.org/resources/libreconga-5490-case/index.md) · Case study
- [FT017TH: decoding wireless thermometer and hygrometer transmissions](https://awesomerea.org/resources/ft017th-signal-case/index.md) · Case study
- [mg6250_mqtt: decoding Paradox MG6250 serial events](https://awesomerea.org/resources/mg6250-mqtt-protocol-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.