Initial commit: PDF zu ICS Konverter

README.md

@@ -0,0 +1,110 @@
+# 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.
+
+## 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
+✅ Benutzerfreundliche Oberfläche
+
+## 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
+```
+
+## Verwendung
+
+### Schnellstart
+
+1. Kopieren Sie Ihre Dienstplan-PDF-Dateien in dieses Verzeichnis
+2. Führen Sie das Skript aus:
+
+```bash
+python3 pdf_to_ics.py
+```
+
+Das Tool findet automatisch alle `.pdf` Dateien und erstellt entsprechende `.ics` Dateien.
+
+### 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
+
+- **Abhängigkeiten**: pdfplumber, icalendar, pytz, pypdf2
+- **Python-Version**: 3.6+
+- **Format**: iCalendar 2.0 (RFC 5545)
+
+## Lizenz
+
+Dieses Tool ist zur privaten Verwendung gedacht.