pdf_to_ics/QUICKSTART.md

🚀 Quick Start Guide

Schnellstart - 3 Schritte

1. Programm starten

macOS/Linux:

./start_gui.sh

Windows: 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

Kopieren Sie Ihre Dienstplan-PDF-Dateien in dieses Verzeichnis:

/home/sebastian/Dokumente/ICS-Import/

3. Konvertieren und Importieren

In der GUI auf "ICS Datei erstellen" klicken. Die ICS-Dateien werden dann automatisch erstellt.

---

📅 In deinen Kalender importieren

Google Kalender

1. Öffne google.com/calendar
2. Einstellungen → Kalender importieren
3. "Datei aussuchen" → .ics Datei auswählen
4. Importieren

Outlook

1. Öffne Outlook
2. Datei → Öffnen und exportieren → Importieren
3. .ics Datei auswählen
4. In einen Kalender importieren

Thunderbird/SeaMonkey

1. Kalender öffnen
2. Datei → Importieren
3. .ics Datei auswählen

Apple Kalender (macOS/iOS)

1. Doppelklick auf die .ics Datei
2. Bestätigen Sie den Import

Linux (KDE Kontact, etc.)

1. Öffnen Sie die Kalenderanwendung
2. Datei → Importieren
3. .ics Datei auswählen

---

💡 Tipps und Tricks

Mehrere PDFs gleichzeitig

Das Programm verarbeitet automatisch alle .pdf Dateien im Verzeichnis. Kopieren Sie einfach mehrere PDFs hinein!

Zeitzone anpassen

Falls Sie eine andere Zeitzone benötigen, bearbeiten Sie pdf_to_ics.py:

tz = pytz.timezone('Europe/Berlin')  # Ändern Sie diesen Wert

Verfügbare Zeitzonen: Liste hier

Automatische Updates

Sobald Sie neue Dienstplan-PDFs hinzufügen und das Programm erneut ausführen, werden neue .ics Dateien erstellt.

---

❓ Häufige Probleme

"Keine PDF-Dateien gefunden"

• Überprüfen Sie, dass die PDF-Dateien im gleichen Verzeichnis wie die Skripte sind
• Dateiname darf Leerzeichen enthalten

"Keine Events gefunden"

• Die PDF muss das richtige Format haben (ein Dienstplan mit Tabelle)
• Kontrollieren Sie die PDF-Struktur

Zeitangaben falsch

• Die Standard-Einstellung ist Zeitzone "Europe/Berlin"
• Falls Sie eine andere Zeitzone benötigen, siehe "Zeitzone anpassen" oben

---

📞 Weitere Hilfe

Siehe README.md für ausführliche Dokumentation.

---

Viel Spaß! 😊