Home Assistant Integration
Water Meter Kit exposes its readings through ESPHome. The optional SmartHomeShop.io integration adds water-focused cards and calculated usage or leak insights.
Water Meter Kit Features
- current water use and accumulated consumption;
- history and flow trends;
- continuous-use and leak indicators where enough data is available;
- raw entities for custom notifications and dashboards.
Extra Entities Added by the Integration
The integration adds twelve calculated water entities:
| Entity | What it does |
|---|---|
Water cost today (CC) |
Multiplies today's water use by the active contract or configured water price. |
Usage vs 7-day average (CC) |
Compares today's use with the learned average day after the baseline is ready. |
Last water session (CC) |
Shows the litres used by the last completed water session; duration and end time are attributes. |
Current water usage (CC) |
Shows or calculates the current flow rate in L/min. |
Usage today (CC) |
Water consumed since the start of the day. |
Usage this week (CC) |
Water consumed since the start of the ISO week. |
Usage this month (CC) |
Water consumed since the start of the month. |
Usage this year (CC) |
Water consumed since the start of the year. |
Leak score (CC) |
Combines continuous flow, night use, microflow and learned pattern deviations into a 0-100 risk score. |
Leak detection confidence (CC) |
Shows how much learned history supports the current smart leak result. |
Baseline learning days (CC) |
Shows how many days have been included in the normal-use baseline. |
Continuous flow duration (CC) |
Shows how many minutes water has flowed without stopping. |
It also adds eight binary sensors intended for notifications and automations:
| Entity | Turns on when |
|---|---|
Smart leak detection (CC) |
The combined leak score reaches the configured threshold with sufficient confidence. |
Continuous flow leak (CC) |
Water keeps flowing beyond the configured duration. |
Night usage (CC) |
Unexpected water use occurs during the configured night window. |
Micro leak (CC) |
A small flow continues long enough to resemble a dripping tap or small leak. |
Vacation leak (CC) |
Water flows while the configured vacation-mode entity is on. |
Water flowing (CC) |
The current flow is greater than 0.1 L/min. |
Leak alarm (CC) |
Any smart, continuous, night, micro or vacation leak condition is active. |
Baseline learned (CC) |
The configured minimum learning period has been completed. |
Daily, weekly, monthly and yearly Utility Meter helpers add four more period totals. See the complete WaterMeterKit entity reference for units, attributes, calculations and reliability notes.
Install the integration, select WaterMeterKit and choose the matching ESPHome device. The complete Home Assistant Integration guide explains installation, cards, entities and troubleshooting.
Check the installation instructions and Sensor Definitions when totals differ from the physical meter.