Home Assistant YAML & Konfiguration

1# YAML Grundlagen: alle Konzepte
2# Das ist ein Kommentar
3
4# ── Einfacher Schlüssel-Wert ──
5name: "Mein Zuhause"
6elevation: 250
7debug_mode: true              # Boolean: true/false
8
9# ── Verschachtelung (Einrückung!) ──
10location:
11  latitude: 52.52
12  longitude: 13.405
13  timezone: "Europe/Berlin"
14
15# ── Einfache Liste ──
16rooms:
17  - Wohnzimmer
18  - Küche
19  - Bad
20  - Schlafzimmer
21
22# ── Liste mit Objekten ──
23lights:
24  - name: Deckenlampe
25    type: dimmbar
26    room: Wohnzimmer
27  - name: Stehlampe
28    type: farbe
29    room: Schlafzimmer
30
31# ── Mehrzeiliger String (>) ──
32description: >
33  Dieser Text wird zu einer
34  einzigen Zeile zusammengefügt.
35
36# ── Mehrzeiliger String mit Zeilenumbrüchen (|) ──
37notes: |
38  Zeile 1 bleibt erhalten.
39  Zeile 2 auch.
40
41# ── Inline-Liste ──
42weekdays: [mon, tue, wed, thu, fri]
43
44# ── Inline-Objekt ──
45server: {host: "192.168.1.1", port: 8123}

1# configuration.yaml: kommentiertes Beispiel
2# ── Grundeinstellungen ──
3homeassistant:
4  name: "Wohnung Berlin"           # Name deines Zuhauses
5  unit_system: metric               # Metrisches System
6  currency: EUR                     # Währung
7  country: DE                       # Land (ISO 3166)
8  
9# ── Standardmäßig eingebaut ──
10default_config:                     # Lädt alle Standard-Integrationen
11
12# ── HTTP-Server ──
13# Seit Home Assistant 2026.8 NICHT mehr hier, sondern unter
14# Einstellungen > System > Netzwerk > HTTP-Server.
15# Ein alter http:-Block wird einmalig übernommen und danach ignoriert.
16
17# ── Recorder-Einstellungen ──
18recorder:
19  purge_keep_days: 7                # Verlaufsdaten 7 Tage behalten
20  exclude:
21    domains:
22      - media_player
23      - weather
24    entity_globs:
25      - sensor.sun_*
26
27# ── Logger-Einstellungen ──
28logger:
29  default: warning                  # Standard-Level
30  logs:
31    homeassistant.components.mqtt: debug
32    custom_components: info
33
34# ── Eigene Template-Sensoren ──
35template:
36  - sensor:
37      - name: "Durchschnittstemperatur"
38        unit_of_measurement: "°C"
39        state: >
40          {{ ((states('sensor.wohnzimmer_temp') | float(0) +
41               states('sensor.schlafzimmer_temp') | float(0)) / 2) | round(1) }}
42
43# ── Dateien aufteilen ──
44automation: !include automations.yaml
45scene: !include scenes.yaml
46script: !include scripts.yaml

automation: !include_dir_merge_list automations/

# automations/licht.yaml
- alias: "Flur-Licht bei Bewegung"
  triggers: ...
  actions: ...

# automations/heizung.yaml
- alias: "Heizung morgens"
  triggers: ...
  actions: ...

1# secrets.yaml
2# Passwörter und API-Keys hier speichern:
3mqtt_password: "mein-sicheres-passwort"
4openweather_api: "abc123def456"
5telegram_token: "bot123:ABC-DEF"
6latitude: "52.52"
7longitude: "13.405"

# Verwendung in configuration.yaml
homeassistant:
  latitude: !secret latitude      # ← Liest aus secrets.yaml
  longitude: !secret longitude

