Skip to content

Lux

Checks whether ambient-light (illuminance) sensors fall inside a lux range, such as: "the lounge is dark", or "the office is brighter than 300 lx".

This is the natural condition for daylight-aware lighting: instead of guessing from the time of day or the weather, it reads what your light sensors actually measure. It is used with sensor entities whose device class is illuminance.

When you add a Lux condition to a scene, the editor shows (top to bottom):

  • Any of or All of — shown above the sensors once you pick more than one. "Any of" passes when at least one sensor reads inside the range; "All of" requires every sensor to match.
  • Entity — a picker listing your illuminance sensors. Pick one or more. Leaving it empty makes the condition match anything (no constraint).
  • is / is not — whether each reading must fall inside the chosen range (is) or outside it (is not). "is not" inverts the whole test — the band and the Any-of/All-of quantifier — so Any of (hall, landing) is not Dark matches when neither sensor reads below 10 lx.
  • Range — either a named lux range (see below) or a custom inline band with a Min and/or Max in lux. A band is half-open: it matches when min ≤ reading < max. Either bound may be left empty for an open-ended range.

Adding a Lux condition.

A sensor reporting unavailable, unknown, or a non-numeric value never counts as inside or outside a range — it is treated as unobservable, so neither is nor is not passes on it. An "is not bright" test will not fire just because a sensor dropped offline.

Examples

Setup Meaning
Lounge sensor, range Dark The lounge reads below 10 lx.
Office sensor, min 300 The office is at 300 lx or brighter.
Office sensor, is not, range Dark The office is reading, and not dark (≥ 10 lx).
Hall + landing, Any of, range Dim At least one of the two reads 10–50 lx.

Named lux ranges

Ambience ships five built-in ranges:

Range Band
Dark below 10 lx
Dim 10 – 50 lx
Normal 50 – 300 lx
Bright 300 – 1000 lx
Very bright 1000 lx and above

You can change these, hide them, or add your own in the panel's SettingsConditions tab → Lux ranges. Scenes that reference a named range pick up any later edits to it automatically.

Configuring the Lux named ranges.

Next: Occupancy.