# TOZO Control: a Linux earbuds client built from the TOZO BLE protocol

> 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.

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

## Requirements & limits

- **Prerequisites:** Linux with GTK4, libadwaita, BlueZ and the Python bleak package; a compatible TOZO BLE earbud is needed.
- **Limits:** Only TOZO T10 is reported as tested; command support varies by model.
- **License:** MIT License.

## Primary sources

1. <https://github.com/GabriWar/tozo-control/blob/eb40bdf22203078aa635e8c61d960538f679cfab/README.md>

## More in Protocols

- [BMS RS485 Service Suite: reconstructing a battery-service bus protocol](https://awesomerea.org/resources/bms-rs485-service-suite-case/index.md) · Case study
- [Petkit Local: reconstructing feeder cloud and fountain BLE controls](https://awesomerea.org/resources/petkit-local-case/index.md) · Case study
- [IPI STAY FLY Driver: reconstructing mouse configuration over HID](https://awesomerea.org/resources/ipi-stay-fly-driver-case/index.md) · Case study
- [Soundcore D3200: reconstructing BLE recording transfer and decryption](https://awesomerea.org/resources/soundcore-d3200-ble-case/index.md) · Case study
- [K1 Pro OpenDeck Suite: a Linux driver for the Stream Dock K1 Pro](https://awesomerea.org/resources/k1-pro-opendeck-suite-case/index.md) · Case study
- [iDotMatrix: Home Assistant control through a reconstructed BLE protocol](https://awesomerea.org/resources/idotmatrix-ha-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.