# 🚀 Quick Start Guide ## Schnellstart - 3 Schritte ### 1. Programm starten **macOS/Linux:** ```bash ./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](https://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`: ```python tz = pytz.timezone('Europe/Berlin') # Ändern Sie diesen Wert ``` Verfügbare Zeitzonen: [Liste hier](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) ### 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ß! 😊