# HappyLighting-py: reconstructing LED-controller BLE communication

> HappyLighting-py reconstructs BLE communication for HappyLighting-compatible LED controllers from analysis of the original APK. Its Python app changes color, mode and speed, enables the integrated microphone and drives color from screen input.

- 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/MikeCoder96/HappyLighting-py>
- Primary source: <https://github.com/MikeCoder96/HappyLighting-py/blob/82fdd49742486d27410fad2b526853c849d07207/README.md>
- Catalog page: <https://awesomerea.org/resources/happylighting-py-case/>
- Record JSON: <https://awesomerea.org/resources/happylighting-py-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/happylighting-py-case/index.md)

## Requirements & limits

- **Prerequisites:** Python and the dependencies in LEDStripController/requirements.txt.
- **Prerequisites:** Linux may additionally need libasound-dev and portaudio19-dev.
- **Limits:** Custom mode and independent device-group control remain unimplemented.
- **License:** AGPL-3.0 License.

## Primary sources

1. <https://github.com/MikeCoder96/HappyLighting-py/blob/82fdd49742486d27410fad2b526853c849d07207/README.md>

## More in Protocols

- [pd-usb: reconstructing Playdate USB commands](https://awesomerea.org/resources/pd-usb-case/index.md) · Case study
- [GlanceClock: reconstructing its BLE command protocol](https://awesomerea.org/resources/glance-clock-ble-case/index.md) · Case study
- [prolink-connect: implementing Pioneer PROLINK exchanges](https://awesomerea.org/resources/prolink-connect-case/index.md) · Case study
- [Open Remote Start: reconstructing the Fortin antenna data-link](https://awesomerea.org/resources/open-remote-start-case/index.md) · Case study
- [PythonWifiBulb: reconstructing MagicLight bulb commands](https://awesomerea.org/resources/pythonwifibulb-case/index.md) · Case study
- [Laser Drift: reconstructing Carrera infrared slot-car control](https://awesomerea.org/resources/laser-drift-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.