# KBM TG700 Control: Linux keyboard settings from USB protocol analysis

> KBM TG700 Control reconstructs the USB HID settings protocol of KBM! GAMING TG600 and TG700 keyboards from analysis of their Windows software. Its Linux GTK4 app sets lighting, macros and key mappings through hidraw, and the protocol document records report fields and command codes. Hardware testing is reported for the TG700.

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

## Requirements & limits

- **Prerequisites:** Linux, Python 3.10 or later, PyGObject, GTK 4 and libadwaita 1.4 or later.
- **Limits:** TG600 and TG600W layouts are included but have not been tested on hardware; Fn-layer editing is unfinished.
- **License:** MIT license.

## Primary sources

1. <https://github.com/JorgesOS7/kbm-tg700/blob/d4abf5029b9fe34b87dceadabd21600102e4fac2/docs/PROTOCOL.md>
2. <https://github.com/JorgesOS7/kbm-tg700/blob/d4abf5029b9fe34b87dceadabd21600102e4fac2/README.md>

## More in Protocols

- [ssmouse: a client for the Rival 3 Wireless HID protocol](https://awesomerea.org/resources/ssmouse-case/index.md) · Case study
- [KuKirin G2 Master: decoding the display-controller UART protocol](https://awesomerea.org/resources/kukirin-g2-master-uart-case/index.md) · Case study
- [RJ Connect: Ruijie campus authentication protocol research](https://awesomerea.org/resources/rj-connect-case/index.md) · Case study
- [aula-hero68-protocol: reconstructing AULA HERO 68 HE RGB control](https://awesomerea.org/resources/aula-hero68-protocol-case/index.md) · Case study
- [MCHOSE V9 Turbo+: reconstructing headset RGB control](https://awesomerea.org/resources/mchose-v9-protocol-case/index.md) · Case study
- [sindri-led: reconstructing K671 Sindri lighting control](https://awesomerea.org/resources/sindri-led-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.