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 S1 (2025/2026) | ✅ HydroComm |
| ✅ Scuba X1 | ✅ HydroComm Pro / W2 Series |
| ✅ Surfer S2 | |
| ✅ Shark | |
| 🧪 Scuba P1 Pro | |
| 🧪 Scuba V3 |
The current 2026 retail Scuba S1 identifies itself through Aiper's cloud as
Scuba_S1_2025; both names refer to the verified model listed above.
🧪 Scuba P1 Pro support is onboarded from a community diagnostics bundle
(no temp field; Roller Brush and MicroMesh Filter consumables) and has not
been verified on hardware by the maintainer. Reports welcome.
🧪 Scuba V3 support is onboarded from community reports (issues #38, #49):
machineStatus 2/3 map to Charging/Charged as on the S3, and the
water-temperature entity is dropped. The cleaning-mode options are still the
generic Scuba set; the V3's real mode command IDs have not been captured yet.
(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.
- Cloud Connection Health: A dedicated "Aiper Cloud" device with
binary_sensor.aiper_cloud_cloud_connected, aConnection Statesensor, and aLast Cloud Updatetimestamp — so an automation can alert you when the integration loses its cloud/MQTT link. - Device Actions: Safe buttons to force-refresh cloud metadata or re-sync the MQTT shadow state.
- Guided Recovery: Home Assistant Repairs entries appear when a device model is not recognized (with a link to the onboarding guide) or when your stored credentials stop working (starts re-authentication).
(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.
ha-aiper-card is a companion set of Lovelace cards built for this integration:
- Aiper Cleaner Card – status, battery, connectivity, warnings, cleaning-mode and clean-path chips, start/stop, consumable wear.
- Aiper Water Quality Card – water-quality score, pH / ORP / chlorine / TDS / EC gauges, temperature and sample age.
Install it via HACS as a Dashboard custom repository
(https://github.com/kmich/ha-aiper-card). Point a card at your Aiper device and
it wires up the entities itself.
If you prefer stock cards, copy-paste YAML lives in this 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.