159 lines
3.6 KiB
Markdown
159 lines
3.6 KiB
Markdown
# PDF zu ICS Konverter - Dienstplan Importer
|
|
|
|
Dieses Tool extrahiert Kalenderdaten aus Dienstplan-PDFs und konvertiert sie in das iCalendar-Format (ICS), das in gängigen Kalender-Apps importiert werden kann.
|
|
|
|
## 🎯 Varianten
|
|
|
|
### 1) GUI (empfohlen)
|
|
Native Oberfläche mit wxPython:
|
|
|
|
```bash
|
|
./start_gui.sh
|
|
```
|
|
|
|
**Highlights:**
|
|
- Drag & Drop für PDFs
|
|
- Mehrere PDFs gleichzeitig
|
|
- Frei wählbares Ausgabe-Verzeichnis
|
|
- Live-Log mit Fortschritt
|
|
- Optionale Filter:
|
|
- Ruhetage ausschließen
|
|
- Urlaub (060/0060) ausschließen
|
|
|
|
### 2) CLI
|
|
Interaktives Textmenü:
|
|
|
|
```bash
|
|
./start.sh
|
|
```
|
|
|
|
---
|
|
|
|
## ⚡ Schnellstart (60 Sekunden)
|
|
|
|
1. GUI starten (`./start_gui.sh` oder `start_gui.cmd` unter Windows)
|
|
2. PDF-Dateien hinzufügen
|
|
3. Optional Filter aktivieren
|
|
4. Auf **"ICS Datei erstellen"** klicken
|
|
|
|
---
|
|
|
|
## 🧩 Installation nach Betriebssystem
|
|
|
|
### Linux (Ubuntu/Debian/Mint)
|
|
|
|
```bash
|
|
./start_gui.sh
|
|
```
|
|
|
|
Beim ersten Start wird automatisch `.venv` erstellt und alles installiert.
|
|
|
|
Wenn `wxPython` nicht installiert werden kann, helfen häufig:
|
|
|
|
```bash
|
|
sudo apt-get update
|
|
sudo apt-get install -y build-essential python3-dev libgtk-3-dev libglib2.0-dev libjpeg-dev libtiff-dev libpng-dev
|
|
```
|
|
|
|
Für systemweite Installation mit Menüeintrag siehe [INSTALL.md](INSTALL.md).
|
|
|
|
### macOS
|
|
|
|
```bash
|
|
./start_gui.sh
|
|
```
|
|
|
|
Beim ersten Start wird `.venv` erstellt und die Abhängigkeiten werden installiert.
|
|
|
|
### Windows
|
|
|
|
1. Python 3.10+ installieren (Option **Add Python to PATH** aktivieren)
|
|
2. `start_gui.cmd` per Doppelklick starten
|
|
|
|
Beim ersten Start wird `.venv` automatisch eingerichtet.
|
|
|
|
---
|
|
|
|
## 🧱 Standalone-Apps (ohne Python beim Endnutzer)
|
|
|
|
Für Build/Packaging auf Linux, macOS und Windows:
|
|
|
|
- [BUILD_STANDALONE.md](BUILD_STANDALONE.md)
|
|
|
|
Dort enthalten:
|
|
- Build-Skripte pro OS
|
|
- Packaging-Skripte für Release-Artefakte
|
|
- empfohlene Release-Reihenfolge
|
|
|
|
---
|
|
|
|
## 🖥️ CLI-Nutzung
|
|
|
|
### Beispiele
|
|
|
|
```bash
|
|
# Alle PDFs im aktuellen Verzeichnis konvertieren
|
|
python3 pdf_to_ics.py
|
|
|
|
# Input/Output-Verzeichnis setzen
|
|
python3 pdf_to_ics.py --input ./pdfs --output ./ics_dateien
|
|
|
|
# Ruhetage ausschließen
|
|
python3 pdf_to_ics.py --exclude-rest
|
|
|
|
# Urlaub (060/0060) ausschließen
|
|
python3 pdf_to_ics.py --exclude-vacation
|
|
|
|
# Einzelne PDF-Datei
|
|
python3 pdf_to_ics.py /pfad/zur/datei.pdf
|
|
```
|
|
|
|
### Optionen
|
|
|
|
| Option | Kurzform | Beschreibung |
|
|
|--------|----------|-------------|
|
|
| `--input DIR` | `-i` | Eingabe-Verzeichnis mit PDF-Dateien (Standard: aktuelles Verzeichnis) |
|
|
| `--output DIR` | `-o` | Ausgabe-Verzeichnis für ICS-Dateien (Standard: Eingabe-Verzeichnis) |
|
|
| `--exclude-rest` | `-e` | Ruhetage ausschließen (Ruhe, R56, R36, vRWF48, RWE, vR48) |
|
|
| `--exclude-vacation` | `-u` | Urlaub ausschließen (060, 0060) |
|
|
| `--verbose` | `-v` | Detaillierte Ausgabe |
|
|
| `--help` | `-h` | Hilfe anzeigen |
|
|
|
|
---
|
|
|
|
## 📅 ICS-Import
|
|
|
|
Die erzeugten `.ics`-Dateien lassen sich u. a. in folgende Kalender importieren:
|
|
- Outlook
|
|
- Google Kalender
|
|
- Apple Kalender
|
|
- Thunderbird
|
|
- LibreOffice
|
|
- Android-Kalender-Apps
|
|
|
|
---
|
|
|
|
## 🛠️ Fehlerbehebung
|
|
|
|
- **Keine Events gefunden:** PDF-Layout prüfen
|
|
- **GUI startet nicht:** `.venv` löschen und neu starten
|
|
```bash
|
|
rm -rf .venv
|
|
./start_gui.sh
|
|
```
|
|
- **Zeitzone ändern:** in `pdf_to_ics.py` den Wert `Europe/Berlin` anpassen
|
|
|
|
---
|
|
|
|
## 📚 Weitere Dokumentation
|
|
|
|
- [INSTALL.md](INSTALL.md) - Linux-Installation mit Menüeintrag
|
|
- [WXPYTHON_README.md](WXPYTHON_README.md) - wxPython-spezifische Hinweise
|
|
- [BUILD_STANDALONE.md](BUILD_STANDALONE.md) - Standalone-Builds/Packaging
|
|
- [QUICKSTART.md](QUICKSTART.md) - Kurzanleitung Kalender-Import
|
|
- [ZUSAMMENFASSUNG.md](ZUSAMMENFASSUNG.md) - Projekt- und Changelog-Übersicht
|
|
|
|
## Lizenz
|
|
|
|
Dieses Tool ist zur privaten Verwendung gedacht.
|