1# Jinja2 Syntax
2# ── Werte ausgeben ──
3{{ states('sensor.temperatur') }}              # → "21.5"
4{{ state_attr('light.wohnzimmer', 'brightness') }}  # → 200
5
6# ── Rechnen ──
7{{ states('sensor.temperatur') | float + 2 }}  # → 23.5
8{{ states('sensor.preis') | float * 100 | round(2) }}
9
10# ── Bedingungen ──
11{{ "warm" if states('sensor.temp') | float > 25 else "kühl" }}
12
13# ── Filter ──
14{{ states('sensor.name') | upper }}            # → "WOHNZIMMER"
15{{ states('sensor.name') | replace('_', ' ') }}
16{{ 1234.5 | round(0) }}                        # → 1235
17
18# ── Datum & Zeit ──
19{{ now().strftime('%H:%M') }}                  # → "14:30"
20{{ as_timestamp(now()) | timestamp_custom('%d.%m.%Y') }}
21
22# ── Listen filtern ──
23{{ states.light 
24   | selectattr('state', 'eq', 'on') 
25   | list | count }}                           # → Anzahl eingeschalteter Lichter

1# state_attr_translated(): Gibt übersetzte Attributwerte zurück
2# Praktisch für Lüftermodi, HVAC-Aktionen, Preset-Modi etc.
3{{ state_attr_translated('climate.wohnzimmer', 'hvac_action') }}
4# → "Heizen" (statt "heating")
5
6{{ state_attr_translated('fan.ventilator', 'preset_mode') }}
7# → "Automatisch" (statt "auto")
8
9# entity_name(): Gibt den Anzeigenamen einer Entity zurück
10{{ entity_name('sensor.wohnzimmer_multisensor_temperatur') }}
11# → "Wohnzimmer Multisensor Temperatur"
12
13# Nützlich in Benachrichtigungen:
14# message: "{{ entity_name(trigger.entity_id) }} hat sich geändert"

1# Praktische Template-Sensoren
2template:
3  - sensor:
4      # ── Fenster-Zähler ──
5      - name: "Offene Fenster"
6        icon: mdi:window-open
7        state: >
8          {{ states.binary_sensor
9             | selectattr('attributes.device_class', 'eq', 'window')
10             | selectattr('state', 'eq', 'on')
11             | list | count }}
12
13      # ── Wer ist zuhause? ──
14      - name: "Personen zuhause"
15        icon: mdi:account-group
16        state: >
17          {{ states.person
18             | selectattr('state', 'eq', 'home')
19             | map(attribute='name')
20             | list | join(', ') or 'Niemand' }}
21
22      # ── Durchschnittstemperatur ──
23      - name: "Durchschnitt Innen"
24        unit_of_measurement: "°C"
25        device_class: temperature
26        state: >
27          {% set temps = [
28            states('sensor.wohnzimmer_temp') | float(0),
29            states('sensor.schlafzimmer_temp') | float(0),
30            states('sensor.kueche_temp') | float(0)
31          ] | reject('equalto', 0) | list %}
32          {{ ((temps | sum) / (temps | count)) | round(1) if temps else 'unavailable' }}
33
34      # ── Tägliche Stromkosten ──
35      - name: "Stromkosten heute"
36        unit_of_measurement: "€"
37        icon: mdi:currency-eur
38        state: >
39          {{ (states('sensor.strom_taeglich') | float(0) * 0.35) | round(2) }}
40
41      # ── Müll-Erinnerung ──
42      - name: "Nächste Abholung"
43        icon: mdi:trash-can
44        state: >
45          {% set events = state_attr('calendar.abfallkalender', 'description') %}
46          {{ events or 'Unbekannt' }}
47
48  # ── Binary Sensor (Ja/Nein) ──
49  - binary_sensor:
50      - name: "Jemand zuhause"
51        device_class: presence
52        state: >
53          {{ states.person
54             | selectattr('state', 'eq', 'home')
55             | list | count > 0 }}
56
57      - name: "Alle Fenster zu"
58        device_class: window
59        state: >
60          {{ states.binary_sensor
61             | selectattr('attributes.device_class', 'eq', 'window')
62             | selectattr('state', 'eq', 'on')
63             | list | count == 0 }}

1# Klassisch: nach Domain aufgeteilt
2config/
3├── configuration.yaml
4├── automations.yaml      ← Heizung + Licht + Waschmaschine gemischt
5├── sensors.yaml           ← Heizung + Licht + Waschmaschine gemischt
6└── input_booleans.yaml    ← Heizung + Licht + Waschmaschine gemischt

