A custom Home Assistant integration to track your water consumption via the HomeWizard Cloud, designed specifically for their battery-powered watermeter devices.
Important
TL;DR: Do you need this?
- ⚡ Don't have a Watermeter? This is only for the Watermeter. Other HomeWizard devices work perfectly with the official integration.
- 🔋 Running on Battery? Yes, you need this integration.
- 🔌 Running on USB? No, stop here! Use the official HomeWizard Energy integration for real-time local data.
The official HomeWizard Energy integration is amazing but has a limitation: it requires the Local API, which is disabled when the Watermeter runs on batteries.
This integration bridges the gap:
- ✅ Fetches data from the HomeWizard Cloud.
- ✅ Perfect for battery-powered setups (4 updates/day).
- ✅ High-resolution historical data (5-min intervals) injected into Long Term Statistics.
- ✅ Full Energy Dashboard support.
- Device Support: Automatically discovers all watermeter devices linked to your account.
- Smart Tracking: High-resolution consumption data (not just daily totals).
- Diagnostics: Monitor Online status and Wi-Fi signal strength.
- Energy Dashboard: Native integration with the Home Assistant Energy panel.
- Auto-Sync: Fetches the last 48h of data to ensure no drops, even if your Wi-Fi is flaky.
The recommended way to install this integration is through the Home Assistant Community Store (HACS).
- Open HACS > Integrations.
- Search for
HomeWizard Cloud Watermeterand install the integration. - Restart Home Assistant.
Copy the custom_components/homewizard_cloud_watermeter folder into your config/custom_components directory, then restart Home Assistant.
- Go to Settings > Devices & Services.
- Click Add Integration and search for
HomeWizard Cloud Watermeter. - Log in with your HomeWizard credentials.
- Energy Dashboard: In the Water consumption section, search for "homewizard" entities and select the one corresponding to your device.
| Sensor | Enabled by default | Description |
|---|---|---|
| Total Usage | true | Water usage history (L) |
| Last Device Sync | true | Last time the device pushed its data to the cloud |
| Wi-Fi Signal | false | Wifi signal strength (%) |
| Online State | false | Whether the device was online recently or not |
- Found a bug? Please open an Issue.
- Want to contribute? Pull Requests are welcome!
- Official Recognition: While this is a community project, HomeWizard is aware of this integration and won't block it (see Issue #2).
This is an unofficial community-driven integration. It is not affiliated with, authorized, or endorsed by HomeWizard.
