4 Commits

11 changed files with 408 additions and 185 deletions

6
.gitignore vendored
View File

@@ -3,3 +3,9 @@
.venv/ .venv/
__pycache__/ __pycache__/
.pdf_to_ics_config.json .pdf_to_ics_config.json
# Build artifacts
dist/
release/
*.spec
build/PDFtoICS/

147
BUILD_STANDALONE.md Normal file
View File

@@ -0,0 +1,147 @@
# Standalone Builds (Linux, macOS, Windows)
Diese Anleitung erstellt eigenständige Anwendungen mit **PyInstaller** auf dem jeweiligen Zielbetriebssystem.
## Wichtig
- Builds müssen **nativ pro OS** erstellt werden (kein Cross-Compile mit diesen Skripten).
- Verwenden Sie eine aktive und funktionierende `.venv` im Projektordner.
- Die GUI wird aus `gui_wxpython.py` gebaut.
---
## Release auf einen Blick
### Linux
```bash
./build/build_linux.sh
./build/package_linux.sh
```
### macOS
```bash
./build/build_macos.sh
./build/package_macos.sh
```
### Windows
```cmd
build\build_windows.cmd
build\package_windows.cmd
```
---
## Empfohlene Release-Reihenfolge
1. Version erhöhen (z. B. `version.txt` und Changelog)
2. Pro Zielplattform Build + Packaging ausführen
3. Artefakte im `release/`-Ordner prüfen
4. Git-Commit erstellen und Tag setzen (z. B. `v1.2.0`)
5. Tag und Branch pushen
6. Release-Artefakte auf der Release-Seite hochladen
Beispiel Git-Workflow:
```bash
git add -A
git commit -m "Release x.y.z"
git tag -a vx.y.z -m "vx.y.z"
git push origin main
git push origin vx.y.z
```
---
## Linux
```bash
chmod +x build/build_linux.sh
./build/build_linux.sh
```
Ergebnis:
- `dist/PDFtoICS/` (Ordner mit ausführbarer Datei)
Optional als Release-Archiv (`.tar.gz`) verpacken:
```bash
chmod +x build/package_linux.sh
./build/package_linux.sh
```
Ergebnis:
- `release/PDFtoICS-linux-v<VERSION>.tar.gz`
---
## macOS
```bash
chmod +x build/build_macos.sh
./build/build_macos.sh
```
Ergebnis:
- `dist/PDFtoICS.app`
Hinweis:
- Für öffentliche Verteilung ist Code-Signing/Notarisierung empfohlen.
Optional als Release-Archiv (`.zip`) verpacken:
```bash
chmod +x build/package_macos.sh
./build/package_macos.sh
```
Ergebnis:
- `release/PDFtoICS-macos-v<VERSION>.zip`
---
## Windows
Starten Sie unter Windows:
```cmd
build\build_windows.cmd
```
Ergebnis:
- `dist\PDFtoICS\PDFtoICS.exe`
Hinweis:
- Für weniger SmartScreen-Warnungen ist Signierung empfohlen.
Optional als Release-Archiv (`.zip`) verpacken:
```cmd
build\package_windows.cmd
```
Ergebnis:
- `release\PDFtoICS-windows-v<VERSION>.zip`
---
## Clean Build
PyInstaller erstellt `build/` und `dist/` sowie eine `.spec` Datei im Projektverzeichnis.
Optionales Aufräumen:
```bash
rm -rf build dist *.spec
```
Unter Windows:
```cmd
rmdir /s /q build
rmdir /s /q dist
del /q *.spec
```

261
README.md
View File