1# Mit Packages: nach Thema aufgeteilt
2config/
3├── configuration.yaml
4└── packages/
5    ├── heizung.yaml       ← Alles zur Heizung
6    ├── waschmaschine.yaml ← Alles zur Waschmaschine
7    └── licht.yaml         ← Alles zum Licht

1# packages/waschmaschine.yaml - ALLES zur Waschmaschine an einem Ort
2
3template:
4  - sensor:
5      - name: "Waschmaschine Status"
6        state: >
7          {% set power = states('sensor.waschmaschine_power') | float(0) %}
8          {% if power > 1000 %}Waschen
9          {% elif power > 5 %}Laufen
10          {% elif power > 0 %}Standby
11          {% else %}Aus{% endif %}
12
13automation:
14  - alias: "Waschmaschine fertig"
15    triggers:
16      - trigger: state
17        entity_id: sensor.waschmaschine_status
18        from: "Waschen"
19        to: "Standby"
20        for: "00:02:00"
21    actions:
22      - action: notify.mobile_app_mein_handy
23        data:
24          title: "Waschmaschine fertig!"
25          message: "Die Wäsche kann aufgehängt werden."
26
27input_boolean:
28  waschmaschine_benachrichtigt:
29    name: "Waschmaschine bereits benachrichtigt"

1# configuration.yaml
2homeassistant:
3  packages:
4    waschmaschine: !include packages/waschmaschine.yaml
5    heizung: !include packages/heizung.yaml
6    licht: !include packages/licht.yaml

# configuration.yaml
homeassistant:
  packages: !include_dir_named packages

# configuration.yaml
homeassistant:
  packages: !include_dir_merge_named packages/

1packages/
2├── heizung/
3│   ├── steuerung.yaml
4│   └── sensoren.yaml
5└── licht/
6    └── wohnzimmer.yaml

1# packages/heizung/steuerung.yaml
2heizung_steuerung:
3  automation:
4    - alias: "Heizung bei Abwesenheit drosseln"
5      triggers:
6        - trigger: state
7          entity_id: binary_sensor.jemand_zuhause
8          to: "off"
9      actions:
10        - action: climate.set_temperature
11          target:
12            entity_id: climate.wohnzimmer
13          data:
14            temperature: 17

1# configuration.yaml - schlank und übersichtlich
2homeassistant:
3  packages: !include_dir_named packages
4
5# UI-Editor-Dateien bleiben separat
6automation: !include automations.yaml
7script: !include scripts.yaml
8scene: !include scenes.yaml

1# YAML Anchors
2# Definiere einen Wert einmal mit &name
3defaults: &light_defaults
4  brightness_pct: 80
5  color_temp_kelvin: 3000
6  transition: 2
7
8# Verwende ihn mit *name
9automation:
10  - alias: "Licht Wohnzimmer"
11    actions:
12      - action: light.turn_on
13        target:
14          entity_id: light.wohnzimmer
15        data:
16          <<: *light_defaults      # ← Fügt alle Werte ein!
17
18  - alias: "Licht Schlafzimmer"
19    actions:
20      - action: light.turn_on
21        target:
22          entity_id: light.schlafzimmer
23        data:
24          <<: *light_defaults      # ← Gleiche Werte!
25          brightness_pct: 40       # ← Überschreibt nur diesen Wert

1# Dynamische Werte in Automationen
2automation:
3  - alias: "Adaptive Helligkeit"
4    triggers:
5      - trigger: state
6        entity_id: binary_sensor.flur_motion
7        to: "on"
8    actions:
9      - action: light.turn_on
10        target:
11          entity_id: light.flur
12        data:
13          brightness_pct: >
14            {% if now().hour < 7 %}
15              20
16            {% elif now().hour < 18 %}
17              100
18            {% else %}
19              60
20            {% endif %}
21          color_temp_kelvin: >
22            {% if now().hour < 7 or now().hour > 20 %}
23              2700
24            {% else %}
25              4500
26            {% endif %}