# week-aqua-ble: reconstructing Week Aqua light control over BLE

> week-aqua-ble reconstructs the Week Aqua P1200 Pro aquarium light's BLE commands by decompiling the Android app and recording its writes to a simulated light. ESPHome configurations use the recovered messages for channel brightness, fan, clock and schedule control through Home Assistant.

- 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/stephenlwaldron/week-aqua-ble>
- Primary source: <https://github.com/stephenlwaldron/week-aqua-ble/blob/8cd50a8ddef895eccd4795d03e655bc82a4dcff5/PROTOCOL.md>
- Catalog page: <https://awesomerea.org/resources/week-aqua-ble-case/>
- Record JSON: <https://awesomerea.org/resources/week-aqua-ble-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/week-aqua-ble-case/index.md)

## Requirements & limits

- **Prerequisites:** An ESP32, ESPHome, Home Assistant and a Week Aqua light are needed for the documented setup.
- **Testing evidence:** Only the P1200 Pro is reported as tested; other model families are untested.
- **License:** MIT license.

## Primary sources

1. <https://github.com/stephenlwaldron/week-aqua-ble/blob/8cd50a8ddef895eccd4795d03e655bc82a4dcff5/PROTOCOL.md>
2. <https://github.com/stephenlwaldron/week-aqua-ble/blob/8cd50a8ddef895eccd4795d03e655bc82a4dcff5/README.md>

## More in Protocols

- [etnga-obd: mapping Toyota eTNGA vehicle diagnostics](https://awesomerea.org/resources/etnga-obd-case/index.md) · Case study
- [DMR-39 Remote Bridge: reconstructing set-top-box remote control](https://awesomerea.org/resources/dmr39-case/index.md) · Case study
- [open-drong-display: reconstructing Drong Display USB control](https://awesomerea.org/resources/open-drong-display-case/index.md) · Case study
- [INNO X2 for macOS: reconstructing mouse control over HID](https://awesomerea.org/resources/innox2-mac-case/index.md) · Case study
- [pro2-linux: reconstructing Logitech PRO 2 LIGHTSPEED control on Linux](https://awesomerea.org/resources/pro2-linux-case/index.md) · Case study
- [beam-revival: local Beam+ control from motor protocol research](https://awesomerea.org/resources/beam-revival-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.