# PythonWifiBulb: reconstructing MagicLight bulb commands

> PythonWifiBulb reconstructs MagicLight Wi-Fi bulb control from captured phone-to-bulb traffic. The Python class sends RGB and warm-white commands over TCP, while its notes describe port 5577, message bytes and a checksum helper.

- 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/Chris-Johnston/PythonWifiBulb>
- Primary source: <https://github.com/Chris-Johnston/PythonWifiBulb/blob/7716d37fedb4f7c48c454f95d1ad703ab15edf19/README.md>
- Catalog page: <https://awesomerea.org/resources/pythonwifibulb-case/>
- Record JSON: <https://awesomerea.org/resources/pythonwifibulb-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/pythonwifibulb-case/index.md)

## Requirements & limits

- **Prerequisites:** A MagicLight Wi-Fi bulb must be configured on the local network and its IP address obtained.
- **Scope:** The author used two bulb versions identified as v5 and v7.
- **License:** Licensed under MIT.

## Primary sources

1. <https://github.com/Chris-Johnston/PythonWifiBulb/blob/7716d37fedb4f7c48c454f95d1ad703ab15edf19/README.md>

## More in Protocols

- [Laser Drift: reconstructing Carrera infrared slot-car control](https://awesomerea.org/resources/laser-drift-case/index.md) · Case study
- [mx3000control: reconstructing Perixx MX-3000 HID settings](https://awesomerea.org/resources/mx3000control-case/index.md) · Case study
- [jeep-canbus: decoding the Jeep Grand Cherokee CAN-B bus](https://awesomerea.org/resources/jeep-canbus-case/index.md) · Case study
- [Samsung Galaxy Book4 Edge: reconstructing EC communication for Linux](https://awesomerea.org/resources/galaxy-book4-edge-ec-case/index.md) · Case study
- [Bose-Reverse-Engineering: investigating the 321GS Series III SmartSpeaker link](https://awesomerea.org/resources/bose-321gs-smartspeaker-case/index.md) · Case study
- [Pioneer DJM-850: mapping mixer control and audio over USB](https://awesomerea.org/resources/pioneer-djm-850-usb-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.