diff --git a/README.md b/README.md
index f57cb09..d531e00 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,71 @@
-# VitosUpdater
-
-VitosUpdater ist ein Windows-Programm zum Suchen, Installieren, Aktualisieren und Deinstallieren von Software über mehrere Paketmanager (WinGet und weitere). Die Oberfläche ist vollständig deutsch.
-
-Dieses Repository enthält keinen Quellcode. Die Installer stehen unter [Releases](../../releases). Das Programm aktualisiert sich selbst über die Datei `latest.json` des Releases „latest“.
+# VitosUpdater
+
+**Software unter Windows an einem Ort suchen, installieren, aktualisieren und deinstallieren – über neun Paketmanager, komplett auf Deutsch.**
+
+VitosUpdater ist eine moderne Desktop-Anwendung für Windows 10/11 (Tauri 2, Rust, Svelte). Sie bündelt WinGet, Scoop, Chocolatey und weitere Paketmanager in einer einheitlichen Oberfläche.
+
+## Download
+
+➡️ **[Neueste Version herunterladen (Releases)](https://gitea.davito.synology.me/Davito/VitosUpdater/releases/tag/latest)**
+
+Den Installer `VitosUpdater_x.y.z_x64-setup.exe` ausführen. Weitere Versionen stehen unter [Releases](https://gitea.davito.synology.me/Davito/VitosUpdater/releases). Die Anwendung aktualisiert sich danach selbst.
+
+## Funktionen
+
+### Unterstützte Paketmanager
+| Manager | Hinweis |
+|---|---|
+| **WinGet** | inklusive Microsoft Store, Quellenverwaltung |
+| **Scoop** | inklusive Buckets |
+| **Chocolatey** | inklusive Quellen |
+| **Pip** | Python-Pakete |
+| **npm** | globale Node.js-Pakete |
+| **.NET-Tool** | globale dotnet-Tools |
+| **PowerShell-Katalog** | PowerShell-Module |
+| **Cargo** | Rust-Programme |
+| **Vcpkg** | C/C++-Bibliotheken |
+
+Jeder Manager lässt sich einzeln ein- oder ausschalten, mit eigenem Pfad versehen und zeigt seine Version. Fällt ein Manager aus, bleiben die Listen der anderen nutzbar.
+
+### Ansichten
+- **Pakete entdecken** – Suche über alle Manager, Filter nach Manager und Quelle, Mehrfachauswahl, Detailpanel; ohne Suche die **Top 100 der beliebtesten Pakete**
+- **Software-Updates** – alle, ausgewählte oder einzelne Pakete aktualisieren, optional mit Administratorrechten; Zähler in Seitenleiste und Tray
+- **Installierte Pakete** – filtern, deinstallieren, neu installieren, reparieren
+- **Paket-Bundles** – Pakete sammeln, als `.json`/`.yaml` importieren und exportieren, komplett installieren
+- **Warteschlange** – Live-Konsolenausgabe, Abbrechen, Wiederholen, Verlauf, „Nach Abschluss“: Herunterfahren oder Neustart
+- **Einstellungen** – Allgemein, Erscheinungsbild, Paketmanager, Quellen, automatische Suche, Sicherung, Protokolle, Über
+
+### Installationsoptionen (pro Paket gemerkt)
+Version, Architektur (x86/x64/ARM64), Bereich (Benutzer/Computer), Administratorrechte (UAC), interaktive Installation, Prüfsumme überspringen, Installationsort, zusätzliche Parameter, Befehle vor/nach dem Vorgang, vorherige Version deinstallieren, Dateien beim Deinstallieren löschen.
+
+### Automatisierung und Alltag
+- **Automatische Update-Suche** im Intervall, auch im Tray; optional mit automatischer Installation
+- Überspringen bei **getakteter Verbindung** oder im **Akkubetrieb**
+- **Tray-Symbol** mit Menü; Minimieren und Schließen in den Tray; Start mit Windows (optional minimiert)
+- **Moderne Windows-Benachrichtigungen** mit Schaltflächen
+- **Ignorierliste**: „Keine Updates suchen“ pro Paket
+- **Kommandozeile:** `--daemon`, `--update-all`, `--import-bundle <Datei>`
+- **Sicherung** der installierten Pakete als Datei oder in einem privaten GitHub-Gist (Token im Windows-Anmeldeinformationsspeicher)
+- Paketseite öffnen, Paketlink kopieren
+- **Protokollbetrachter** in den Einstellungen
+
+### Selbst-Update
+VitosUpdater prüft beim Start und danach im einstellbaren Intervall (Standard 30 Minuten) auf neue Versionen. Updates sind signiert und werden vor der Installation geprüft. Ein Dialog zeigt Versionsnummer, Release-Notizen und Größe; „Später erinnern“ und „Diese Version überspringen“ sind möglich.
+
+### Oberfläche
+Dunkles Design als Standard, optional hell oder dem System folgend, wählbare Akzentfarbe, flüssige virtualisierte Tabellen (auch mit mehreren tausend Zeilen), vollständig deutsch, ohne externe Netzwerkabhängigkeiten für die Oberfläche.
+
+## Voraussetzungen
+- Windows 10 oder 11, WebView2-Laufzeit (bei Windows 11 vorhanden)
+- Die gewünschten Paketmanager müssen installiert sein. WinGet wird nicht mitgeliefert; fehlt es, bietet VitosUpdater die Installation des „App-Installers“ an.
+
+## Selbst-Update und Zertifikat
+Der Update-Server ist dieses Gitea. Wird dessen Zertifikat von Windows nicht als vertrauenswürdig eingestuft, zeigt VitosUpdater eine deutsche Fehlermeldung. Die TLS-Prüfung wird nie abgeschaltet; stattdessen das Zertifikat in den Windows-Speicher „Vertrauenswürdige Stammzertifizierungsstellen“ importieren.
+
+## Hinweise zum Stand
+Mit echten Daten getestet: WinGet, Pip, npm, Cargo, PowerShell-Katalog. Scoop, Chocolatey, Vcpkg und .NET-Tool sind nach der Dokumentation umgesetzt, aber noch nicht mit echten Installationen geprüft.
+
+## Technik
+Rust · Tauri 2 · Svelte 5 · TypeScript · Tailwind CSS 4
+
+Dieses Repository enthält bewusst nur die Beschreibung und die Releases mit Installern.