# divoom-protocol: reconstructed BLE control for Divoom displays

> divoom-protocol implements a Python BLE client for Divoom Backpack M and TimeBox-Evo-audio displays using reconstructed framing and command sequences. Its documentation covers session initialization, brightness, channel switching, image frames and animation upload, and identifies commands that remain undecoded.

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

## Requirements & limits

- **Prerequisites:** Requires Python 3.10 or newer and a compatible BLE display.
- **Testing evidence:** Hardware testing covers Backpack M and TimeBox-Evo-audio only.
- **Limits:** The author reports that uploaded animations render immediately; persistence to a Custom slot has not been verified.
- **License:** MIT License.

## Primary sources

1. <https://github.com/orionparrott/divoom-protocol/blob/f9b661f8e06a6d40be91c800fed656c7402bd2ac/README.md>

## More in Protocols

- [hestia: replacing the Keemple smart-home cloud](https://awesomerea.org/resources/hestia-keemple-case/index.md) · Case study
- [gigabyte-gpu-lcd: reconstructing AORUS GPU LCD control](https://awesomerea.org/resources/gigabyte-gpu-lcd-case/index.md) · Case study
- [Ricoh SP 200 Linux CUPS Driver: reconstructing the printer's USB print protocol](https://awesomerea.org/resources/ricoh-sp200-linux-case/index.md) · Case study
- [HyperX QuadCast 2 S: reconstructing RGB control on macOS](https://awesomerea.org/resources/hyperx-quadcast-2s-rgb-case/index.md) · Case study
- [whoop4-ble: reconstructing Whoop 4.0 sensor data access](https://awesomerea.org/resources/whoop4-ble-case/index.md) · Case study
- [MSI Mystic Light RGB Web Control Panel: reconstructing B760M-A lighting control](https://awesomerea.org/resources/msi-mystic-light-web-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.