Widget
Irrigation
A smart sprinkler panel. Each zone maps to any Home Assistant entity — a switch, a valve, or a custom service — with timed or toggle runs, a live countdown, per-zone photos or head-type icons, and a rain-status badge.
⚠ Important — your responsibility You are responsible for ensuring your hardware (valves, controllers, wiring, and Home Assistant entities) is correctly configured and safe to use with the irrigation widget, and you are fully responsible for any use of it. The widget controls real valves over your network.
If internet or network connectivity is lost while an automation or timed run is in progress, a valve may remain open and water continuously. Always provide an independent fail-safe at the hardware level (e.g. a controller that closes valves on its own, a mechanical timer, or a flow shut-off). Flux is provided "as is," without warranty; use it at your own risk. See
Safety & responsibility below.
What it does
The irrigation widget shows a grid of zone tiles. Tap a tile to start or stop that zone. In timed mode the tile counts down and shuts the zone off automatically; in toggle mode it simply turns the zone on or off. A running zone shows a water-flow animation and a colored ring. An optional master control and a rain badge appear in the header.
Each zone is independent Zones don't have to be the same kind of entity. One can be a switch, another a valve, another a service call into an irrigation integration — they all live in one widget.
Add it
- Enter edit mode, tap Add Widget, choose Irrigation.
- Open the widget's inspector (tap the widget while editing) and add your zones.
- For each zone, pick the entity, the run mode, and (optionally) a photo, icon, color, and schedule.
Per-zone settings
| Setting | What it does |
|---|
| Name | Label shown on the tile (e.g. "Front Lawn"). |
| Entity | The Home Assistant entity that drives the valve — any switch, valve, or service-controlled entity. |
| Run mode | Timed — runs for the set duration with a live countdown, then auto-stops. Toggle — stays on until you tap again. |
| Duration (min) | How long a timed run lasts before Flux turns the zone off. |
| Control method | Auto infers the right service from the entity's domain. Or force Switch (turn_on/turn_off), Valve (open_valve/close_valve), or Service (a custom domain + service with JSON parameters — for integrations that need a zone index, etc.). |
| Photo / Icon | Attach a photo of the area for instant recognition, or choose a sprinkler head-type icon (pop-up spray, rotor, rotary, impact, bubbler, mist, drip, drip line, shrub spray, soaker). |
| Color | Accent for the running ring and water animation. |
| Rain skip | When on, this zone is skipped by scheduled runs while the rain rule is active. |
How "Auto" decides A valve.* entity is opened/closed with the valve service; anything else is turned on/off. If you ever see a plain control toggle the valve but a zone tile do nothing, set the control method explicitly to match the entity.
How a tap works
Tapping an idle zone calls the on-service for its control method. For a timed run, Flux records an end time, shows the countdown, and schedules the off-service. Tapping a running zone stops it immediately. A zone reads as "running" when its entity state is on, open, running, or watering, or while its local timer is active.
Scheduling is coming with the Flux controller Right now the irrigation widget is for running zones manually (tap to start/stop, with optional timed runs). In-app schedules are temporarily turned off: relying on the app and your network to close a valve isn't safe enough on its own. Automatic watering will return paired with Flux's dedicated irrigation controller, which closes valves at the hardware level even if the network or app goes away.
Weather status
Set a weather source — a Home Assistant weather/binary_sensor entity (or Apple Weather) — and Flux shows a Rain badge so you can decide whether to skip a manual run. (Automatic rain-skipping returns with scheduling.)
Widget options
| Option | What it does |
|---|
| Title | Header text; can be hidden entirely. |
| Master entity | Optional master valve/switch shown as a power button in the header. |
| Animations | Toggle the running-water shimmer. |
| Weather source | The entity (or Apple Weather) used for the rain badge and skip. |
On Apple TV Zone tiles are focusable with the remote. Photos are stored at a reduced size to keep dashboards light, since they sync with your layout.
Safety & responsibility
Please read this before relying on the irrigation widget to control real valves.
- You are responsible for your hardware. It is your responsibility to ensure your valves, controllers, wiring, water supply, and the Home Assistant entities you map are correctly configured, compatible, and safe for use with the irrigation widget.
- You are fully responsible for using the widget. Starting, stopping, and scheduling watering is entirely under your control and at your own risk, including any water use, damage, flooding, or cost that results.
- Network loss can leave a valve open. Flux sends commands over your network and, for timed runs and schedules, sends the "off" command at the end of the run. If internet or local network connectivity is lost — or the device running the schedule sleeps, is turned off, or loses power — while a zone is open, the "off"/"close" command may never reach the valve and the valve can stay open and run water continuously. Flux cannot guarantee a valve will close.
- Use an independent fail-safe. Always have a hardware-level safeguard that does not depend on Flux or your network — for example an irrigation controller that closes its own valves, a mechanical/timer shut-off, or a flow/leak shut-off valve. Do not rely on the app as the only thing that stops watering.
- No warranty. The irrigation widget is provided "as is," without warranty of any kind. To the maximum extent permitted by law, the developers are not liable for any damages or losses arising from its use.