OpenSprinkler Preview Card

August 11, 2026 · View on GitHub

A Home Assistant card to display a preview of future irrigation runs using a bar-chart format.

GitHub Release Dynamic Regex Badge GitHub License

OpenSprinkler Preview Card

What is the OpenSprinkler Preview Card?

The OpenSprinkler Preview Card is a card for the Home Assistant Dashboard UI. It displays the predicted future irrigation run schedule for OpenSprinkler by using the Calendar entity in the OpenSprinkler Integration for Home Assistant integration. Version 2.0.0 of the integration is required to use this card.

Features

  • Works with the Calendar entity in the OpenSprinkler Integration for Home Assistant integration
  • Displays the day's calendar entries in a bar-chart format
  • Similar to OpenSprinkler's Program Preview feature
  • Provides a date-picker as well as next and previous day buttons
  • Hovering over a run displays more information

Installation

Manual

  1. Download opensprinkler-preview-card.js from Releases.
  2. Put opensprinkler-preview-card.js in your config/www folder.
  3. Add a reference to opensprinkler-preview-card.js: Go to Settings → Dashboards → More Options icon → Resources → Add resource → Set Url as /local/opensprinkler-preview-card.js?v=1.0.0 → Set Resource type as JavaScript module. Use the version number of the Release you have downloaded for the value of v=.

Usage

To add the card to a Dashboard in Home Assistant:

  • :pencil2: Edit Dashboard
  • Click Add card
  • By entity, choose the OpenSprinkler Calendar entity and then the OpenSprinkler Preview Card, or
  • By card, choose the OpenSprinkler Preview Card and select the OpenSprinkler Calendar entity.

The YAML for the card is only two lines:

type: custom:opensprinkler-preview-card
entity: calendar.opensprinkler_schedule

The card defaults to the current day, which is the only day where a Weather Adjustment, if in affect, will be applied to the run times. Move forward or backward using the arrow buttons, or choose a date from the date picker.

Note that run events in the past are calculated using rules now in effect, and are not a history of exact run behavior.

The Calendar entity on which this card is based is meant to show an approximation of future events, just like the Program Preview. It considers the following OpenSprinkler settings:

  • Schedule types Weekly, Interval, Single run, and Monthly
  • Even/Odd Restrictions
  • Additional Start Times, Repeating and Fixed
  • Date Range
  • Rain Delay
  • Station Groups
  • Station Delay
  • Station Ignore Rain Delay
  • Weather Adjustment, current day only, multi-day not supported yet

If you hover over a run, additional information from the Calendar will be shown.