Kantine BHZ Kiel-Wik – Speiseplan zu iCal

Liest die PDF-Speisepläne von kantine-bhz.de aus und erzeugt eine iCal-Datei (.ics) für den Import in Google Kalender. Jeder Termin enthält alle Tagesgerichte (I. bis V.) und ist auf 12:00 Uhr mittags gesetzt.

Voraussetzungen

• Python 3.9+ (für zoneinfo)
• Bestehendes venv unter .venv

Installation

1. Virtuelle Umgebung aktivieren:

   Windows (PowerShell):

   .venv\Scripts\Activate.ps1
   

   Windows (CMD):

   .venv\Scripts\activate.bat
   

2. Abhängigkeiten installieren:

   pip install -r requirements.txt
   

Nutzung

python kantine2ical.py

Erzeugt standardmäßig die Datei kantine_speiseplan.ics im aktuellen Verzeichnis.

Optionen:

• -o DATEI / --output DATEI – Ausgabedatei (Standard: kantine_speiseplan.ics)
• --url URL – Basis-URL der Kantine (Standard: http://kantine-bhz.de)

Beispiel:

python kantine2ical.py -o mein_speiseplan.ics

Google Kalender Import

1. Google Kalender öffnen
2. Neben „Meine Kalender“ auf das Drei-Punkte-Menü klicken → Import
3. Die erzeugte .ics-Datei auswählen und dem gewünschten Kalender zuordnen

Die Termine erscheinen mit der Zeitzone Europe/Berlin um 12:00 Uhr mit allen fünf Tagesgerichten in der Beschreibung.

---

Server-Modus (abonnierbare URL)

Der Speiseplan kann als externer Kalender per URL angeboten werden. Ein Flask-Server liefert die iCal-Daten; Google Kalender und andere Clients können die URL direkt abonnieren. Im Hintergrund wird täglich nach neuen Speiseplan-PDFs gesucht und der Kalender aktualisiert.

Voraussetzung: Für „Von URL hinzufügen“ in Google Kalender muss die Server-URL von außen erreichbar sein (öffentliche IP, Reverse-Proxy oder z. B. ngrok für Tests).

1. Abhängigkeiten installieren (inkl. Flask): pip install -r requirements.txt
2. Server starten:

   python app.py
   

   Oder mit Flask-CLI: flask --app app run --host 0.0.0.0 --port 5000
3. Abo-URL für Google Kalender: http://<host>:5000/calendar.ics (bzw. Port 5000 durch Ihren Host/Port ersetzen).
4. In Google Kalender: „Andere Kalender hinzufügen“ → „Von URL“ → obige URL eintragen.

Konfiguration (optional, Umgebungsvariablen):

• KANTINE_BASE_URL – Basis-URL der Kantine (Standard: http://kantine-bhz.de)
• REFRESH_INTERVAL_SECONDS – Sekunden zwischen Aktualisierungen (Standard: 86400 = 24 h)

---

Docker (Production)

Für den Betrieb als Container (z. B. auf einem Server):

Build und Run:

docker build -t kantine2ical .
docker run -p 8000:8000 kantine2ical

Abo-URL: http://<host>:8000/calendar.ics

Mit Docker Compose:

docker compose up -d

Der Container läuft auf Port 8000 und startet bei Bedarf neu (restart: unless-stopped).

Hinweis: Für den Einsatz in Production wird ein Reverse-Proxy mit HTTPS (z. B. Traefik, Caddy oder nginx) vor dem Container empfohlen, damit Google die Kalender-URL zuverlässig abrufen kann.