# BA-KEY Menu: reconstructing Basike keyboard HID control

> Reconstructs the Basike BA-KEY308 keyboard's HID configuration protocol from the vendor's Windows app and implements it in a macOS menu-bar app and CLI. The protocol notes cover Feature reports, command classes and Bluetooth, USB and 2.4 GHz receiver transport. The app controls lighting, per-key colors and profiles.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-08
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/ThePaladini/ba-key308-macos>
- Primary source: <https://github.com/ThePaladini/ba-key308-macos/blob/b3d9e1f7e2ee3286b34cdf47a8b49ab4f54c087b/README.md>
- Catalog page: <https://awesomerea.org/resources/ba-key-menu-protocol-case/>
- Record JSON: <https://awesomerea.org/resources/ba-key-menu-protocol-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/ba-key-menu-protocol-case/index.md)

## Requirements & limits

- **Prerequisites:** macOS 13 or newer is required; source builds use Swift 5.9 or newer.
- **Limits:** Basike BA-KEY308 was tested over Bluetooth and USB; Dareu EK75 and Husky Nomadic support is experimental.
- **License:** MIT license.

## Primary sources

1. <https://github.com/ThePaladini/ba-key308-macos/blob/b3d9e1f7e2ee3286b34cdf47a8b49ab4f54c087b/README.md>
2. <https://github.com/ThePaladini/ba-key308-macos/blob/b3d9e1f7e2ee3286b34cdf47a8b49ab4f54c087b/docs/PROTOCOL.md>

## More in Protocols

- [KC Control: Keychron M6 profile switching over a recovered HID protocol](https://awesomerea.org/resources/kc-control-case/index.md) · Case study
- [Xiaomi Whale Spout bidet: reconstructing its RF remote protocol](https://awesomerea.org/resources/whale-spout-bidet-protocol-case/index.md) · Case study
- [skypsu: reconstructing the STP2S3010E22 Modbus register map](https://awesomerea.org/resources/skypsu-case/index.md) · Case study
- [Smart-AC-Modernizer: decoding Haier YRW02 infrared control](https://awesomerea.org/resources/smart-ac-modernizer-case/index.md) · Case study
- [pyidotmatrix: researching and implementing iDotMatrix BLE control](https://awesomerea.org/resources/pyidotmatrix-protocol-case/index.md) · Case study
- [Skannerz Commander: reconstructing the toy's trade protocol](https://awesomerea.org/resources/skannerz-commander-trade-protocol-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.