diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b3bec64
--- /dev/null
+++ b/README.md
@@ -0,0 +1,108 @@
+# Better Thermostat Multi-Mode Controller
+
+Home Assistant Blueprint für intelligente Heizungssteuerung mit Better Thermostat, automatischer Sommer/Winter-Umschaltung und Zeitplänen.
+
+## Features
+
+- **Automatische Sommer/Winter-Umschaltung** basierend auf aktueller Außentemperatur
+- **Tagesabhängige Heizpläne** via Schedule-Helper (z.B. Morgen 7-9 Uhr: 21°C, Tag: 19°C)
+- **Urlaubsmodus** mit Frostschutztemperatur (z.B. 16°C)
+- **Better Thermostat Integration** nutzt bereits SHT31-Sensoren, Fenstersensoren und Homematic IP Thermostate
+- **Automatische Prüfung** alle 30 Minuten + bei Änderungen
+
+## Voraussetzungen
+
+- Home Assistant mit Better Thermostat Integration installiert (HACS)
+- Homematic IP Thermostat via CCU3 eingebunden
+- SHT31 Temperatursensor oder ähnliches als `room_sensor` in Better Thermostat konfiguriert
+- Fenstersensor als `window_sensor` in Better Thermostat konfiguriert
+- Weather-Integration (z.B. `weather.openweathermap` oder `weather.schleswig`)
+
+## Installation
+
+### 1. Blueprint importieren
+Einstellungen > Automatisierungen > Blueprints (oben rechts)
+
+Blueprint importieren > YAML einfügen
+
+### 2. Helfer erstellen
+**Schedule-Helper für Heizplan:**
+
+Einstellungen > Geräte & Dienste > Helfer > Zeitplan
+Name: Heizzeitplan Wohnzimmer
+Zeitfenster: z.B. Mo-Fr 7:00-9:00, 17:00-22:00
+
+**Urlaubsmodus-Button:**
+
+Einstellungen > Geräte & Dienste > Helfer > Umschalter (Boolean)
+Name: Urlaubsmodus Heizung
+
+### 3. Automation erstellen
+
+Einstellungen > Automatisierungen > Neue Automation
+
+Better Thermostat Multi-Mode Controller auswählen
+
+
+## Konfiguration
+
+### Entities zuweisen
+- **Better Thermostat Entity**: `climate.wohnzimmer_bt`
+- **Heizzeitplan Schedule**: `schedule.heizzeitplan_wohnzimmer`
+- **Urlaubsmodus Helper**: `input_boolean.urlaub`
+- **Wettervorhersage**: `weather.schleswig`
+
+### Temperaturen anpassen
+- **Sommer-Schwellwert**: 20°C (Heizung aus wenn wärmer)
+- **Winter-Schwellwert**: 10°C (Heizen wenn kälter)
+- **Eco Temperatur**: 16°C (Urlaub/Nacht)
+- **Komfort Temperatur**: 20-21°C (Schedule aktiv)
+
+## Funktionsweise
+
+### Prioritäten (von oben nach unten)
+1. **Sommer-Modus** (Temp > 20°C) → Heizung OFF
+2. **Urlaubsmodus** (Button ON) → 16°C Eco
+3. **Winter + Schedule aktiv** (Temp < 10°C + Zeitplan) → 20°C Komfort
+4. **Winter ohne Schedule** (Temp < 10°C) → 18°C (Eco+2)
+
+### Beispiel-Tag im Winter (5°C außen)
+- **07:00 Uhr**: Schedule startet → 20°C
+- **09:00 Uhr**: Schedule endet → 18°C
+- **17:00 Uhr**: Schedule startet → 20°C
+- **22:00 Uhr**: Schedule endet → 18°C
+
+## Anpassung für mehrere Räume
+
+Erstelle pro Raum:
+- Eigenen Schedule-Helper (`schedule.heizzeitplan_schlafzimmer`)
+- Eigene Automation mit Blueprint (selbe Wetter/Urlaubs-Entity nutzbar)
+- Separate Better Thermostat Entity (`climate.schlafzimmer_bt`)
+
+## Troubleshooting
+
+### "None has no element 0" Fehler
+Alte Forecast-API → Nutze aktuelle Temperatur statt Forecast.
+**Fix**: Zeile `weather_temp` anpassen (siehe Blueprint Code Zeile 82)
+
+### Heizung reagiert nicht
+1. Prüfe Better Thermostat Config: `room_sensor` + `window_sensor` gesetzt?
+2. Trace anschauen: Automation > Drei-Punkte > Traces
+3. Template testen: Entwicklertools > Template > `{{ state_attr('weather.schleswig', 'temperature') }}`
+
+### Falsche Temperaturen
+- Better Thermostat kalibrieren: Offset in BT-Config prüfen
+- SHT31 vs. Homematic-Sensor: BT nutzt externen Sensor, Thermostat zeigt evtl. eigenen Wert
+
+## Quellen & Credits
+
+- Better Thermostat: https://better-thermostat.org
+- GitHub: https://github.com/KartoffelToby/better_thermostat
+- Homematic Integration: https://www.home-assistant.io/integrations/homematic
+
+## Version
+
+v1.0 - Januar 2026
+- Initiale Version mit Sommer/Winter/Urlaub-Modi
+- Aktuelle Temperatur statt Forecast (HA 2023.9+ kompatibel)
+