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
25type: dimmbar
26room: Wohnzimmer
27  - name: Stehlampe
28type: farbe
29room: 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 Konfiguration ──
13http:
14  use_x_forwarded_for: true         # Nötig hinter Reverse Proxy
15  trusted_proxies:
16- 172.16.0.0/12                 # Docker-Netzwerk
17  ip_ban_enabled: true              # IP nach Fehlversuchen sperren
18  login_attempts_threshold: 5       # Nach 5 Fehlversuchen
19
20# ── Recorder-Einstellungen ──
21recorder:
22  purge_keep_days: 7                # Verlaufsdaten 7 Tage behalten
23  exclude:
24domains:
25  - media_player
26  - weather
27entity_globs:
28  - sensor.sun_*
29
30# ── Logger-Einstellungen ──
31logger:
32  default: warning                  # Standard-Level
33  logs:
34homeassistant.components.mqtt: debug
35custom_components: info
36
37# ── Eigene Template-Sensoren ──
38template:
39  - sensor:
40  - name: "Durchschnittstemperatur"
41    unit_of_measurement: "°C"
42    state: >
43      {{ ((states('sensor.wohnzimmer_temp') | float(0)) +
44          (states('sensor.schlafzimmer_temp') | float(0))) / 2 | round(1) }}
45
46# ── Dateien aufteilen ──
47automation: !include automations.yaml
48scene: !include scenes.yaml
49script: !include scripts.yaml

1# Aufgeteilte Konfiguration
2# configuration.yaml:
3automation: !include_dir_merge_list automations/
4
5# Dann erstellst du separate Dateien:
6# automations/licht.yaml:
7- alias: "Flur-Licht bei Bewegung"
8  trigger: ...
9  action: ...
10
11# automations/heizung.yaml:
12- alias: "Heizung morgens"
13  trigger: ...
14  action: ...

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
mqtt:
  broker: 192.168.1.100
  username: homeassistant
  password: !secret mqtt_password    # ← Liest aus secrets.yaml

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# Neue Template-Funktionen (ab 2026.4)
2
3# state_attr_translated() — Gibt übersetzte Attributwerte zurück
4# Praktisch für Lüftermodi, HVAC-Aktionen, Preset-Modi etc.
5{{ state_attr_translated('climate.wohnzimmer', 'hvac_action') }}
6# → "Heizen" (statt "heating")
7
8{{ state_attr_translated('fan.ventilator', 'preset_mode') }}
9# → "Automatisch" (statt "auto")
10
11# entity_name() — Gibt den Anzeigenamen einer Entity zurück
12# Seit 2026.4 enthalten Entity-Namen immer den Gerätenamen als Präfix
13{{ entity_name('sensor.wohnzimmer_multisensor_temperatur') }}
14# → "Wohnzimmer Multisensor Temperatur"
15
16# Nützlich in Benachrichtigungen:
17# 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    trigger:
16      - platform: state
17        entity_id: sensor.waschmaschine_status
18        from: "Waschen"
19        to: "Standby"
20        for: "00:02:00"
21    action:
22      - service: 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      trigger:
6        - platform: state
7          entity_id: binary_sensor.jemand_zuhause
8          to: "off"
9      action:
10        - service: 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"
11action:
12  - service: 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"
19action:
20  - service: 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"
4trigger:
5  - platform: state
6    entity_id: binary_sensor.flur_motion
7    to: "on"
8action:
9  - service: 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 %}