From 61971f215568b8e8e95875d81639b130c4b00304 Mon Sep 17 00:00:00 2001
From: webfarben <kontakt@webfarben.net>
Date: Tue, 24 Feb 2026 14:10:27 +0100
Subject: [PATCH] docs: improve Windows install and troubleshooting guide

---
 INSTALL.md    | 14 +++++++++++++-
 QUICKSTART.md |  8 ++++++--
 README.md     | 17 +++++++++++++++++
 3 files changed, 36 insertions(+), 3 deletions(-)

diff --git a/INSTALL.md b/INSTALL.md
index 050a18c..7fe8071 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -106,6 +106,18 @@ Dann Terminal neu laden:
 source ~/.bashrc
 ```
 
+### Windows: "python" oder "python3" wurde nicht gefunden
+
+1. Installieren Sie Python 3.10+ von python.org und aktivieren Sie beim Setup **"Add Python to PATH"**.
+2. Öffnen Sie danach eine neue Eingabeaufforderung im Projektordner.
+3. Führen Sie aus:
+
+```bat
+py -3 -m venv .venv --upgrade-deps
+.\.venv\Scripts\python.exe -m pip install -q pdfplumber icalendar pypdf2 pytz
+.\.venv\Scripts\pythonw.exe gui.py
+```
+
 ### Anwendung erscheint nicht im Menü
 
 Aktualisieren Sie die Desktop-Datenbank:
@@ -142,7 +154,7 @@ Die Installation ist nur für End-Benutzer gedacht.
 
 ## 🐧 Andere Betriebssysteme
 
-- **Windows:** Nutzen Sie `start_gui.cmd` (keine Installation nötig)
+- **Windows:** Nutzen Sie `start_gui.cmd` (Python 3.10+ erforderlich, Einrichtung beim ersten Start erfolgt automatisch)
 - **macOS:** Nutzen Sie `start_gui.sh` (keine Installation nötig)
 
 ## 📞 Support
diff --git a/QUICKSTART.md b/QUICKSTART.md
index 8342725..fbb06bc 100644
--- a/QUICKSTART.md
+++ b/QUICKSTART.md
@@ -6,11 +6,15 @@
 
 **macOS/Linux:**
 ```bash
-./start.sh
+./start_gui.sh
 ```
 
 **Windows:**
-Doppelklick auf `start.cmd`
+Doppelklick auf `start_gui.cmd` (empfohlen)
+
+Beim ersten Start werden Python-Umgebung (`.venv`) und Abhängigkeiten automatisch eingerichtet.
+
+Alternative (CLI): Doppelklick auf `start.cmd`
 
 ### 2. PDF-Dateien hinzufügen
 
diff --git a/README.md b/README.md
index ef3f567..af64e1e 100644
--- a/README.md
+++ b/README.md
@@ -43,6 +43,23 @@ Textbasiertes Menü für die Kommandozeile.
 ✅ CLI-Menü für schnelle Nutzung
 
 ## Installation
+### Windows (Empfohlen)
+
+1. Installieren Sie **Python 3.10+** und aktivieren Sie bei der Installation die Option **"Add Python to PATH"**.
+2. Öffnen Sie den Projektordner.
+3. Starten Sie die GUI per Doppelklick auf `start_gui.cmd`.
+
+Beim ersten Start wird automatisch eine virtuelle Umgebung (`.venv`) erstellt und alle benötigten Pakete installiert.
+
+**Alternative (CLI):** Doppelklick auf `start.cmd`.
+
+**Falls Python nicht gefunden wird (CMD im Projektordner):**
+
+```bat
+py -3 -m venv .venv --upgrade-deps
+.\.venv\Scripts\python.exe gui.py
+```
+
 ### Schnellstart (Empfohlen)
 
 **Für GUI-Version:**