
Smart Irrigation
Smart Irrigation waters your garden from Home Assistant, with the water the weather actually took out of it.
It works out, zone by zone, how much water the plants lost to evapotranspiration and got back from the rain, and it waters the difference: not a fixed fifteen minutes, not the day after a storm, and more in a heatwave. Then it runs the watering itself, as much of it as you want it to.
Three ways to use it
- It calculates, you water. Each zone gets a duration, a water balance and the reasons behind them, as entities and events. Your own automation, a blueprint for your controller (Rain Bird, Hydrawise, Rachio, OpenSprinkler, B-hyve, ESPHome), or Irrigation Unlimited does the watering.
- It opens the valves. With direct valve control, Smart Irrigation waters each zone for its duration: zones in turn or together, cycle and soak so clay takes the water in, a pause between zones, a watchdog for a valve left open, and the water actually delivered credited to the zone.
- It runs your whole irrigation. The full controller (optional, off by default) adds programs, schedules, pumps and a planning: everything a dedicated irrigation controller does, fed by the calculated durations.
✨ Highlights
The controller
- 🗓️ Programs of ordered steps, one zone or several at once, watered for the calculated duration or a share of it, with passes, waits, limits and a minimum deficit per step.
- ⏰ Schedules anchored to a start or to an end (“done by sunrise”): days of the week, every N days, odd or even days, months, a period of the year. Each one shows what can hold it back.
- 🚿 Pumps and main valves with their delays, the other valves of a zone, and a confirmation that a valve really opened.
- 📅 A planning of what will run, when and why, and the running watering shown on the Home page, the zones and the card. Pause, resume, queue, suspend, run now.
- 🔁 Imports an Irrigation Unlimited configuration in a few clicks.
The calculation
- ☀️ FAO-56, hour by hour. Evapotranspiration from the Penman-Monteith equation, with or without a radiation sensor, checked against the paper’s own worked example, and a water balance replayed in five-minute steps.
- 🌦️ Your sensors, a weather service, or both: Open-Meteo, OpenWeatherMap, Pirate Weather, or any weather integration of Home Assistant, switched on the fly.
- 🛑 Skip conditions: a rain sensor, frost, wind, soil moisture and the rain forecast can each hold a run back, and the Home page says which one and on what numbers.
- 🌱 Greenhouse mode: under glass, a lux sensor inside tells the sun that reaches the plants.
Everyday use
- 🎛️ A panel built with Home Assistant’s own components, in a standard and an advanced mode, with a setup assistant that creates your first zone. The soil and the crop are chosen by name.
- 🃏 A dashboard card, served by the integration: where each zone stands, how long it would run, when, and a button to water on the spot.
- 🔌 Entities for everything: a
valve per zone for dashboards and voice assistants, a master switch, Calculate and water, to stop it all for the winter, sensors, buttons and events for your automations.
- 🌍 20 languages for the panel and everything Home Assistant shows: corrections are welcome on Weblate, in the browser.
- 💾 Backup and restore of the whole configuration in one file.
Installation
Via HACS (recommended). Smart Irrigation is in the HACS default store, so there is no repository to add:
- In HACS, search for Smart Irrigation and click Download.
- Restart Home Assistant, then add it from Settings → Devices & Services → Add Integration → Smart Irrigation.
Manually. Download the latest release and extract it into custom_components/smart_irrigation/, then restart Home Assistant.
Full documentation: altmenorg.github.io/HAsmartirrigation.
Recent improvements
v2026.11.0 (November 2026) brings the full controller, a panel reworked from end to end, the water balance replayed in five-minute steps, a Home Assistant weather entity as a weather service, one switch to stop everything, and one name for each thing in all 20 languages (a glossary lists them). Some actions were merged into one, and the old names keep working until v2027.11. The release notes say what changes for everyone and what to check before updating; Smart Irrigation now needs Home Assistant 2026.3 or later.
Irrigation start triggers
Smart Irrigation computes irrigation durations, and either opens the valves itself (direct valve control) or leaves the watering to your own automation. A start trigger schedules a start relative to a solar event (sunrise, sunset or solar azimuth, ± an offset) or at a fixed clock time, and fires the Home Assistant event smart_irrigation_start_irrigation_all_zones so an automation can react.
You can define several triggers, but only the one selected as active starts the watering, once per day. Besides your own triggers, the choice offers Default (finish at sunrise: sunrise minus the planned length of the run) and None (Smart Irrigation starts no watering). The event data identifies which trigger fired:
| field |
meaning |
trigger_name |
the name you gave the trigger |
trigger_type |
sunrise, sunset, solar_azimuth or time |
at |
for a time trigger, the clock time it is set to |
offset_minutes |
the configured offset |
account_for_duration |
whether timing is shifted so watering finishes at the target moment |
Example automation:
trigger:
- platform: event
event_type: smart_irrigation_start_irrigation_all_zones
event_data:
trigger_name: "Morning"
action:
- # open your valves for the durations Smart Irrigation calculated
The precipitation-skip and “days between irrigation” settings still apply: on a skip day no event is fired.
🧩 Enhanced features
These features are driven by services and blueprints:
- 🔁 Recurring schedules (on their way out: they keep working until 2027.11; the programs’ schedules under Watering replace them) — daily / weekly / monthly / interval-based schedules via the
smart_irrigation.create_recurring_schedule service.
- 🍂 Seasonal adjustments — adjust the crop factor and the threshold by month, in the panel (advanced mode) or with services.
- 🔗 Irrigation Unlimited: Smart Irrigation hands its calculated durations to the Irrigation Unlimited component through blueprints and automations (
adjust_time), or imports its configuration into the full controller.
- 📐 Automation blueprints — ready-to-use blueprints, installed with the integration, for plain valves, ESPHome, Irrigation Unlimited and off-the-shelf controllers (Rain Bird, Hydrawise, Rachio, OpenSprinkler, B-hyve): see the automations and controllers pages.
See the enhanced scheduling documentation for details and examples.
Documentation
The full documentation is published at altmenorg.github.io/HAsmartirrigation (source in docs/) — installation, configuration (zones, sensor groups, modules), usage, events, services and troubleshooting.
Contributing
You do not need to write code to help, and the most useful contributions right now are not code.
-
Translate. The interface comes in 20 languages, and apart from English and French they were machine-translated: nobody who speaks them has read them yet. If yours reads oddly, correct it on Hosted Weblate, in the browser, with no Git and no build tools. One word in one string is welcome. A language that is missing can be requested there too.

