Case study

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.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-06
Evidence class: C2 code & docs, no demo or download

Stars: 0
Last commit: 2026-11-01
License (GitHub): MIT

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Observed: Code and documentation observed; no download method or demo found.
Checked: 2026-11-08

How evidence classes are assigned

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.

Cite

BibTeX

@misc{week-aqua-ble-case,
  title = {{week-aqua-ble: reconstructing Week Aqua light control over BLE}},
  howpublished = {\url{https://github.com/stephenlwaldron/week-aqua-ble}},
  url = {https://github.com/stephenlwaldron/week-aqua-ble},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/week-aqua-ble-case/}}
}

Plain text

week-aqua-ble: reconstructing Week Aqua light control over BLE. https://github.com/stephenlwaldron/week-aqua-ble (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/week-aqua-ble-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

PROTOCOL.md GitHub · stephenlwaldron/week-aqua-ble · Revision 8cd50a8
README.md GitHub · stephenlwaldron/week-aqua-ble · Revision 8cd50a8