Files
nspanel-lovelace-ui/docs-standalone/docs/screensaver.md
Johannes Braun f7fa1653c6 fix2
2026-02-22 00:57:18 +01:00

1.6 KiB

Screensaver

screensaver is a required object in each panel config.

Keys

key required type default description
type no string screensaver Layout type (screensaver / screensaver2).
entities yes* list none Screensaver entities.
entity yes* string none Single-entity shortcut.
statusIcon1 no object none Left status icon near date.
statusIcon2 no object none Right status icon near date.
doubleTapToUnlock no bool false Requires double tap when leaving screensaver.
sleepTimeout no int panel sleepTimeout Per-screensaver timeout override.

* Provide at least one of entity or entities.

Screensaver entities

Screensaver entities use the same entity format as other cards.

For weather.<entity> you can also use:

  • attribute (default temperature)
  • day (daily forecast index)
  • hour (hourly forecast index)
  • unit (suffix, default °C for temperature-like attributes)

Example

screensaver:
  type: screensaver
  doubleTapToUnlock: true
  sleepTimeout: 30
  statusIcon1:
    entity: binary_sensor.front_door
    icon:
      "on": mdi:door-open
      "off": mdi:door-closed
    font: medium-icon
  statusIcon2:
    entity: sensor.outdoor_temperature
    icon: mdi:thermometer
  entities:
    - entity: weather.home
      attribute: temperature
    - entity: weather.home
      day: 1
      attribute: temperature
    - entity: weather.home
      day: 2
      attribute: temperature
    - entity: sensor.indoor_temperature
      icon: mdi:home-thermometer