Skip to content

Configuration

Jan Seidl edited this page Oct 11, 2021 · 7 revisions

All configuration must be done through the UI. YAML configuration is deprecated

Area configuration parameters

  • Features: Select features to enable
  • Presence Sensor Device Class: Device classes of sensors to be considered presence sensors (default: presence, occupancy, motion)
  • Icon: Icon for the area's presence binary sensor.
  • Update Interval: Interval for checking missed events (default: 60)
  • Clear Timeout: How long since last presence event should it wait before clearing the area (default: 60)
  • Type: Area type (interior/exterior)

Including / Excluding entities

  • Include Entities: Extra entities to consider for this area (for when they can't be tied to an area in Home Assistant)
  • Exclude Entities: Entities to ignore throughout Magic Areas for this area

Secondary-state configuration

  • Dark Entity: Entity used to track when area is dark
  • Dark State: State of dark entity which represents on/dark (default: on)
  • Sleep Entity: Entity used to track area sleep state
  • Sleep State: State of sleep entity which represents on/sleeping (default: on)
  • Sleep Timeout: How long since last presence event should it wait before clearing the area when on sleep mode (default: 60)
  • Accented Entity: Entity used to track when area is accented
  • Accented State: State of dark entity which represents on/accented (default: on)
  • Extended Time: How long after being occupied this area will be marked as extended
  • Extended Timeout: How long since last presence event should it wait before clearing the area when on extended mode (default: 300)

Feature-specific configuration

See each feature wiki page for their configuration options.