# vclights: reconstructing VC-BLELIGHT lamp commands

> vclights reconstructs VC-BLELIGHT lamp control from the Raingel Android app's BLE commands. Its Python client sets power, brightness, color and firmware modes, while protocol notes identify GATT services, write characteristics and opcode payloads; camera-based observations document device responses and color limits.

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

## Requirements & limits

- **Prerequisites:** A VC-BLELIGHT lamp, Bluetooth access and the Python dependencies in requirements.txt.
- **Limits:** Intermediate RGB colors are unreliable on the tested strips; BLE writes have no acknowledgement.
- **License:** MIT.

## Primary sources

1. <https://github.com/agustinprod/vclights/blob/5d37a7a33d3f5a785bb80a30a1288070684a6add/README.md>
2. <https://github.com/agustinprod/vclights/blob/5d37a7a33d3f5a785bb80a30a1288070684a6add/docs/protocol.md>

## More in Apps

- [ilo2ctl: rebuilding the HP iLO 2 remote console and controls](https://awesomerea.org/resources/ilo2ctl-case/index.md) · Case study
- [gpcli: reconstructing MyGP subscriber app API flows](https://awesomerea.org/resources/gpcli-case/index.md) · Case study
- [Atmoph Window 2 Remote: reconstructing local BLE control](https://awesomerea.org/resources/atmoph-window-2-remote-case/index.md) · Case study
- [Antigravity session interoperability: reconstructing the CLI session format](https://awesomerea.org/resources/antigravity-session-interoperability-case/index.md) · Case study
- [MIRO SmartHome: reconstructing app API control in Home Assistant](https://awesomerea.org/resources/miro-smarthome-ha-case/index.md) · Case study
- [ScanStudio: reconstructing a Nikon LS-5000 scanning workflow](https://awesomerea.org/resources/scanstudio-nikon-coolscan-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.