diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..7807808
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,30 @@
+# RustDesk Adressbuch - Heartbeat Client 💓
+
+Dieses Skript meldet den aktuellen Online-Status (Heartbeat) deines Windows-Clients automatisch jede Minute an dein zentrales RustDesk Adressbuch-Dashboard. So siehst du jederzeit auf einen Blick, ob ein Gerät erreichbar ist (🟢) oder nicht (🔴).
+
+## 🚀 Schnelle Installation (One-Liner)
+
+Kopiere einfach den folgenden Befehl, öffne eine **PowerShell** und drücke Enter. Das Setup fordert automatisch Administratorrechte an (falls nötig), lädt die Skripte herunter und richtet alles ein.
+
+```powershell
+irm "https://me-gitea.maieredv.cloud/manuel.maier/RD-Adressbook-Heartbeat/raw/branch/main/install_rd-heartbeat.ps1" | iex
+```
+
+## 🛠️ Was passiert bei der Installation?
+
+1. **Verzeichnis:** Es wird der Ordner `C:\Program Files\RD-Addressbook-Heartbeat` erstellt.
+2. **Download:** Das aktuellste Heartbeat-Skript wird direkt von Gitea heruntergeladen und im neuen Ordner abgelegt.
+3. **Autostart & Task:** Es wird ein geplanter Task (`RustDesk Heartbeat`) als lokales `SYSTEM`-Konto eingerichtet.
+   * Das Skript startet dadurch komplett **unsichtbar** im Hintergrund (keine störenden Popups).
+   * Es wird automatisch bei jedem Systemstart ausgeführt.
+   * Es wiederholt sich ab dann kontinuierlich **jede Minute**.
+4. **Intelligente ID-Erkennung:** Das Skript sucht selbstständig nach der Installation von RustDesk und liest die ID direkt über das Programm (`rustdesk.exe --get-id`) aus. Es muss nichts manuell konfiguriert werden.
+
+## 🗑️ Deinstallation
+
+Falls du den Heartbeat-Client wieder entfernen möchtest, führe einfach diese beiden Befehle in einer administrativen PowerShell aus:
+
+```powershell
+Unregister-ScheduledTask -TaskName "RustDesk Heartbeat" -Confirm:$false
+Remove-Item -Path "$env:ProgramFiles\RD-Addressbook-Heartbeat" -Recurse -Force
+```
\ No newline at end of file