> The server runs every routine, whether or not anyone has the app open: the worker checks the clock-driven ones once a minute, and device routines the moment a device reports…
> Source: https://orochibraru.com/localassistant/docs/automations · Site index: https://orochibraru.com/llms.txt

# Routines

The server runs every routine, whether or not anyone has the app open: the
worker checks the clock-driven ones once a minute, and device routines the
moment a device reports. Everyone signed in can add, change, run or switch one
off. **Routines** has three tabs: the routines, the scenes, and the history of
every run.

## When

- **Sunrise** or **sunset**, with an offset in minutes (negative is before),
  from the home's location. Set it in **Admin**, **Homes**, **Set location**.
- **A time** on chosen weekdays, in the home's time zone.
- **The outside temperature** getting above or below a threshold. It fires once
  when it crosses, and again only after it went back by a degree.
- **A door or window opens**: one of the chosen contact sensors.
- **A device changes**: turns on or off, opens or shuts, locks or unlocks,
  starts playing, is pressed, or goes above or below a value (a sensor's
  reading, a meter's watts, a thermostat's room temperature, a light's
  brightness, a blind's position). It fires when the device gets there, not
  while it stays.
- **Someone arrives or leaves**: anyone, a given person, the first one home or
  the last one out. See "Who's home" below.

## During

All year, chosen seasons (winter is December to February, summer June to
August), or a date range that repeats every year and may wrap over New Year.

## Only if

Conditions checked when the trigger fires; if one doesn't hold, the routine
skips that time and the history says which:

- a device is on, off, open, shut, locked, playing, above or below a value;
- between two times (it may wrap over midnight);
- on chosen weekdays;
- during the day or at night, from the home's sunrise and sunset;
- who's home: somebody, nobody, or a given person home or away.

**Run now** ignores them.

## Do

Steps run one after the other:

- **Drive a device**: any device that takes a command, a light (on, off,
  brightness, white), a switch, a lock, a fan, a speaker or TV, a heat pump, a
  valve, a blind, a button, a printer or a robot vacuum;
- **Set a scene**;
- **Send a notification** to everyone, the admins or one person, with up to two
  scenes as buttons (see [Notifications](https://orochibraru.com/localassistant/docs/notifications));
- **Move blinds** of a room or every blind in the house;
- **Wait** some minutes before the next steps. Changing or switching off the
  routine cancels the steps still waiting.

A step that fails doesn't stop the next; the card and the history show what
failed.

With a door or window trigger, two more steps hold until the sensors shut:

- **Close radiator valves**: the chosen valves in the room of the sensor that
  opened close, and go back to their target once every chosen sensor there is
  shut.
- **Turn the heating down** by some degrees: the chosen heat pumps and valves in
  that room, or all of them for a door in the whole house, go back to the target
  they had once it shuts.

## Who's home

A person counts as home when a device they own says so, and away when the ones
that know all say away. An admin picks the owner in **Devices**, **Edit**,
**Whose is it**, for two kinds of devices:

- **Person trackers**: Home Assistant's people and device trackers through the
  Home Assistant integration, or any tracker announcing itself through MQTT
  discovery. They follow the person all day.
- **Phones and tablets** added from **Account**, **This device**, with the
  location shared. A web app only reports while it's open, so a phone alone says
  when someone opened the app at home, not when they walked in: pair it with a
  tracker (OwnTracks, Home Assistant's companion app) for routines that should
  fire at the door.

**Home** shows everyone who's tracked, home or away and since when.

## Scenes

A scene is a set of devices and what each one should be doing: movie night,
bedtime, away. **Add a device** brings it in the way it is now, **Use how they
are now** captures every one again, and each can be changed by hand. **Set**
puts them all that way; routines set scenes too.

## History

Every run for 30 days: what set it off, whether it ran, was skipped by a
condition, is waiting on a delay, or failed, and why.

## Presets

**New routine**, **Start from** fills the form with a ready-made routine, still
editable before saving: blinds closed at sunset and opened at sunrise in autumn
and winter, blinds closed when it gets hot in summer, radiators off while a
window is open, and the heating down while the front door is open.