{
  "added_at": "2026-11-06",
  "category": "reconstruction-cases",
  "description_en": "TOZO Control provides a Linux GTK4 client for TOZO earbuds using a BLE GATT protocol recovered from the vendor's Android app. It sends commands to characteristic B611, receives notifications on B612, and documents GET and SET packet layouts and parameter IDs. The author reports testing the T10 model for battery, game mode, equalizer and balance controls.",
  "description_zh": "TOZO Control 是 Linux GTK4 耳机客户端，使用从 TOZO Android 应用逆向得到的 BLE GATT 协议。它向 B611 特征写入命令，从 B612 接收通知，并记录 GET、SET 数据包结构及参数编号。作者报告已在 T10 上测试电量、游戏模式、均衡器和声道平衡功能。",
  "entry_url": "https://awesomerea.org/resources/tozo-control-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/tozo-control-case/",
  "evidence_url": "https://github.com/GabriWar/tozo-control/blob/eb40bdf22203078aa635e8c61d960538f679cfab/README.md",
  "group": "cases",
  "id": "tozo-control-case",
  "json_url": "https://awesomerea.org/resources/tozo-control-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/tozo-control-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/tozo-control-case/index.md",
  "name": "TOZO Control: a Linux earbuds client built from the TOZO BLE protocol",
  "name_zh": "TOZO Control：基于 TOZO BLE 协议的 Linux 耳机客户端",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "Linux with GTK4, libadwaita, BlueZ and the Python bleak package; a compatible TOZO BLE earbud is needed.",
    "Only TOZO T10 is reported as tested; command support varies by model.",
    "MIT License."
  ],
  "requirements_zh": [
    "需要安装 GTK4、libadwaita、BlueZ 和 Python bleak 的 Linux，以及兼容的 TOZO BLE 耳机。",
    "作者仅报告测试了 TOZO T10；不同型号支持的命令有所差异。",
    "MIT 许可证。"
  ],
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/GabriWar/tozo-control",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}