260 lines
7.2 KiB
Markdown
260 lines
7.2 KiB
Markdown
# PDF zu ICS Konverter - Dienstplan Importer
|
|
|
|
Dieses Tool extrahiert Kalenderdaten aus Dienstplan-PDFs und konvertiert sie in das iCalendar-Format (ICS), das von den meisten Kalenderanwendungen importiert werden kann.
|
|
|
|
## 🎯 Zwei Versionen verfügbar
|
|
|
|
### 1. **GUI-Version** (Grafische Oberfläche) - Empfohlen!
|
|
Benutzerfreundliche grafische Oberfläche mit Drag & Drop Support.
|
|
|
|
```bash
|
|
./start_gui.sh
|
|
```
|
|
|
|
**Features:**
|
|
- ✨ Drag & Drop für PDF-Dateien
|
|
- 📋 Mehrere PDFs gleichzeitig verarbeiten
|
|
- 📁 Ausgabe-Verzeichnis frei wählbar
|
|
- 📊 Live-Log und Fortschrittsanzeige
|
|
- 💾 Merkt sich letzte Verzeichnisse
|
|
|
|
**Voraussetzung:** wxPython muss installiert sein (wird automatisch versucht; siehe [WXPYTHON_README.md](WXPYTHON_README.md))
|
|
|
|
### 2. **CLI-Version** (Kommandozeile)
|
|
Textbasiertes Menü für die Kommandozeile.
|
|
|
|
```bash
|
|
./start.sh
|
|
```
|
|
|
|
**Features:**
|
|
- ⚡ Funktioniert überall ohne zusätzliche Abhängigkeiten
|
|
- 🔄 Automatische Verarbeitung aller PDFs im Verzeichnis
|
|
- 📝 Textbasiertes interaktives Menü
|
|
|
|
## Features
|
|
|
|
✅ Extrahiert Dienstplan-Informationen aus PDFs
|
|
✅ Erkennt Schicht-Zeitangaben (z.B. 04:51-15:46)
|
|
✅ Handhabt Nachtschichten korrekt (über Mitternacht hinaus)
|
|
✅ Erstellt Standard-konforme ICS-Dateien
|
|
✅ Unterstützt mehrere PDFs gleichzeitig
|
|
✅ GUI mit Drag & Drop (optional)
|
|
✅ 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_wxpython.py
|
|
```
|
|
|
|
### Schnellstart (Empfohlen)
|
|
|
|
**Für GUI-Version:**
|
|
```bash
|
|
./start_gui.sh
|
|
```
|
|
Siehe [WXPYTHON_README.md](WXPYTHON_README.md) für wxPython-Hinweise.
|
|
|
|
**Für CLI-Version:**
|
|
```bash
|
|
./start.sh
|
|
```
|
|
|
|
### GUI-Version (Empfohlen)
|
|
|
|
1. Starten Sie die GUI:
|
|
```bash
|
|
./start_gui.sh
|
|
```
|
|
2. Fügen Sie PDF-Dateien hinzu (Button oder Drag & Drop).
|
|
3. Optional: Aktivieren Sie Filter wie „Ruhetage ausschließen“ und „Urlaub ausschließen (060, 0060)“.
|
|
4. Klicken Sie auf „📄 ICS Datei erstellen“.
|
|
|
|
Die GUI merkt sich Ihre letzten Verzeichnisse und Exportoptionen.
|
|
|
|
### CLI-Version
|
|
|
|
Starten Sie das interaktive Menü:
|
|
|
|
```bash
|
|
./start.sh
|
|
```
|
|
|
|
Beide Skripte erstellen automatisch eine Python Virtual Environment und installieren alle benötigten Abhängigkeiten.
|
|
|
|
### Manuelle Installation
|
|
|
|
|
|
Die erforderlichen Dependencies sind bereits installiert. Falls Sie das Projekt neu einrichten:
|
|
|
|
```bash
|
|
python3 -m venv .venv
|
|
source .venv/bin/activate
|
|
pip install pdfplumber icalendar pypdf2 pytz packaging
|
|
```
|
|
|
|
## Verwendung
|
|
|
|
### Schnellstart (CLI)
|
|
|
|
1. Kopieren Sie Ihre Dienstplan-PDF-Dateien in ein Verzeichnis
|
|
2. Führen Sie das Skript aus:
|
|
|
|
```bash
|
|
python3 pdf_to_ics.py
|
|
```
|
|
|
|
Das Tool findet automatisch alle `.pdf` Dateien im aktuellen Verzeichnis und erstellt entsprechende `.ics` Dateien.
|
|
|
|
### Kommandozeilen-Optionen
|
|
|
|
```bash
|
|
# Alle PDFs im aktuellen Verzeichnis konvertieren
|
|
python3 pdf_to_ics.py
|
|
|
|
# PDFs aus einem bestimmten Verzeichnis konvertieren
|
|
python3 pdf_to_ics.py --input ./pdfs
|
|
|
|
# PDFs in anderes Verzeichnis speichern
|
|
python3 pdf_to_ics.py --input ./pdfs --output ./ics_dateien
|
|
|
|
# Ruhetage ausschließen
|
|
python3 pdf_to_ics.py --exclude-rest
|
|
|
|
# Urlaub (060) ausschließen
|
|
python3 pdf_to_ics.py --exclude-vacation
|
|
|
|
# Einzelne PDF-Datei konvertieren
|
|
python3 pdf_to_ics.py /pfad/zur/datei.pdf
|
|
|
|
# Mit detaillierter Ausgabe
|
|
python3 pdf_to_ics.py --input ./pdfs -v
|
|
|
|
# Hilfe anzeigen
|
|
python3 pdf_to_ics.py --help
|
|
```
|
|
|
|
**Verfügbare 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 anzeigen |
|
|
| `--help` | `-h` | Hilfe anzeigen |
|
|
|
|
### Erweiterte Nutzung
|
|
|
|
Sie können auch direkt mit dem Python-Modul arbeiten:
|
|
|
|
```python
|
|
from pdf_to_ics import extract_dienstplan_data, create_ics_from_dienstplan
|
|
|
|
# PDF verarbeiten
|
|
dienstplan = extract_dienstplan_data('meine_pdf.pdf')
|
|
|
|
# ICS erstellen
|
|
create_ics_from_dienstplan(dienstplan, 'mein_kalender.ics')
|
|
```
|
|
|
|
## Dateiformat
|
|
|
|
### ICS-Datei importieren
|
|
|
|
Die erstellte `.ics` Datei kann in folgende Kalenderanwendungen importiert werden:
|
|
|
|
- **Outlook**: Datei → Öffnen und exportieren → Importieren
|
|
- **Google Kalender**: Einstellungen → Kalender importieren
|
|
- **iCal/macOS**: Doppelklick auf die .ics Datei
|
|
- **Thunderbird**: Kalender → Kalender importieren
|
|
- **Android**: Mit einer Kalender-App öffnen
|
|
- **LibreOffice**: Datei → Öffnen
|
|
|
|
## Struktur der extrahierten Daten
|
|
|
|
Das Tool extrahiert folgende Informationen aus der PDF:
|
|
|
|
- **Name und Personalnummer**: Des Mitarbeiters
|
|
- **Betriebshof**: Standort
|
|
- **Sollarbeitszeit**: Gewünschte Arbeitszeit pro Monat
|
|
- **Events**: Einzelne Schichten mit:
|
|
- Datum
|
|
- Dienstart (z.B. "36234", "Ruhe", "Dispo")
|
|
- Zeitangabe (falls vorhanden)
|
|
|
|
## Output
|
|
|
|
Für jede verarbeitete PDF wird eine entsprechende ICS-Datei erstellt:
|
|
|
|
```
|
|
2026-02-23 DB Köhler00100718_März2026.pdf → 2026-02-23 DB Köhler00100718_März2026.ics
|
|
```
|
|
|
|
Die ICS-Datei enthält ein Event für jeden Arbeitstag mit:
|
|
- **Titel**: Name - Dienstart
|
|
- **Beschreibung**: Dienstart und Betriebshof
|
|
- **Zeit**: Mit aktueller Zeitzone (Europe/Berlin)
|
|
|
|
## Fehlerbehebung
|
|
|
|
### Keine Events gefunden?
|
|
- Stellen Sie sicher, dass die PDF das erwartete Tabellenformat hat
|
|
- Überprüfen Sie die Dateiname und die PDF-Struktur
|
|
|
|
### Zeitzone falsch?
|
|
- Die aktuelle Einstellung ist Europe/Berlin
|
|
- Zum Ändern: Bearbeiten Sie die Zeile in `pdf_to_ics.py`:
|
|
```python
|
|
tz = pytz.timezone('Europe/Berlin') # Ändern SIe diesen Wert
|
|
```
|
|
|
|
## Technische Details
|
|
|
|
### Projektstruktur
|
|
|
|
```
|
|
ICS-Import/
|
|
├── pdf_to_ics.py # Core-Konvertierungslogik
|
|
├── gui_wxpython.py # GUI-Version (wxPython)
|
|
├── menu.py # CLI-Menü
|
|
├── start_gui.sh/cmd # GUI-Startskripte
|
|
├── start.sh/cmd # CLI-Startskripte
|
|
├── README.md # Diese Datei
|
|
└── WXPYTHON_README.md # GUI-spezifische Dokumentation
|
|
```
|
|
|
|
### Technische Spezifikationen
|
|
|
|
- **Abhängigkeiten**: pdfplumber, icalendar, pytz, pypdf2, packaging
|
|
- **Optional für GUI**: wxPython (native Oberfläche)
|
|
- **Python-Version**: 3.6+
|
|
- **Format**: iCalendar 2.0 (RFC 5545)
|
|
- **Konfiguration**: `~/.pdf_to_ics_config.json` (GUI-Einstellungen)
|
|
|
|
## Lizenz
|
|
|
|
Dieses Tool ist zur privaten Verwendung gedacht.
|
|
|
|
---
|
|
|
|
## 📚 Weitere Dokumentation
|
|
|
|
- **[WXPYTHON_README.md](WXPYTHON_README.md)** - Ausführliche GUI-Dokumentation und wxPython-Hinweise
|
|
- **[QUICKSTART.md](QUICKSTART.md)** - Schnellanleitung für den Import in verschiedene Kalender
|
|
- **[ZUSAMMENFASSUNG.md](ZUSAMMENFASSUNG.md)** - Projekt-Übersicht und technische Details
|