# Nuga library: reconstructing NuPhy BYK916 keyboard control

> Nuga library implements Go control of BYK916 NuPhy keyboards through a reconstructed USB HID protocol. It reads and sets lighting effects and brightness, while its protocol notes map HID reports, response fields and custom per-key backlight colors.

- 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/mishamyrt/nuga-lib>
- Primary source: <https://github.com/mishamyrt/nuga-lib/blob/497e8eda7ce997d77e0b926094c1ff6a02feae07/README.md>
- Catalog page: <https://awesomerea.org/resources/nuga-lib-case/>
- Record JSON: <https://awesomerea.org/resources/nuga-lib-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/nuga-lib-case/index.md)

## Requirements & limits

- **Prerequisites:** A BYK916 NuPhy keyboard and USB HID access.
- **Prerequisites:** Go 1.20 or later for the module.
- **License:** MIT license.

## Primary sources

1. <https://github.com/mishamyrt/nuga-lib/blob/497e8eda7ce997d77e0b926094c1ff6a02feae07/README.md>
2. <https://github.com/mishamyrt/nuga-lib/blob/497e8eda7ce997d77e0b926094c1ff6a02feae07/docs/protocol.md>

## More in Protocols

- [Razer Nari Battery Level: recovering a USB battery-voltage exchange](https://awesomerea.org/resources/razer-nari-battery-level-case/index.md) · Case study
- [Pix Backpack Go: reconstructing PIX display control over BLE](https://awesomerea.org/resources/pix-backpack-go-case/index.md) · Case study
- [VFS495 fingerprint reader on Linux: reconstructing capture and login](https://awesomerea.org/resources/vfs495-linux-case/index.md) · Case study
- [VTech VM901: reconstructing camera authentication and media access](https://awesomerea.org/resources/vtech-vm901-home-assistant-case/index.md) · Case study
- [KATASYMBOL E12 Lab: reconstructing BLE label printing](https://awesomerea.org/resources/katasymbol-e12-lab-case/index.md) · Case study
- [GE Opal 2: ice maker hardware and I2C interface research](https://awesomerea.org/resources/ge-opal-2-research-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.