# SP656E CLI: a BanlanX Bluetooth lighting client

> SP656E CLI implements a Bluetooth Low Energy client for SP656E and SP638E lighting controllers using the documented BanlanX 0x53 command format. Its Python interface scans devices, reads status and sends power, color, brightness, effect and raw commands; the protocol basis is credited to earlier community research.

- Type: Case study
- Targets: 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/TadejPolajnar/sp656e-cli>
- Primary source: <https://github.com/TadejPolajnar/sp656e-cli/blob/24d4fbfdddd4b884eef6334cc3eee5e900068962/README.md>
- Catalog page: <https://awesomerea.org/resources/sp656e-cli-case/>
- Record JSON: <https://awesomerea.org/resources/sp656e-cli-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/sp656e-cli-case/index.md)

## Requirements & limits

- **Prerequisites:** Python 3.9+, macOS with Bluetooth and the bleak library are required.
- **Prerequisites:** The BanlanX app must be disconnected because only one BLE connection is allowed at a time.
- **License:** No licence file in the repository.

## Primary sources

1. <https://github.com/TadejPolajnar/sp656e-cli/blob/24d4fbfdddd4b884eef6334cc3eee5e900068962/README.md>

## More in Protocols

- [Navico GoFree: screen-mirroring protocol findings](https://awesomerea.org/resources/navico-gofree-protocol-case/index.md) · Case study
- [Claude Code inbox socket: documenting session messages and delivery](https://awesomerea.org/resources/claude-code-inbox-socket-case/index.md) · Case study
- [Fujitsu FGL Type A Bus Protocol: decoding an air-conditioner wired remote](https://awesomerea.org/resources/fujitsu-fgl-type-a-bus-case/index.md) · Case study
- [UniFi Protect: reconstructing siren and AI Horn audio control](https://awesomerea.org/resources/unifi-protect-audio-control-case/index.md) · Case study
- [sr16-bridge: reconstructing SR16 smart-ring BLE history sync](https://awesomerea.org/resources/sr16-bridge-case/index.md) · Case study
- [alpha1s: reconstructing UBTECH Alpha 1S Bluetooth control](https://awesomerea.org/resources/alpha1s-sdk-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.