Bring your Aiper pool cleaner and water quality monitor into Home Assistant.
View live status, battery, charging state, cleaning modes, consumables, and water chemistry (pH, ORP, Chlorine) alongside safe controls, directly in your smart home dashboard.
Warning
Unofficial & Cloud-Based This integration uses Aiper's cloud services (REST and AWS IoT MQTT). It is unofficial and not affiliated with Aiper. Because it relies on reverse-engineered cloud APIs, an update to the Aiper app or firmware could break functionality. Please read the Security & Privacy Guide before installing.
| Cleaners | Monitors |
|---|---|
| ✅ Scuba X1 | ✅ HydroComm |
| ✅ Surfer S2 | ✅ HydroComm Pro / W2 Series |
| ✅ Shark |
(Don't see your model? We need your help! Check our Diagnostics Guide for how to submit a payload.)
- In HACS, open Integrations.
- Open the three-dot menu and choose Custom repositories.
- Add
https://github.com/kmich/ha-aiperas an Integration repository. - Install Aiper Pool Cleaner and restart Home Assistant.
- Open Settings -> Devices & Services.
- Select Add Integration.
- Search for Aiper Pool Cleaner.
- Sign in with the Aiper account used by the mobile app.
The integration uses "capability profiles" to automatically expose only the features your device supports.
- Pool Cleaners: Live state, battery, cleaning mode controls, clean path preferences, Surfer S2 start/stop, and filter/brush consumable tracking.
- Water Quality Monitors: Live pH, ORP (mV), EC (µS/cm), TDS (ppm), Free Chlorine (mg/L), overall Water Quality Score, and bitmask-decoded alarm warnings.
- Device Actions: Safe buttons to force-refresh cloud metadata or re-sync the MQTT shadow state.
(Note: Diagnostic telemetry like raw voltages, currents, and lifetime cleaning hours are hidden by default to keep your dashboard clean. You can enable them manually in the entity registry.)
If you encounter issues, please read our guides before opening a ticket:
- Diagnostics & Troubleshooting Guide - Learn how to redact your logs safely.
- Security & Privacy Guide - What data leaves your network and how your credentials are used.
- Entity Taxonomy - Full list of exposed entities.
- Automation Examples - Copy/paste snippets for alerts and routines.
You can find copy-paste YAML for beautiful dashboards in our repository:
lovelace/example-dashboard.yaml(stock Lovelace)lovelace/mushroom-example.yaml(Mushroom cards)
To use the device headers, place an image (like docs/assets/scuba_x1.png) into config/www/aiper/ and reference it as /local/aiper/scuba_x1.png in your cards.