docs: improve Windows install and troubleshooting guide

This commit is contained in:
2026-02-24 14:10:27 +01:00
parent 4b18cd9495
commit 61971f2155
3 changed files with 36 additions and 3 deletions

View File

@@ -106,6 +106,18 @@ Dann Terminal neu laden:
source ~/.bashrc 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ü ### Anwendung erscheint nicht im Menü
Aktualisieren Sie die Desktop-Datenbank: Aktualisieren Sie die Desktop-Datenbank:
@@ -142,7 +154,7 @@ Die Installation ist nur für End-Benutzer gedacht.
## 🐧 Andere Betriebssysteme ## 🐧 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) - **macOS:** Nutzen Sie `start_gui.sh` (keine Installation nötig)
## 📞 Support ## 📞 Support

View File

@@ -6,11 +6,15 @@
**macOS/Linux:** **macOS/Linux:**
```bash ```bash
./start.sh ./start_gui.sh
``` ```
**Windows:** **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 ### 2. PDF-Dateien hinzufügen

View File

@@ -43,6 +43,23 @@ Textbasiertes Menü für die Kommandozeile.
✅ CLI-Menü für schnelle Nutzung ✅ CLI-Menü für schnelle Nutzung
## Installation ## 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) ### Schnellstart (Empfohlen)
**Für GUI-Version:** **Für GUI-Version:**