# 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.

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

## 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.

## Primary sources

1. <https://github.com/k0rventen/avea/blob/f2cd98c20821d12069d4ff6cca970c29bf7da993/README.md>
2. <https://github.com/k0rventen/avea/blob/f2cd98c20821d12069d4ff6cca970c29bf7da993/LICENSE>

## More in Protocols

- [Cetus3D: reconstructing printer status messages](https://awesomerea.org/resources/cetus3d-status-case/index.md) · Case study
- [LILO: reconstructing BLE control for the Prêt à Pousser LILO](https://awesomerea.org/resources/lilo-case/index.md) · Case study
- [helix: investigating DNA 75 USB HID control](https://awesomerea.org/resources/helix-dna75-case/index.md) · Case study
- [Ha-Kake: decoding Nissan Leaf CAN signals for a telemetry dashboard](https://awesomerea.org/resources/ha-kake-leaf-can-case/index.md) · Case study
- [Ökoboiler: decoding the water heater's internal UART bus](https://awesomerea.org/resources/oekoboiler-uart-case/index.md) · Case study
- [Ritto 7630: reconstructing intercom bell and door signals](https://awesomerea.org/resources/ritto-esp-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.