5.2 KiB
Possible configuration values for screensaver config
| key | optional | type | default | description |
|---|---|---|---|---|
entity |
True | string | weather.example |
weather entity from homeassistant |
entities |
True | string | None |
contains a list of entities of this card (will be used instead of entity) |
statusIcon1 |
True | complex | None |
status icon left to the date string, config similar to weatherOverride |
statusIcon2 |
True | complex | None |
status icon right to the date string, config similar to weatherOverride |
doubleTapToUnlock |
True | boolean | False |
requires to tap screensaver two times |
theme |
True | complex | configuration for theme | |
defaultCard |
True | string | None |
default page after exiting screensaver; only works with top level cards defined in cards; needs to be a navigation item, see subpages (navigate.type_key) This config option will also be evaluated as a HomeAssistant Template. |
key |
True | string | None |
Used by navigate items |
Example for the a screensaver config with custom entities/overrides:
screensaver:
entities:
- entity: weather.demo_weather_north
- entity: weather.demo_weather_north
type: 0
- entity: weather.demo_weather_north
type: 1
- entity: weather.demo_weather_north
type: 2
- entity: sensor.energy_usage
Using a 6th entity will automatically activate the alternative layout.
screensaver:
entities:
- entity: weather.demo_weather_north
- entity: weather.demo_weather_north
type: 0
- entity: weather.demo_weather_north
type: 1
- entity: sensor.energy_usage
- entity: delete
- entity: sensor.indoor_temp
icon: mdi:home-thermometer-outline
You can use override the options decribed on the entities documentation page to override colors, names or values of the entities.
Possible configuration values for screensaver theme config
| key | option | type | default | description |
|---|---|---|---|---|
background |
True | list | Black | [R, G, B] |
time |
True | list | White | [R, G, B] |
timeAMPM |
True | list | White | [R, G, B] |
date |
True | list | White | [R, G, B] |
tMainText |
True | list | White | [R, G, B] |
tForecast1 |
True | list | White | [R, G, B] |
tForecast2 |
True | list | White | [R, G, B] |
tForecast3 |
True | list | White | [R, G, B] |
tForecast4 |
True | list | White | [R, G, B] |
tForecast1Val |
True | list | White | [R, G, B] |
tForecast2Val |
True | list | White | [R, G, B] |
tForecast3Val |
True | list | White | [R, G, B] |
tForecast4Val |
True | list | White | [R, G, B] |
bar |
True | list | White | [R, G, B] |
tMainTextAlt |
True | list | White | [R, G, B] |
tTimeAdd |
True | list | White | [R, G, B] |
Specify colours as red green and blue values from 0-255 e.g. [255, 0, 0] for red or [0, 0, 255] for blue. These are translated internally to RGB565 (note that this has lower color depth so the colours may not appear the same). Also note that the screen has a low contrast ratio, so colors look sigificantly different at full display brightness and lowest brightness.
Example for the theme config:
screensaver:
theme:
date: [255, 0, 0]
Config Example for configured statusIcons
``` screensaver: entity: weather.k3ll3r statusIcon1: entity: switch.example_item statusIcon2: entity: binary_sensor.example_item ```
It is possible to increase the size of the font used for the icons by adding altFont: True to the statusIcon configuration. Icon/Color Overrides are also possible like on any other Entity.
Config Example for configured statusIcons with increased size of the icons
``` screensaver: entity: weather.k3ll3r statusIcon1: entity: switch.example_item altFont: True statusIcon2: entity: binary_sensor.example_item altFont: True ```
Config Example for all white icons on screensaver
``` screensaver: entities: - entity: weather.demo_weather_north - entity: weather.demo_weather_north type: 0 color: [255,255,255] - entity: weather.demo_weather_north type: 1 color: [255,255,255] - entity: weather.demo_weather_north type: 2 color: [255,255,255] - entity: weather.demo_weather_north type: 3 color: [255,255,255] ```
Config Example for a custom date format on forecast
``` screensaver: entities: - entity: weather.demo_weather_north - entity: weather.demo_weather_north type: 0 name: "%a %-d/%-m" - entity: weather.demo_weather_north type: 1 name: "%a %-d/%-m" - entity: weather.demo_weather_north name: "%a %-d/%-m" type: 2 - entity: weather.demo_weather_north name: "%a %-d/%-m" type: 3 ```