

The duration can be specified as a number of seconds or the easier to read 01:23:45 format. If a new duration is provided, this will be the new default for the timer until Home Assistant is restarted (which loads your default values). If no duration is given, it will either restart with its initial value, or continue a paused timer with the remaining duration. Starts or restarts a timer with the provided duration. finished_at should usually be now, or within the last several seconds, but if the restore property is true, finished_at may be further in the past since this event will fire on startup for any timers that would have ended while Home Assistant was stopped. Timer is currently running because it was (re-)startedįired when a timer has completed and includes finished_at date/time in event data. Timer is idle because the timer finished, was canceled or was never started For example mdi:car, mdi:ambulance, or mdi:motorbike. Pick an icon from Material Design Icons to use for your timer and prefix the name with mdi. The finished_at property in the event data will provide you with the time that the timer was actually supposed to fire which you can use in automation conditions to decide whether or not to act on it. If an active timer was supposed to end while Home Assistant is stopped, the timer.finished event will fire on startup for that timer. When true, active and paused timers will be restored to the correct state and time on Home Assistant startup and restarts. To add a timer to your installation, add the following to your configuration.yaml file: Timers can also be configured via configuration.yaml: If you removed default_config: from your configuration, you must add timer: to your configuration.yaml first, then you can use the UI. To be able to add Helpers via the user interface you should have default_config: in your configuration.yaml, it should already be there by default unless you removed it. You can also click the following button to be redirected to the Helpers page of your Home Assistant instance. The preferred way to configure timer helpers is via the user interface at Settings > Devices & Services > Helpers and click the add button next choose the Timer option. However, automations using the timer.finished event will not trigger if the timer expires when Home Assistant is not running. Timers will be restored to their correct state and time on Home Assistant startup and restarts when configured with the restore option.
