{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/MrSpy00/QCYbutMOD/blob/c0a4b2ad8e982660970b90cf682950f222806ee3/ADB_LIVE_TEST_NOTES.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "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.",
  "description_zh": "QCYbutMOD 是基于 QCY 耳机 BLE GATT 指令逆向分析开发的 Android 客户端，面向采用 Wuqi WQ7033 和 WQ7034 芯片的设备。它从 0008 特征值读取左右耳及充电盒电量，发送固件提示音静音指令，并回读触控手势映射。设备测试记录列出了指令应答和未获回应的多设备连接查询。",
  "entry_url": "https://awesomerea.org/resources/qcybutmod-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/qcybutmod-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/MrSpy00/QCYbutMOD/blob/c0a4b2ad8e982660970b90cf682950f222806ee3/README.md",
  "group": "cases",
  "id": "qcybutmod-case",
  "json_url": "https://awesomerea.org/resources/qcybutmod-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/qcybutmod-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/qcybutmod-case/index.md",
  "name": "QCYbutMOD: a QCY earbuds client built from reconstructed BLE commands",
  "name_zh": "QCYbutMOD：基于重建 BLE 指令开发的 QCY 耳机客户端",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "Android 8.0 to 16+ and a supported QCY earbud model using a Wuqi WQ7033 or WQ7034 chip.",
    "Building from source requires JDK 17 and Android SDK 36 with Build Tools 36.0.0 or newer.",
    "The author reports that firmware on the tested device did not respond to multipoint queries 0x4D and 0x4F.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 Android 8.0 至 16+，以及采用 Wuqi WQ7033 或 WQ7034 芯片的受支持 QCY 耳机。",
    "从源码构建需要 JDK 17、Android SDK 36 和 Build Tools 36.0.0 或更新版本。",
    "作者报告，测试设备的固件未响应多设备连接查询 0x4D 和 0x4F。",
    "采用 MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/MrSpy00/QCYbutMOD",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}
