# AstralPool Halo Cloud: reconstructing chlorinator cloud control

> AstralPool Halo Cloud reconstructs cloud control of Halo chlorinators as a Home Assistant integration. BLE onboarding retrieves device-generated credentials, after which a client uses the vendor WebSocket relay and parsed device messages for telemetry and control. The security notes document authentication values extracted from the official app binary.

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

## Requirements & limits

- **Prerequisites:** Home Assistant, a Halo chlorinator and access to the vendor cloud; BLE is used for onboarding.
- **Limits:** The pre-release has been tested on one controller firmware version, pbver 2.3; several writes remain experimental.
- **License:** MIT.

## Primary sources

1. <https://github.com/robmarkoski/pychlorinator-cloud/blob/fe954676c5d275352e30dd996426dc408ad98da9/README.md>
2. <https://github.com/robmarkoski/pychlorinator-cloud/blob/fe954676c5d275352e30dd996426dc408ad98da9/SECURITY.md>

## More in Protocols

- [zen-go-tui: reconstructing Zen Go USB HID controls](https://awesomerea.org/resources/zen-go-tui-case/index.md) · Case study
- [tinyscreen: reconstructing an ArtInChip USB display protocol](https://awesomerea.org/resources/tinyscreen-artinchip-case/index.md) · Case study
- [Panavox PSS-12 INV: reconstructing air-conditioner UART control](https://awesomerea.org/resources/panavox-pss12-inv-protocol-case/index.md) · Case study
- [WB-SG1-8G: reconstructing a signal generator's serial commands](https://awesomerea.org/resources/wbsg1-case/index.md) · Case study
- [Brother HL-4150CDN: reconstructing the XL2HB print stream](https://awesomerea.org/resources/brother-hl4150cdn-driver-case/index.md) · Case study
- [monclub-bot: reconstructing MonClub booking requests](https://awesomerea.org/resources/monclub-bot-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.