{
  "added_at": "2026-11-09",
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "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.",
  "description_zh": "PythonWifiBulb 根据手机与 MagicLight Wi-Fi 灯泡之间抓取的流量还原控制命令。Python 类通过 TCP 发送 RGB 和暖白光命令，文档记录了 5577 端口、消息字节和校验和处理方法。",
  "entry_url": "https://awesomerea.org/resources/pythonwifibulb-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/pythonwifibulb-case/",
  "evidence_url": "https://github.com/Chris-Johnston/PythonWifiBulb/blob/7716d37fedb4f7c48c454f95d1ad703ab15edf19/README.md",
  "group": "cases",
  "id": "pythonwifibulb-case",
  "json_url": "https://awesomerea.org/resources/pythonwifibulb-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/pythonwifibulb-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/pythonwifibulb-case/index.md",
  "name": "PythonWifiBulb: reconstructing MagicLight bulb commands",
  "name_zh": "PythonWifiBulb：还原 MagicLight 灯泡控制命令",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "scope",
    "license"
  ],
  "requirements": [
    "A MagicLight Wi-Fi bulb must be configured on the local network and its IP address obtained.",
    "The author used two bulb versions identified as v5 and v7.",
    "Licensed under MIT."
  ],
  "requirements_zh": [
    "需先将 MagicLight Wi-Fi 灯泡接入局域网并获取其 IP 地址。",
    "作者使用过标为 v5 和 v7 的两种灯泡。",
    "采用 MIT 许可证。"
  ],
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/Chris-Johnston/PythonWifiBulb",
  "verification": "source-reviewed",
  "verified_at": "2026-11-08"
}