-
Report what looks wrong. A zone that waters too much, too little or not at all: open an issue and attach the diagnostics file (Settings, Devices & services, Smart Irrigation, Download diagnostics). Most of the fixes in the last releases were found from one.
-
Ask and share. Questions, setups and ideas go to the Discussions.
-
Change the code. Pull requests go against the dev branch. CONTRIBUTING.md explains the setup, the tests and what makes a change easy to merge.
Development
git clone https://github.com/altmenorg/HAsmartirrigation.git
cd HAsmartirrigation
make setup # create the venv and install dev dependencies
Available commands
make help # list all commands
make test # run all tests
make format # format code (black)
make lint # run linting (ruff)
make check # run all CI quality checks
The frontend panel is a separate TypeScript/Lit project under
custom_components/smart_irrigation/frontend/
(npm install then npm run build).
Testing
Install the test requirements, then run the suite:
pip install -r requirements.test.txt
pytest # everything
pytest tests/test_services.py # a single file
pytest -n auto # on every core
All the tests live in tests/. scripts/check.sh runs every check the CI runs (the Python tests, ruff, black, the panel’s lint and tests, and the bundle), so you can run them all before pushing.
See CONTRIBUTING.md for the full development and testing guide.
Acknowledgements
Smart Irrigation exists thanks to Jeroen ter Heerdt, who created it, designed its evapotranspiration model and maintained it for years. He passed the torch in June 2026, and the project carries on in the same spirit. Thank you, Jeroen, for building something so many gardens rely on, and for entrusting it to good hands. 🌱
Thanks also to JustChr, whose Smart Irrigation fork explored the closed-loop direction. The crediting of the water balance from observed watering, and parts of the direct valve control, are adapted from that work (MIT), and calculating the evapotranspiration hour by hour is an idea that fork tried first, though the equations here are written from FAO-56 and checked against the paper’s own worked example.
License
MIT — © 2020 Jeroen ter Heerdt (original Smart Irrigation), © 2026 Anthony Mercatante.
评论