--- title: "Water Monitor" description: "Water Monitor is a Marketplace integration for Home Assistant. It has 126 installs sharing analytics, works locally and was last updated October 6, 2026." canonical: "https://vulpo.app/integrations/marketplace/markaggar-water-monitor" url: "https://vulpo.app/integrations/marketplace/markaggar-water-monitor.md" last-updated: "2026-10-22" version: "1.4" --- # Water Monitor > Water Monitor is a Marketplace integration for Home Assistant. It has 126 installs sharing analytics, works locally and was last updated October 6, 2026. Water Monitor is a Home Assistant integration that tracks water usage sessions from an existing flow sensor and detects leaks. It requires only a flow sensor, while a volume sensor, a hot water binary sensor and a shutoff valve are optional. It adds session sensors for volume, duration, average flow and hot water percentage, with gap handling so one use is not split into several sessions. Two optional leak detectors are included: one looks for a continuous low-flow dribble, the other for repeated, similar-sized tank refills. Each detector can turn off a linked shutoff valve, and the leak sensors stay set while the valve is off. It works locally, is configured in the UI, supports multiple instances, and includes a number for injecting synthetic flow during testing. Automatic summary of the README and code of markaggar/Water-Monitor. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=markaggar&repository=Water-Monitor&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=markaggar&repository=Water-Monitor&category=integration) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Set up Water Monitor - **Sensor name prefix** - **Flow sensor** - **Volume sensor (optional)** - **Hot water binary sensor (optional)** - **Water shutoff valve (optional)** - **Clear water shutoff valve** - **Clear volume sensor** - **Clear hot water sensor** - **Integration method (when no volume sensor specified)**: Only used when computing volume from the flow sensor. Trapezoidal (recommended) gives better accuracy on changing flow. Left matches external counters that tick once per update. - **Minimum session volume** - **Minimum session duration (seconds)** - **Gap tolerance (seconds)** - **Treat baseline threshold as zero for session end** - **Baseline idle to close session (seconds)** - **Enable Synthetic Flow (testing)** ### Synthetic Flow - **Include synthetic flow in detectors** - **Include synthetic in daily analysis** ### Intelligent Leak Detection - **Occupancy mode input\_select (optional)** - **Away states (comma-separated, optional)** - **Vacation states (comma-separated, optional)** - **Enable learning mode** - **Suppress detection during learning period** - **Minimum learning days before detection** ### Tank refill leak detection - **Minimum refill volume**: Ignore refills smaller than this. - **Maximum refill volume (0 = disabled)**: Ignore refills larger than this (0 disables the cap). - **Similarity tolerance (%)**: How similar volumes must be to be counted together. - **Repeat count to trigger**: Number of similar refills within the window required to trigger. - **Maximum hot water percentage (%)**: Sessions with hot water percentage above this will be ignored. - **Window to count repeats (seconds)**: Time window to collect refills for comparison. - **Auto-clear after idle (seconds)**: Time without matching refills before the alert clears. - **Cooldown after clear (seconds)**: Suppress re-triggering for this long after clearing. - **Minimum refill duration (seconds, 0 = disabled)**: Ignore refills shorter than this (0 disables the guard). - **Maximum refill duration (seconds, 0 = disabled)**: Ignore refills longer than this (0 disables the guard). - **Turn off shutoff valve when leak is detected** ### Low-flow leak detection - **Max low-flow rate** - **Seed low-flow duration (seconds)** - **Minimum duration to trigger (seconds)** - **Clear after idle (seconds at zero flow)** - **Counting mode**: Choose how time is accumulated during low-flow: - Any non-zero flow (wall clock): counts all time while flow \> 0 - Only time within low-flow range: counts only while 0 \< flow ≤ max low-flow - Baseline latch: once seeded, latches a baseline and counts while flow stays near baseline; margin controls the allowed band - **Smoothing window (seconds)** - **Cooldown after clear (seconds)** - **Clear after sustained high flow (seconds, optional)** - **Baseline margin (%)** - **Turn off shutoff valve when leak is detected** ### After setup - **Sensor name prefix** - **Flow sensor** - **Volume sensor (optional)** - **Hot water binary sensor (optional)** - **Water shutoff valve (optional)** - **Clear water shutoff valve** - **Clear volume sensor** - **Clear hot water sensor** - **Integration method (when no volume sensor specified)**: Only used when computing volume from the flow sensor. Trapezoidal (recommended) gives better accuracy on changing flow. Left matches external counters that tick once per update. - **Minimum session volume** - **Minimum session duration (seconds)** - **Gap tolerance (seconds)** - **Treat baseline threshold as zero for session end** - **Baseline idle to close session (seconds)** - **Enable Synthetic Flow (testing)** - **Include synthetic flow in detectors** - **Include synthetic in daily analysis** - **Occupancy mode input\_select (optional)** - **Away states (comma-separated, optional)** - **Vacation states (comma-separated, optional)** - **Enable learning mode** - **Suppress notifications during learning period** - **Minimum learning days before notifications** - **Suppress high usage notifications** - **Turn off shutoff valve when leak is detected** - **Minimum refill volume**: Ignore refills smaller than this. - **Maximum refill volume (0 = disabled)**: Ignore refills larger than this (0 disables the cap). - **Similarity tolerance (%)**: How similar volumes must be to be counted together. - **Repeat count to trigger**: Number of similar refills within the window required to trigger. - **Maximum hot water percentage (%)**: Sessions with hot water percentage above this will be ignored. - **Window to count repeats (seconds)**: Time window to collect refills for comparison. - **Auto-clear after idle (seconds)**: Time without matching refills before the alert clears. - **Cooldown after clear (seconds)**: Suppress re-triggering for this long after clearing. - **Minimum refill duration (seconds, 0 = disabled)**: Ignore refills shorter than this (0 disables the guard). - **Maximum refill duration (seconds, 0 = disabled)**: Ignore refills longer than this (0 disables the guard). - **Turn off shutoff valve when leak is detected** - **Max low-flow rate** - **Seed low-flow duration (seconds)** - **Minimum duration to trigger (seconds)** - **Clear after idle (seconds at zero flow)** - **Counting mode**: Choose how time is accumulated during low-flow: - Any non-zero flow (wall clock): counts all time while flow \> 0 - Only time within low-flow range: counts only while 0 \< flow ≤ max low-flow - Baseline latch: once seeded, latches a baseline and counts while flow stays near baseline; margin controls the allowed band - **Smoothing window (seconds)** - **Cooldown after clear (seconds)** - **Clear after sustained high flow (seconds, optional)** - **Baseline margin (%)** - **Turn off shutoff valve when leak is detected** Texts from the code of [markaggar/Water-Monitor](https://github.com/markaggar/Water-Monitor). ## Entities - **Numbers**: Expected low-flow baseline, Leak alert sensitivity, Synthetic flow (gpm) ## From the README > You must download/copy the integration first (via HACS or manual copy) and restart Home Assistant before you can install the integration from the Devices and Services page under Settings. > > A Home Assistant custom integration for water usage monitoring that provides session tracking, gap handling, hot water analytics, and optional leak detection with water shut-off valve support. Only a Flow sensor is required; a Volume sensor, Hot water sensor and shut-off valve control is optional. If you do supply a Volume sensor, Water Monitor will use it directly (ideal if you want volumes to align with the Energy dashboard). > > - Intelligent session detection > - Automatically detects water usage sessions from flow/volume sensors > - Smart gap handling to avoid splitting single sessions > - Session sensors > - Last session volume: Most recently completed session with metadata > - Current session volume: Real-time view during active use including gaps, and resets to 0 when a session ends > - Last session duration: Duration in seconds of the last completed session > - Last session average flow: Average flow rate of the last completed session (volume unit per minute) > - Last session hot water percentage: Hot water percentage of the last completed session > - Hot water analytics > - Tracks hot water time and percentage per session via an optional hot water binary sensor > - Optional low-flow leak detector From the README of [markaggar/Water-Monitor](https://github.com/markaggar/Water-Monitor#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Water](https://vulpo.app/integrations/category/water.md) - Number: 126 installs sharing analytics; 63 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v1.4.1, last updated October 6, 2026 - Domain: `water_monitor` - Source: - Issues: In Vulpo: Chart card, Apple Watch Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-22. Source: https://vulpo.app/integrations/marketplace/markaggar-water-monitor --- - HTML version of this page: https://vulpo.app/integrations/marketplace/markaggar-water-monitor - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml