A fully self-contained smart irrigation dashboard card for Home Assistant. Zero YAML scripting required — install the card, create your zone duration helpers, and everything else is configured and auto-created from within the card UI.
| Main Card | Zones & Info Bar | Schedule |
|---|---|---|
 |
 |
 |
| Skip Next Run | Zone Expand Popup | Settings — General |
|---|---|---|
 |
 |
 |
| Settings — Rules & Info Bar |
|---|
 |
Zero setup scripting
- Auto-creates
script.sprinkleron first load, built from your configured zones - Auto-creates the Scheduler entity (defaults to Mon/Wed/Fri at 06:00)
- Auto-creates required helper entities for skip-next-run and manual run logging
- Script silently rebuilds whenever zones are changed, reordered, or toggled
Zone control
- Up to 12 configurable zones — 2-column grid with toggle, progress bar, countdown timer, and 1-minute adjustable duration
- Zone expand popup — tap any zone tile to open a large overlay with big +/− duration buttons, status, last activity, and a Manual Run button
- Manual Run auto-stop — starts the zone, runs it for exactly the duration you set, turns it off automatically, and restores the zone's original scheduled duration afterwards — no need to remember to turn it off
- Zone last-run badge — shows "last: Xm/Xh/Xd ago" on each tile
- Smart Resume — if Home Assistant restarts mid-run, the card detects any zone still on, resumes it if still within its duration, or stops it immediately if it overran
- Per-zone schedule toggle — tick/untick each zone to include or exclude from scheduled runs
- Per-zone skip next run — one-tap skip for the next run only, self-clearing after the schedule fires
Schedule management
- Built-in scheduler section — enable/disable, set run days, set run time with mobile-friendly HH/MM editor
- Smart next-run countdown — shows "Tonight 22:00", "Tomorrow 06:00", or "in 3h 45m"
- Start Schedule button — manually triggers the full zone sequence
- Stop Schedule button — immediately stops the script and closes all valves (with confirmation)
Run history
- Last Run popup — shows the most recent scheduled run's timestamp, then checks each zone's actual switch activity against that run's time window so it only lists zones that genuinely watered (not just zones that happen to be enabled)
- Skipped zones and zones with no recent activity are shown in their own sections, so a zone that's quietly stopped running (e.g. toggled off, disconnected) is surfaced instead of hidden
- Manual runs are logged separately with a 🔧 icon, the duration used, and how long ago they ran — persisted via an auto-created helper so they survive page refreshes
Info bar
- 4 configurable header slots — label, searchable MDI icon (7000+ with live preview), up to 2 sensors each
- Weather entities auto-render with condition and temperature
- Dual-sensor slots use unified dash separator (e.g.
4,650L - 97%,Possible - 55%) - All values title-cased automatically
- Tap any slot to open the entity detail popup
Automation rules
- Rain auto-disable — schedule turns off when rain exceeds configured mm threshold (slot turns yellow)
- Rain auto-restore — seasonal auto-adjust: 24h summer (Oct–Mar), 48h winter (Apr–Sep), with manual override and reset buttons
- Postpone countdown — shows "Resumes in Xh Xm" with rain/clear icon and which scheduled day will be skipped
- Jojo/tank low-level shutoff — all valves close immediately when tank drops below configured % (slot turns red)
- Confirmation popups — optional confirmation before any zone or schedule action
Settings & persistence
- All settings saved via HA websocket — survives hard refresh and works in sections layout
- Drag-to-reorder zones — script run order matches
- Searchable entity picker for all entity fields
- Version number visible in settings header
- Home Assistant 2023.1+
- Scheduler Component integration (via HACS)
- One
input_numberhelper per zone for duration (see Step 2)
- Open HACS in Home Assistant
- Click Frontend in the sidebar
- Click the ⋮ (three dots) in the top right corner
- Select "Custom repositories"
- Paste this URL:
https://github.com/HybridRCG/sprinkler-dash-card - Select "Lovelace" as the category
- Click "Create"
- The card should now appear in HACS — click Install
- Hard refresh your browser (Ctrl+Shift+R on Windows, Cmd+Shift+R on Mac, or open DevTools and long-press refresh)
That's it! You're done. Go to any dashboard and add the card with:
type: custom:sprinkler-dash-card-v2Note: The card is pending approval for the HACS default store. Once approved, you'll be able to search and install directly without adding a custom repository. For now, custom repository is the fastest way to get started.
- Download
sprinkler-dash-card.jsfrom the latest release - Copy it to
/config/www/sprinkler-dash-card.json your Home Assistant server - Go to Settings → Dashboards → Resources
- Click the + Create New Resource button
- Paste:
/local/sprinkler-dash-card.js - Set Resource Type to JavaScript Module
- Click Create
- Hard refresh your browser
Now add the card to any dashboard:
type: custom:sprinkler-dash-card-v2type: custom:sprinkler-dash-card-v2That's the only YAML needed. All configuration is done inside the card via ⚙️.
Go to Settings → Helpers → Add → Number and create one per zone:
| Helper | Min | Max | Step | Unit |
|---|---|---|---|---|
input_number.valve_1_time |
0 | 60 | 1 | min |
input_number.valve_2_time |
0 | 60 | 1 | min |
| ... | ||||
input_number.valve_8_time |
0 | 60 | 1 | min |
Create up to valve_12_time for up to 12 zones.
Install Scheduler Component via HACS (Integration category).
The card auto-creates script.sprinkler and the Scheduler entity on first load. Adjust the run days and time directly on the card's Schedule section.
- Set Active Zones (1–12)
- For each zone: set Switch Entity (valve switch) and Duration Entity (
input_numberfrom Step 2) - Drag ⠿ to reorder — script run order matches
- Tick checkbox to include zone in scheduled runs
- Tap 💾 Save when done
| Setting | Description |
|---|---|
| Nav path | Where tapping the title navigates |
| Rain sensor | Precipitation sensor in mm |
| Rain limit | mm above which schedule auto-disables |
| Rain restore | Hours before schedule re-enables after rain clears (default 48h) |
| Weather | Any weather.* entity |
| Jojo sensor | Water tank litres sensor |
| Jojo low % | Tank % below which all zones shut off immediately |
| Schedule switch | The switch.schedule_* entity (auto-detected) |
4 slots, each with: enable checkbox, label, MDI icon (searchable, live preview), Sensor 1, Sensor 2.
Layout auto-adjusts: 1=full, 2=50/50, 3=3-col, 4=2×2. Tap any slot to open entity detail.
| Rule | Behaviour |
|---|---|
| Confirm before activating | Confirmation popup on all zone/schedule actions |
| Rain: Auto-disable schedule | Disables schedule when rain exceeds limit |
| Rain: Auto-restore schedule | Re-enables schedule after rain clears (configurable hours) |
| Jojo: Low-level zone shutoff | Closes all valves when tank drops below low % |
Tap the 📅 calendar icon on any zone to skip it for the next run only. The zone shows an amber dashed border and "Skip next run" status. After the next schedule run, the skip clears automatically.
The card auto-creates input_text.sprinkler_skip_zones to track this — no setup needed.
Tap Last Run to see what happened during the most recent scheduled run.
- Timestamp — when the schedule last triggered (from
script.sprinkler'slast_triggeredattribute) - Watered — zones whose switch actually changed state within that run's time window (a couple of minutes before start, up to 4 hours after, to allow for long sequential runs). Only zones genuinely detected as active during that window are listed here.
- Skipped — zones that were marked "skip next run" for that run
- No recent activity — zones that are configured/enabled but show no switch activity near the last run, along with how long ago they last changed. This is the section to check if a zone has silently stopped watering (e.g. it was toggled off, its switch is unavailable, or it's disconnected).
- Manual Runs — any zones run manually via the zone expand popup, shown with a 🔧 icon, the duration used, and how long ago it ran. This is stored in an auto-created
input_text.sprinkler_manual_loghelper so it survives page refreshes.
No manual setup is required — the manual run log helper is created automatically on first load.
| Version | Changes |
|---|---|
| v2.9.75 | FIX (correctness): Last Run no longer assumes every configured zone ran. It now checks each zone's switch last_changed against the scheduled run's time window and only lists a zone under "Watered" if it actually toggled near that run. Zones with no activity near the run show separately under "No recent activity" with how long ago they last changed — surfaces zones that silently stopped running (e.g. toggled off) instead of hiding it. |
| v2.9.74 | NEW: Manual run history now PERSISTS across page refreshes! Added input_text.sprinkler_manual_log helper (auto-created) that saves each manual run. Loaded automatically on card startup, so manual runs stay visible in Last Run even after reloading the page. |
| v2.9.73 | Added manual run display back to Last Run. Shows both scheduled runs (with all zones) and recent manual runs (with 🔧 icon, duration, timestamp). Perfect combo! |
| v2.9.72 | COMPLETE REWRITE: Last Run completely rewritten. Bulletproof fallback to script.sprinkler.last_triggered. Shows all configured zones + durations. Simple, direct, no fancy logic. This version WILL work! |
| v2.9.71 | FIX: Last Run now simply shows all configured zones with durations, regardless of activity detection. No more complex filtering logic that missed zones. Shows what SHOULD have run based on config, not what activity detection thinks ran. Much more reliable! |
| v2.9.70 | REVERT: Simplified Last Run back to v2.9.68 approach. Removed multi-run history feature (too complex). Now uses scheduler's last_triggered as fallback. Shows current + recent activity clearly. Coming back to this later with better implementation. |
| v2.9.69 | Multi-run history feature (reverted) |
| v2.9.68 | POLISHED: Last Run now clearly separates SCHEDULED RUNS from MANUAL RUNS. Scheduled zones show configured duration. Manual runs show a 🔧 icon and actual duration + timestamp. Crystal clear what was what! |
| v2.9.67 | IMPROVED: Last Run now anchors to scheduler's last_triggered time instead of 2-hour window. Shows all zones that ran since last scheduled run. Detects activity up to 24 hours back. Much more reliable zone activity tracking! |
| v2.9.66 | NEW: Last Run now shows duration! Manual runs display the duration you set (e.g., "12m • 1h ago"). Scheduled runs show configured duration from zone helpers. Fully tracks what each zone actually ran for. |
| v2.9.65 | HOTFIX: Fixed syntax error in v2.9.64 (apostrophe in string). Card now loads without configuration error! |
| v2.9.64 | FIX: Last Run now bulletproof with debug logging + fallback detection. Checks multiple attribute names, falls back to script.sprinkler. Shows zone activity timestamps in human-readable format (5m ago, 2h ago, etc). Check browser console for debug info if still not working. |
| v2.9.63 | MAJOR: Zone modal now has BIG +/− buttons for duration adjustment. Manual zone runs now AUTO-STOP after the set time, then restore original duration. No more manual turn-off needed! |
| v2.9.62 | NEW: Click any zone card to pop out zone details modal — shows status, duration, last activity, and quick turn on/off button. Brings back the zone expand feature! |
| v2.9.61 | Added version footer to settings panel for easy version checking |
| v2.9.60 | COMPLETE REWRITE: Last Run now bulletproof — reads from scheduler's last_triggered attribute instead of error-prone JSON storage. Detects zone activity from switch timestamps. No more "Could not read last run" errors! |
| v2.9.59 | HOTFIX: Fixed Jinja template syntax in script delay — changed from max() filter to simpler or 1 logic. Zones now properly execute with correct delays |
| v2.9.58 | FIX: Zone runs now have minimum 1-minute delay (prevents stuck zones with 0-duration). UI now initializes with actual entity values instead of default 10 |
| v2.9.57 | NEW: Smart Resume — on HA restart, detects running zones and resumes from elapsed time (prevents over-watering). Automatically stops zones that exceeded duration, lets others finish normally |
| v2.9.56 | Fixed zone duration input increments — all zones now step by 1 minute (not 5) |
| v2.9.55 | Automation rule descriptions now dynamically read config values after save — Jojo shutoff threshold, rain threshold, and rain restore hours show correct saved values |
| v2.9.54 | Fixed time picker input width & height — no more cut-off numbers on desktop or mobile |
| v2.9.53 | NEW: Time picker is now a beautiful popout modal with large hour/minute spinners — tap time → modal appears → adjust with ▲/▼ or type → tap Save to close and apply changes |
| v2.9.52 | Fixed next-run countdown label — shows "in Xh Xm" instead of "Tonight" for clarity |
| v2.9.51 | Replaced broken time picker with proper dual-spinner UI for desktop & mobile |
| v2.9.50 and earlier | Foundational features: auto-created script/scheduler, zone grid with progress bars and duration steppers, per-zone schedule toggle and skip-next-run, rain auto-disable/auto-restore with seasonal hours, Jojo low-level shutoff, zone run order badges, manual zone timer with auto-stop, mobile-friendly time editor, drag-to-reorder zones, websocket-persisted settings, confirmation popups, and the original ring-buffer run history. See full release history for the complete list. |
| v2.0.0 | Auto-creates script and Scheduler; zone schedule toggle; sticky settings |
| v1.0.0 | Initial release |
MIT © HybridRCG