103 lines
2.4 KiB
Markdown
103 lines
2.4 KiB
Markdown
# 🚀 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
|
|
|
|
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ß! 😊
|