nextcloud-calendar-tools

Basic tools for pimping my typical tasks in NC calendar

Funktionen

• Verbindet sich zum NextCloud Kalender
• Nutzt WebDAV/CalDAV API
• Setzt Farben und Verfügbarkeit nach Regeln
• Scripte für Terminerstellung aus 3rd-party Quelle

Anwendung

Konfiguration

Die Datei .env enthaelt lokale Zugangsdaten und wird deshalb nicht versioniert. Als Vorlage gibt es .env.example; kopiere diese Datei nach .env und ergaenze dort BASE_URL, USER, APP_PWD sowie die verwendeten Kalendernamen.

termin-coloring.py (Kalendereinträge umfärben)

Das Umfärben der Kalendereinträge erfolgt gemäss den Regeln, die im Script selbst definiert sind (selbsterklärend). Welcher Kalender konkret bearbeitet wird, wird in .env festgelegt.

(.venv)$ python termin-coloring.py --debug --verbose
Gefundene Kalenderobjekte: 365
[DBG] HREF: https://<redacted>/remote.php/dav/calendars/airflow/privat/002ca65a-cd72-4895-83a5-4888470d484f.ics (ETag=d5262cf041cd9f9983e45a7bdaf31948)
[DBG] HREF: https://<redacted>/remote.php/dav/calendars/airflow/privat/0123D740-D0A1-4CB1-8778-29CCF601B35B.ics (ETag=d0222d13286aad3d40c8761d3b6f70d4)
Done. Checked=299 matched_files=66 updated=0 already_ok=66 failed_put=0

waste-extraction.py (Termine für Müllabholung)

Dieses separate Script dient ausschließlich der Extrahierung der Termine für die Müllabholung in meiner Straße in meiner Gemeinde. Die Termine werden dann als ICS-File zur Verfügung gestellt, welche dann einfach in beliebige Applikationen geladen werden können. Das Script könnte aber auch leicht an andere Lokationen angepasst werden, solange die Gemeinde ihre Dienste via der citiesapp anbietet.

(.venv)$ python waste-extraction.py
Rufe API auf: https://api.v2.citiesapps.com/waste-management/areas/6761584e36764e06d7104231/calendar
Status Code: 200

--- Kalender für: Bad Fischau-Brunn, Institutsgasse ---

Filter aktiv für: Restmüll, Papier, Gelber Sack

--- Termine zur Kontrolle ---
05.11.2025 (Wednesday): Papier
06.11.2025 (Thursday): Papier
12.11.2025 (Wednesday): Gelber Sack
21.11.2025 (Friday): Restmüll
10.12.2025 (Wednesday): Gelber Sack
19.12.2025 (Friday): Restmüll
29.12.2025 (Monday): Papier
30.12.2025 (Tuesday): Papier

--- Erstelle ICS-Datei (muelltermine.ics) ---
ICS-Datei 'muelltermine.ics' mit 8 Terminen erfolgreich erstellt.

heurige-extraction.py (Termine für Heurige)

Dieses Skript extrahiert die "Ausg'steckt is"-Termine des Heurigenkalenders der Gemeinde und speichert sie in einer heurigen.ics-Datei.

(.venv)$ python heurige-extraction.py 
Versuche, die aktuelle build-version von https://bad-fischau-brunn.at/wirtschaft/heurigenkalender abzurufen...
Aktuelle build-version gefunden: 20251105143942-b347190a6352d885b1cfd4ddd96969d2ed269444

Rufe API auf: https://api.v2.citiesapps.com/events
Verwende Parameter: {'event-period': 'upcoming', 'scope': 'page:66c703b250d3917f19d8fae0', 'pagination': 'limit:50'}
Status Code: 200
4 Events in diesem Durchlauf, insgesamt 4.

--- Termine zur Kontrolle ---
17.11.2025 11:00: Fam. Leeb Andrea und Thomas
26.11.2025 16:00: Fam. Sederl
01.12.2025 11:00: Alte Feuerwehr
28.12.2025 11:00: Fam. Flechl

--- Erstelle ICS-Datei (heurigen.ics) ---
ICS-Datei 'heurigen.ics' mit 4 Terminen erfolgreich erstellt.

Mit --compare wird eine vorhandene lokale ICS-Datei als Letztstand mit dem in .env unter CAL_HEURIG konfigurierten CalDAV-Kalender verglichen. Benoetigt werden BASE_URL, CAL_HEURIG, USER und APP_PWD. Das Vergleichsjahr wird aus der lokalen ICS-Datei abgeleitet und kann bei Bedarf mit --year explizit gesetzt werden. Verglichen werden nur Termine ab dem fruehesten Termin der lokalen ICS-Datei bis zum Ende des jeweiligen Kalenderjahrs.

(.venv)$ python heurige-extraction.py --compare
Lade lokale ICS-Datei: heurigen.ics
Lade CalDAV-Kalender: <CAL_HEURIG>

--- Vergleich heurigen.ics <-> CalDAV ---
Vergleichsjahr: 2026
Vergleichszeitraum: 15.01.2026 bis 31.12.2026
Termine im Letztstand: 4
Termine im Online-Altstand: 4

--- Neu hinzugekommene Termine (0) ---
Keine.

--- Abgesagte Termine (0) ---
Keine.