Initial commit: PDF zu ICS Konverter

QUICKSTART.md

@@ -0,0 +1,98 @@
+# 🚀 Quick Start Guide
+
+## Schnellstart - 3 Schritte
+
+### 1. Programm starten
+
+**macOS/Linux:**
+```bash
+./start.sh
+```
+
+**Windows:**
+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
+
+Im Menü wählen Sie Option "1. PDF(s) konvertieren" und die ICS-Dateien werden 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ß! 😊