Case study

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.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-08

Stars: 0
Last commit: 2026-10-25
Language: Swift
License (GitHub): MIT

GitHub data as of 2026-11-09

Copy as Markdown View JSON Cite

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.

Cite

BibTeX

@misc{ba-key-menu-protocol-case,
  title = {{BA-KEY Menu: reconstructing Basike keyboard HID control}},
  howpublished = {\url{https://github.com/ThePaladini/ba-key308-macos}},
  url = {https://github.com/ThePaladini/ba-key308-macos},
  urldate = {2026-11-08},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/ba-key-menu-protocol-case/}}
}

Plain text

BA-KEY Menu: reconstructing Basike keyboard HID control. https://github.com/ThePaladini/ba-key308-macos (accessed 2026-11-08). Awesome REA entry: https://awesomerea.org/resources/ba-key-menu-protocol-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

README.md GitHub · ThePaladini/ba-key308-macos · Revision b3d9e1f
docs/PROTOCOL.md GitHub · ThePaladini/ba-key308-macos · Revision b3d9e1f