@@ -1,153 +1,114 @@
# PDF zu ICS Konverter - Dienstplan Importer # 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. Dieses Tool extrahiert Kalenderdaten aus Dienstplan-PDFs und konvertiert sie in das iCalendar-Format (ICS), das in gängigen Kalender-Apps importiert werden kann.
## 🎯 Zwei Versionen verfügbar ## 🎯 Varianten
### 1. **GUI-Version** (Grafische Oberfläche) - Empfohlen! ### 1) GUI (empfohlen)
Benutzerfreundliche grafische Oberfläche mit Drag & Drop Support. Native Oberfläche mit wxPython:
```bash ```bash
./start_gui.sh ./start_gui.sh
``` ```
**Features:** **Highlights:**
- Drag & Drop für PDF-Dateien - Drag & Drop für PDFs
- 📋 Mehrere PDFs gleichzeitig verarbeiten - Mehrere PDFs gleichzeitig
- 📁 Ausgabe-Verzeichnis frei wählbar - Frei wählbares Ausgabe-Verzeichnis
- 📊 Live-Log und Fortschrittsanzeige - Live-Log mit Fortschritt
- 💾 Merkt sich letzte Verzeichnisse - Optionale Filter:
- Ruhetage ausschließen
- Urlaub (060/0060) ausschließen
**Voraussetzung:** wxPython muss installiert sein (wird automatisch versucht; siehe [WXPYTHON_README.md](WXPYTHON_README.md)) ### 2) CLI
Interaktives Textmenü:
### 2. **CLI-Version** (Kommandozeile)
Textbasiertes Menü für die Kommandozeile.
```bash ```bash
./start.sh ./start.sh
``` ```
**Features:** ---
- ⚡ Funktioniert überall ohne zusätzliche Abhängigkeiten
- 🔄 Automatische Verarbeitung aller PDFs im Verzeichnis
- 📝 Textbasiertes interaktives Menü
## Features ## ⚡ Schnellstart (60 Sekunden)
✅ Extrahiert Dienstplan-Informationen aus PDFs 1. GUI starten (`./start_gui.sh` oder `start_gui.cmd` unter Windows)
✅ Erkennt Schicht-Zeitangaben (z.B. 04:51-15:46) 2. PDF-Dateien hinzufügen
✅ Handhabt Nachtschichten korrekt (über Mitternacht hinaus) 3. Optional Filter aktivieren
✅ Erstellt Standard-konforme ICS-Dateien 4. Auf **"ICS Datei erstellen"** klicken
✅ 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"**. ## 🧩 Installation nach Betriebssystem
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. ### Linux (Ubuntu/Debian/Mint)
**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 ```bash
./start_gui.sh ./start_gui.sh
``` ```
Siehe [WXPYTHON_README.md](WXPYTHON_README.md) für wxPython-Hinweise.
**Für CLI-Version:** Beim ersten Start wird automatisch `.venv` erstellt und alles installiert.
Wenn `wxPython` nicht installiert werden kann, helfen häufig:
```bash ```bash
./start.sh 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
``` ```
### GUI-Version (Empfohlen) Für systemweite Installation mit Menüeintrag siehe [INSTALL.md](INSTALL.md).
### macOS
1. Starten Sie die GUI:
```bash ```bash
./start_gui.sh ./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. Beim ersten Start wird `.venv` erstellt und die Abhängigkeiten werden installiert.
### CLI-Version ### Windows
Starten Sie das interaktive Menü: 1. Python 3.10+ installieren (Option **Add Python to PATH** aktivieren)
2. `start_gui.cmd` per Doppelklick starten
```bash Beim ersten Start wird `.venv` automatisch eingerichtet.
./start.sh
```
Beide Skripte erstellen automatisch eine Python Virtual Environment und installieren alle benötigten Abhängigkeiten. ---
### Manuelle Installation ## 🧱 Standalone-Apps (ohne Python beim Endnutzer)
Für Build/Packaging auf Linux, macOS und Windows:
Die erforderlichen Dependencies sind bereits installiert. Falls Sie das Projekt neu einrichten: - [BUILD_STANDALONE.md](BUILD_STANDALONE.md)
```bash Dort enthalten:
python3 -m venv .venv - Build-Skripte pro OS
source .venv/bin/activate - Packaging-Skripte für Release-Artefakte
pip install pdfplumber icalendar pypdf2 pytz packaging - empfohlene Release-Reihenfolge
```
## Verwendung ---
### Schnellstart (CLI) ## 🖥️ CLI-Nutzung
1. Kopieren Sie Ihre Dienstplan-PDF-Dateien in ein Verzeichnis ### Beispiele
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 ```bash
# Alle PDFs im aktuellen Verzeichnis konvertieren # Alle PDFs im aktuellen Verzeichnis konvertieren
python3 pdf_to_ics.py python3 pdf_to_ics.py
# PDFs aus einem bestimmten Verzeichnis konvertieren # Input/Output-Verzeichnis setzen
python3 pdf_to_ics.py --input ./pdfs
# PDFs in anderes Verzeichnis speichern
python3 pdf_to_ics.py --input ./pdfs --output ./ics_dateien python3 pdf_to_ics.py --input ./pdfs --output ./ics_dateien
# Ruhetage ausschließen # Ruhetage ausschließen
python3 pdf_to_ics.py --exclude-rest python3 pdf_to_ics.py --exclude-rest
# Urlaub (060) ausschließen # Urlaub (060/0060) ausschließen
python3 pdf_to_ics.py --exclude-vacation python3 pdf_to_ics.py --exclude-vacation
# Einzelne PDF-Datei konvertieren # Einzelne PDF-Datei
python3 pdf_to_ics.py /pfad/zur/datei.pdf 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:** ### Optionen
| Option | Kurzform | Beschreibung | | Option | Kurzform | Beschreibung |
|--------|----------|-------------| |--------|----------|-------------|
@@ -155,105 +116,43 @@ python3 pdf_to_ics.py --help
| `--output DIR` | `-o` | Ausgabe-Verzeichnis für ICS-Dateien (Standard: Eingabe-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-rest` | `-e` | Ruhetage ausschließen (Ruhe, R56, R36, vRWF48, RWE, vR48) |
| `--exclude-vacation` | `-u` | Urlaub ausschließen (060, 0060) | | `--exclude-vacation` | `-u` | Urlaub ausschließen (060, 0060) |
| `--verbose` | `-v` | Detaillierte Ausgabe anzeigen | | `--verbose` | `-v` | Detaillierte Ausgabe |
| `--help` | `-h` | Hilfe anzeigen | | `--help` | `-h` | Hilfe anzeigen |
### Erweiterte Nutzung ---
Sie können auch direkt mit dem Python-Modul arbeiten: ## 📅 ICS-Import
```python Die erzeugten `.ics`-Dateien lassen sich u. a. in folgende Kalender importieren:
from pdf_to_ics import extract_dienstplan_data, create_ics_from_dienstplan - Outlook
- Google Kalender
- Apple Kalender
- Thunderbird
- LibreOffice
- Android-Kalender-Apps
# PDF verarbeiten ---
dienstplan = extract_dienstplan_data('meine_pdf.pdf')
# ICS erstellen ## 🛠️ Fehlerbehebung
create_ics_from_dienstplan(dienstplan, 'mein_kalender.ics')
- **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
## 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 ## 📚 Weitere Dokumentation
- **[WXPYTHON_README.md](WXPYTHON_README.md)** - Ausführliche GUI-Dokumentation und wxPython-Hinweise - [INSTALL.md](INSTALL.md) - Linux-Installation mit Menüeintrag
- **[QUICKSTART.md](QUICKSTART.md)** - Schnellanleitung für den Import in verschiedene Kalender - [WXPYTHON_README.md](WXPYTHON_README.md) - wxPython-spezifische Hinweise
- **[ZUSAMMENFASSUNG.md](ZUSAMMENFASSUNG.md)** - Projekt-Übersicht und technische Details - [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.

View File

@@ -164,6 +164,23 @@ Jedes Event in der ICS-Datei:
## 📝 Changelog (März 2026) ## 📝 Changelog (März 2026)
### v1.2.2
- README grundlegend strukturiert und bereinigt
- Installationshinweise nach Betriebssystem ergänzt (Linux, macOS, Windows)
- Standalone-Hinweise im README klar hervorgehoben
- Schnellstart und Troubleshooting kompakter und ohne Redundanzen
### v1.2.1
- Standalone-Build-Workflow mit PyInstaller ergänzt (`build/build_*.{sh,cmd}`)
- Packaging-Skripte für Release-Artefakte ergänzt:
- Linux: `.tar.gz`
- macOS: `.zip`
- Windows: `.zip`
- Neue Build-Dokumentation `BUILD_STANDALONE.md`
- `.gitignore` um Build-Artefakte erweitert (`dist/`, `release/`, `*.spec`, `build/PDFtoICS/`)
### v1.2.0 ### v1.2.0
- GUI-Technik vollständig auf **wxPython** umgestellt - GUI-Technik vollständig auf **wxPython** umgestellt

27
build/build_linux.sh Executable file
View File

@@ -0,0 +1,27 @@
#!/bin/bash
set -euo pipefail
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
cd "$ROOT_DIR"
PYTHON_BIN="${PYTHON_BIN:-.venv/bin/python}"
if [ ! -x "$PYTHON_BIN" ]; then
echo "❌ Python nicht gefunden: $PYTHON_BIN"
echo "💡 Erwartet wird eine Virtual Environment unter .venv"
exit 1
fi
echo "🐧 Erstelle Linux-Standalone mit PyInstaller..."
"$PYTHON_BIN" -m pip install --upgrade pip pyinstaller
"$PYTHON_BIN" -m PyInstaller \
--noconfirm \
--clean \
--name "PDFtoICS" \
--windowed \
--add-data "version.txt:." \
gui_wxpython.py
echo "✅ Fertig: dist/PDFtoICS"

27
build/build_macos.sh Normal file
View File

@@ -0,0 +1,27 @@
#!/bin/bash
set -euo pipefail
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
cd "$ROOT_DIR"
PYTHON_BIN="${PYTHON_BIN:-.venv/bin/python}"
if [ ! -x "$PYTHON_BIN" ]; then
echo "❌ Python nicht gefunden: $PYTHON_BIN"
echo "💡 Erwartet wird eine Virtual Environment unter .venv"
exit 1
fi
echo "🍎 Erstelle macOS-Standalone mit PyInstaller..."
"$PYTHON_BIN" -m pip install --upgrade pip pyinstaller
"$PYTHON_BIN" -m PyInstaller \
--noconfirm \
--clean \
--name "PDFtoICS" \
--windowed \
--add-data "version.txt:." \
gui_wxpython.py
echo "✅ Fertig: dist/PDFtoICS.app"

24
build/build_windows.cmd Normal file
View File

@@ -0,0 +1,24 @@
@echo off
setlocal
cd /d "%~dp0\.."
set "PYTHON_BIN=.venv\Scripts\python.exe"
if not exist "%PYTHON_BIN%" (
echo ❌ Python nicht gefunden: %PYTHON_BIN%
echo 💡 Erwartet wird eine Virtual Environment unter .venv
exit /b 1
)
echo 🪟 Erstelle Windows-Standalone mit PyInstaller...
"%PYTHON_BIN%" -m pip install --upgrade pip pyinstaller
"%PYTHON_BIN%" -m PyInstaller ^
--noconfirm ^
--clean ^
--name "PDFtoICS" ^
--windowed ^
--add-data "version.txt;." ^
gui_wxpython.py
echo ✅ Fertig: dist\PDFtoICS\PDFtoICS.exe

24
build/package_linux.sh Executable file
View File

@@ -0,0 +1,24 @@
#!/bin/bash
set -euo pipefail
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
cd "$ROOT_DIR"
APP_DIR="dist/PDFtoICS"
VERSION="$(tr -d '[:space:]' < version.txt)"
OUT_DIR="release"
ARCHIVE_NAME="PDFtoICS-linux-v${VERSION}.tar.gz"
if [ ! -d "$APP_DIR" ]; then
echo "❌ Build-Ordner nicht gefunden: $APP_DIR"
echo "💡 Bitte zuerst ausführen: ./build/build_linux.sh"
exit 1
fi
mkdir -p "$OUT_DIR"
echo "📦 Erstelle Archiv: $OUT_DIR/$ARCHIVE_NAME"
tar -czf "$OUT_DIR/$ARCHIVE_NAME" -C dist PDFtoICS
echo "✅ Fertig: $OUT_DIR/$ARCHIVE_NAME"

25
build/package_macos.sh Normal file
View File

@@ -0,0 +1,25 @@
#!/bin/bash
set -euo pipefail
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
cd "$ROOT_DIR"
APP_BUNDLE="dist/PDFtoICS.app"
VERSION="$(tr -d '[:space:]' < version.txt)"
OUT_DIR="release"
ARCHIVE_NAME="PDFtoICS-macos-v${VERSION}.zip"
if [ ! -d "$APP_BUNDLE" ]; then
echo "❌ App-Bundle nicht gefunden: $APP_BUNDLE"
echo "💡 Bitte zuerst ausführen: ./build/build_macos.sh"
exit 1
fi
mkdir -p "$OUT_DIR"
echo "📦 Erstelle Archiv: $OUT_DIR/$ARCHIVE_NAME"
rm -f "$OUT_DIR/$ARCHIVE_NAME"
(cd dist && zip -r "../$OUT_DIR/$ARCHIVE_NAME" "PDFtoICS.app" >/dev/null)
echo "✅ Fertig: $OUT_DIR/$ARCHIVE_NAME"

27
build/package_windows.cmd Normal file
View File

@@ -0,0 +1,27 @@
@echo off
setlocal
cd /d "%~dp0\.."
set /p VERSION=<version.txt
set "VERSION=%VERSION: =%"
if not exist "dist\PDFtoICS\PDFtoICS.exe" (
echo ❌ Build-Ausgabe nicht gefunden: dist\PDFtoICS\PDFtoICS.exe
echo 💡 Bitte zuerst ausfuehren: build\build_windows.cmd
exit /b 1
)
if not exist "release" mkdir release
set "ARCHIVE=release\PDFtoICS-windows-v%VERSION%.zip"
if exist "%ARCHIVE%" del /q "%ARCHIVE%"
echo 📦 Erstelle Archiv: %ARCHIVE%
powershell -NoProfile -Command "Compress-Archive -Path 'dist\PDFtoICS\*' -DestinationPath '%ARCHIVE%'"
if errorlevel 1 (
echo ❌ Konnte Archiv nicht erstellen
exit /b 1
)
echo ✅ Fertig: %ARCHIVE%

View File

@@ -1 +1 @@
1.2.0 1.2.2