Case study

avea: controlling the Elgato Avea bulb through its BLE protocol

avea implements Python control of the Elgato Avea bulb using a BLE protocol investigated through an Android btsnoop log and Wireshark. Its documentation maps the control characteristic and color, brightness and name commands; the library discovers bulbs and reads or sets their state through Bleak.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-06
Evidence class: C2 code & docs, no demo or download

Stars: 9
Last commit: 2026-05-29
Language: Python
License (GitHub): MIT

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Observed: Code and documentation observed; no download method or demo found.
Checked: 2026-11-09

How evidence classes are assigned

Requirements & limits

Prerequisites: Python 3, Bleak, a working Bluetooth stack and an Elgato Avea bulb.
Prerequisites: Bluetooth discovery may require additional operating-system permissions.
Limits: Mood-based ambiance commands remain to be reverse engineered.
License: MIT licence.

Cite

BibTeX

@misc{avea-bulb-protocol-case,
  title = {{avea: controlling the Elgato Avea bulb through its BLE protocol}},
  howpublished = {\url{https://github.com/k0rventen/avea}},
  url = {https://github.com/k0rventen/avea},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/avea-bulb-protocol-case/}}
}

Plain text

avea: controlling the Elgato Avea bulb through its BLE protocol. https://github.com/k0rventen/avea (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/avea-bulb-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 · k0rventen/avea · Revision f2cd98c
LICENSE GitHub · k0rventen/avea · Revision f2cd98c