[{"_1":2,"_180":-5,"_181":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_154":155},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_92":-5,"_93":94,"_143":-5,"_144":11,"_145":21,"_146":11,"_147":-5,"_148":11,"_149":-5,"_150":151,"_152":95,"_153":-7},"canonicalUrl","https://hub.docker.com/r/dudanski/flaav/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","dudanski","reponame","flaav","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_47":48,"_50":51,"_52":53,"_54":11,"_55":56,"_57":58,"_59":60,"_43":35,"_32":33,"_62":63,"_64":49,"_65":66,"_67":68,"_69":70,"_71":-5,"_72":66,"_73":74,"_75":11,"_76":33,"_77":78,"_83":11,"_84":85,"_89":33,"_90":91},"categories",[42],{"_43":44,"_45":46},"name","API management","slug","api-management","content_types",[49],"image","date_registered","2022-01-03T16:42:13.291982Z","description","docker container mit python script um Kalenderinformationen per REST-API zur Verfügung zu stellen","is_private","last_updated","2026-10-03T17:18:14.574518Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[61],"application/vnd.docker.container.image.v1+json","pull_count",915,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# flaav\n\nFlask- Applikation im Docker-Container um Kalender-Informationen aus CalDav via API zur Verfügung zu stellen.\nZwei Use-Cases schwebten mir dabei im Kopf\n\n1. Wann ist der nächste Termin (Bsp: Abholtermin Müllabfuhr)\n2. Ist heute ein Bestimmter Termin (Bsp: für einen bestimmten Betriebsmodus bei Urlaub)\n\nDer Fantasie sind nun aber keine Grenzen gesetzt. \n\nIch hab das nur für den iCloud-Kalender getestet. Theoretisch sollten auch andere CalDav-Server funktionieren.\n\nZur Zeit kann die API nur mit ganztägigen Events umgehen. Andere Termin und Serientermine haben eine andere Struktur in der Angabe der start- und end-dates. Das müsste man mal handeln.\n\n\n## run\n\n### Vorbereitung\n\n**Anwendungspezifisches Passwort erstellen:**\nhttps://support.apple.com/de-de/HT204397\n\n\n### Mit .env -File\n\n```\ncaldav_url=<>\ncaldav_username=<>\ncaldav_passwd=<>\nlook_ahead_days=<<30>>\n```\n\n```\ndocker run --env-file .env \\\n --name flaav \\\n --detach \\\n --publish 5000:5000 \\ \n flaav:latest\n```\n\n### Oder environment -Parameter\n\n```\ndocker run --env-file .env \\\n --name flaav \\\n --detach \\\n --publish 5000:5000 \\\n --env caldav_url=<>\n --env caldav_username=<>\n --env caldav_passwd=<>\n --env look_ahead_days=<<30>>\n flaav:latest\n```\n\n## Konfiguration\n\n| Parameter Name | Beschreibung |\n| ------------- | ------------- |\n| caldav_url | Url zum CalDav-Server (incl. Port) in meinem Fall https://caldav.icloud.com:443 |\n| caldav_username | User-Name zur Authentifizierung am CalDav-Server in meinem Fall die Apple Id |\n| caldav_passwd | Passwort zum user-name für iCloud ein anwenungdspezifisches Passwort |\n| look_ahead_days |Die API fragt bei jedem Call den Kalender ab. Aus Performance-Sicht kann es sinnvoll sein hier nur den notwendigen Zeitraum zu wählen.|\n\n# API Dokumentation\n\n### Verfügbare Kalender\n\nals Root zeit die API alle verfügbaren Kalender an\n\n```\n$ curl http://myserver.com:5000/flaav/api/v0.1\n\n> Reminders ⚠️\n> Müllabfuhr ROW\n> Kalender\n> Packen ⚠️\n> Family\n> Einkauf\n> Wochenmarkt\n> Baumarkt\n```\n\n### Events\n\nDiese sind nun auch der nächste zu wählende Knotenpunkt. Der Knoten nach Auswahl des Kalenders zeigt alle verfügbaren Events im CalDav-Format. Das ist relativ unübersichtlich. Hilft aber beim Debuggen.\nTheoretisch könnten verschiedene Objekte in einem Kalender stecken (Events, Tasks ... ). Bisher gibts nur Events:\n\n```\n$ curl http://myserver.com:5000/flaav/api/v0.1//events\n```\n\n*Beipsiel:*\n\n```\n$ curl http://myserver.com:5000/flaav/api/v0.1/Family/events\n\n> BEGIN:VCALENDAR\n> END:VCALENDAR\n> BEGIN:VCALENDAR\n> X-EXPANDED:True\n> X-MASTER-DTSTART:20160731T180000\n> X-MASTER-RRULE:FREQ=MONTHLY\\;BYDAY=SU\\;BYSETPOS=5\n> BEGIN:VEVENT\n> DTSTAMP:20220103T123212Z\n> UID:0E25C87B-9961-4937-BC63-18492BD9EBCD\n> LOCATION:Hainholzweg 52\\, 21077 Hamburg\n> SEQUENCE:0\n> SUMMARY:Punkt 18 Gottesdienst\n> LAST-MODIFIED:20160626T200825Z\n> CREATED:20160626T200824Z\n> TRANSP:OPAQUE\n> X-APPLE-TRAVEL-ADVISORY-BEHAVIOR;ACKNOWLEDGED=20211031T163948Z:AUTOMATIC\n> DTSTART;TZID=Europe/Berlin:20220130T180000\n> DTEND;TZID=Europe/Berlin:20220130T190000\n> RECURRENCE-ID:20220130T170000Z\n> BEGIN:VALARM\n> X-WR-ALARMUID:12DD00B8-470E-4EFF-8751-DF86DD5BD97D\n> UID:12DD00B8-470E-4EFF-8751-DF86DD5BD97D\n> TRIGGER:-PT15M\n> ATTACH;VALUE=URI:Chord\n> ACTION:AUDIO\n> X-APPLE-DEFAULT-ALARM:TRUE\n> ACKNOWLEDGED:20211031T155409Z\n> END:VALARM\n> BEGIN:VALARM\n> X-WR-ALARMUID:89E25769-A9F4-47F3-9123-F304422BFD7B\n> UID:89E25769-A9F4-47F3-9123-F304422BFD7B\n> DESCRIPTION:Erinnerung\n> ACKNOWLEDGED:20211031T155409Z\n> TRIGGER:-PT30M\n> ACTION:DISPLAY\n> END:VALARM\n> END:VEVENT\n> END:VCALENDAR\n> ...\n...\n```\n\n### Verfügbare Events mit Namen\n\nDer Nächste Knoten, nach dem Events gefiltert werden können, ist der Name. Dieser kann mittels Regex ermittelt werden.\nNotwendig ist zu wählen ob jedes event, nur das nächste anstehende, oder nur ein heutiges Event mit dem gegebenen Namen zurückgegeben werden soll \n(any/next/today)\n\n#### any: \n```\n$ curl \"http://myserver.com:5000/flaav/api/v0.1//events/any/\"\n```\n\n\n*Beispiel 1:*\n```\n$ curl \"http://myserver.com:5000/flaav/api/v0.1/Family/events/any/Kita%20frei\"\n\n> BEGIN:VCALENDAR\n> VERSION:2.0\n> PRODID:-//PYVOBJECT//NONSGML Version 1//EN\n> BEGIN:VEVENT\n> UID:58FD33C8-358C-4FEE-8BC2-CDD82960DE32\n> DTSTART;VALUE=DATE:20211222\n> DTEND;VALUE=DATE:20220103\n> CREATED:20210928T072630Z\n> DTSTAMP:20210928T072631Z\n> LAST-MODIFIED:20210928T072630Z\n> SEQUENCE:0\n> SUMMARY:Kita frei \n> URL;VALUE=URI:\n> END:VEVENT\n> END:VCALENDAR\n```\n\n*Beispiel 2:*\nDieses mal mit Regex\n```\n$ curl \"http://myserver.com:5000/flaav/api/v0.1/Family/events/any/Kita.*\"\n\n> BEGIN:VCALENDAR\n> VERSION:2.0\n> PRODID:-//PYVOBJECT//NONSGML Version 1//EN\n> BEGIN:VEVENT\n> UID:58FD33C8-358C-4FEE-8BC2-CDD82960DE32\n> DTSTART;VALUE=DATE:20211222\n> DTEND;VALUE=DATE:20220103\n> CREATED:20210928T072630Z\n> DTSTAMP:20210928T072631Z\n> LAST-MODIFIED:20210928T072630Z\n> SEQUENCE:0\n> SUMMARY:Kita frei \n> URL;VALUE=URI:\n> END:VEVENT\n> END:VCALENDAR\n```\n\n#### next:\n\nauf dem gleichen Knoten aber mit \"next\" in er Route gibt das Event zurück, dass als nächstes stattfindet\n\n```\n$ curl \"http://myserver.com:5000/flaav/api/v0.1//events/next/\"\n```\n\n*Beispiel:*\nnächstes Event (Uraub findet aktuell statt deswegen:)\n``` \n$ curl \"http://myserver.com:5000/flaav/api/v0.1/Family/events/next/.*\"\n\n> BEGIN:VCALENDAR\n> VERSION:2.0\n> PRODID:-//PYVOBJECT//NONSGML Version 1//EN\n> BEGIN:VEVENT\n> UID:B888496E-FC4F-4D88-B4B4-79C8AA0328DB\n> DTSTART;VALUE=DATE:20211224\n> DTEND;VALUE=DATE:20220103\n> CREATED:20211225T211840Z\n> DTSTAMP:20211225T211841Z\n> LAST-MODIFIED:20211225T211840Z\n> SEQUENCE:0\n> SUMMARY:Urlaub\n> TRANSP:OPAQUE\n> URL;VALUE=URI:\n> BEGIN:VALARM\n> ACTION:DISPLAY\n> DESCRIPTION:Erinnerung\n> TRIGGER:PT9H\n> UID:CBE19EA0-E4CA-43BC-B03E-8DC3CF3F7F4A\n> X-APPLE-DEFAULT-ALARM:TRUE\n> X-WR-ALARMUID:CBE19EA0-E4CA-43BC-B03E-8DC3CF3F7F4A\n> END:VALARM\n> END:VEVENT\n> END:VCALENDAR\n```\n\n\n\n#### today:\n\nnur weils geht ... gibts den gleichen Knoten auch noch mit today. Dieser zeigt nur events von heute an.\n\n```\n$ curl \"http://myserver.com:5000/flaav/api/v0.1//events/today/\"\n```\n\n*Beispiel:*\nEvents, die heute stattfinden. Egal mit welchem Namen (regex = .*)\n```\n$ curl \"http://myserver.com:5000/flaav/api/v0.1/Family/events/today/.*\"\n\n> BEGIN:VCALENDAR\n> VERSION:2.0\n> PRODID:-//PYVOBJECT//NONSGML Version 1//EN\n> BEGIN:VEVENT\n> UID:B888496E-FC4F-4D88-B4B4-79C8AA0328DB\n> DTSTART;VALUE=DATE:20211224\n> DTEND;VALUE=DATE:20220103\n> CREATED:20211225T211840Z\n> DTSTAMP:20211225T211841Z\n> LAST-MODIFIED:20211225T211840Z\n> SEQUENCE:0\n> SUMMARY:Urlaub\n> TRANSP:OPAQUE\n> URL;VALUE=URI:\n> BEGIN:VALARM\n> ACTION:DISPLAY\n> DESCRIPTION:Erinnerung\n> TRIGGER:PT9H\n> UID:CBE19EA0-E4CA-43BC-B03E-8DC3CF3F7F4A\n> X-APPLE-DEFAULT-ALARM:TRUE\n> X-WR-ALARMUID:CBE19EA0-E4CA-43BC-B03E-8DC3CF3F7F4A\n> END:VALARM\n> END:VEVENT\n> END:VCALENDAR\n> \n> BEGIN:VCALENDAR\n> VERSION:2.0\n> PRODID:-//PYVOBJECT//NONSGML Version 1//EN\n> BEGIN:VEVENT\n> UID:58FD33C8-358C-4FEE-8BC2-CDD82960DE32\n> DTSTART;VALUE=DATE:20211222\n> DTEND;VALUE=DATE:20220103\n> CREATED:20210928T072630Z\n> DTSTAMP:20210928T072631Z\n> LAST-MODIFIED:20210928T072630Z\n> SEQUENCE:0\n> SUMMARY:Kita frei \n> URL;VALUE=URI:\n> END:VEVENT\n> END:VCALENDAR \n```\n\n\n### Eventeigenschaften \n\nder Wert jeder Eigenschaft/Component/Subcomponent kann auch einzeln ausgegeben werden. Der Knoten beschreibt sich über die verfügbaren Eigenschaften. Leider haben nicht alle Events immer alle Eigenschaften gesetzt. Am Besten sucht man sich die aus der Anzeige des ganzen Events raus\n\n```\n$ curl \"http://myserver.com:5000/flaav/api/v0.1//events/any//\"\n```\n\n*Beispiel 1:*\nNächster Starttermin für Papier(-müll)\n```\n$ curl \"http://myserver.com:5000/flaav/api/v0.1/M%C3%BCllabfuhr%20ROW/events/next/Papier/dtstart\"\n\n> 20220111\n```\n\n*Beispiel 2:*\nWelche Termine (Namen) stehen heute an?\n```\n$ curl \"http://myserver.com:5000/flaav/api/v0.1/Family/events/today/.*/summary\"\n\n> Urlaub\n> Kita frei\n```\n\n## Weitere Funktionen\n\n### is_today\n\nliefert einen einfach eine 1 bzw. eine 0 je nach dem ob das Event heute stattfinden oder nicht. \nDiese Funktion ist nur auf dem **any**-Knoten verfügbar\n\n```\n$ curl \"http://myserver.com:5000/flaav/api/v0.1//events/any//is_today\"\n```\n\n*Beispiel:*\nAngenommen es ist heute Urlaub ;) \n\n```\n$ curl \"http://myserver.com:5000/flaav/api/v0.1/Family/events/any/Urlaub/is_today\"\n\n> 1\n```\n\n### weekday\n\nliefert den Wochentag des Startdatum des Events wobei Montag = 0 und Sonntag = 6.\nDiese Funktion ist nur auf dem **next**-Knoten verfügbar\n\n```\n$ curl \"http://myserver.com:5000/flaav/api/v0.1//events/any//weekday\"\n```\n\n*Beispiel:*\nWochentag an dem Papier(-Müll) das nächste mal abgeholt wird\n```\n$ curl http://myserver.com:5000/flaav/api/v0.1/Müllabfuhr%20ROW/events/next/Papier/weekday\n\n> 1\n```\n\n\n### days_until\n\nliefert die Tage bis zum Eintritt des Events\nDiese Funktion ist nur auf dem **next**-Knoten verfügbar\n\n```\n$ curl \"http://myserver.com:5000/flaav/api/v0.1//events/any//days_until\"\n```\n\n*Beispiel:*\nAnzahl Tage bis das nächste Mal Papier(-Müll) abgeholt wird\n```\nhttp://localhost:5000/flaav/api/v0.1/Müllabfuhr%20ROW/events/next/Papier/days_until\n\n> 8\n```\n\n\n## known issues\n\n* Es können nur Ganztägige Ereignisse betrachtet werden\n* is_today berücksichtigt auch ganztägige Termine, deren enddatum = Heute 00:00. Das ist leider immer so bei ganztägigen Terminen\n","has_starred","hub_user","immutable_tags_settings",{"_79":11,"_80":81},"enabled","rules",[82],".*","is_automated","permissions",{"_86":21,"_87":11,"_88":11},"read","write","admin","user","storage_size",253928115,"orgData","recentTags",[95,133],{"_96":49,"_97":98,"_99":100,"_101":102,"_103":104,"_55":122,"_123":98,"_124":33,"_125":61,"_43":126,"_127":128,"_129":113,"_130":122,"_131":70,"_132":21},"content_type","creator",4001493,"full_size",160162505,"id",185101547,"images",[105],{"_106":107,"_108":109,"_110":111,"_112":113,"_114":115,"_116":117,"_118":111,"_119":-5,"_120":100,"_67":70,"_121":-5},"architecture","arm","digest","sha256:f487df6ab9b2a773e751645987b54abb9630a5b587d4b73767f6a699025be7a9","features","","last_pulled","2026-10-05T08:57:28.034907978Z","last_pushed","2022-01-03T21:10:39Z","os","linux","os_features","os_version","size","variant","2022-01-03T21:10:38.902697Z","last_updater","last_updater_username","media_type","latest","repository",16162015,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_96":49,"_97":98,"_108":134,"_99":135,"_101":136,"_103":137,"_55":142,"_123":98,"_124":33,"_125":61,"_43":139,"_127":128,"_129":140,"_130":142,"_131":70,"_132":21},"sha256:6fd1882586d122572d7a306549ead5f2cd70a33797daf2ee7e2e518957db6a64",71374035,1333836424,[138],{"_106":139,"_108":134,"_110":111,"_112":140,"_114":141,"_116":117,"_118":111,"_119":-5,"_120":135,"_67":70,"_121":-5},"amd64","2026-10-04T15:17:43.434807224Z","2026-10-03T17:18:14.131087505Z","2026-10-03T17:18:14.401578Z","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":156,"_164":165,"_150":178,"_179":11},{"_40":157,"_47":159,"_50":51,"_52":53,"_54":11,"_55":56,"_57":58,"_59":160,"_43":35,"_32":33,"_62":63,"_64":49,"_65":66,"_67":68,"_69":70,"_71":-5,"_72":66,"_73":74,"_75":11,"_76":33,"_77":161,"_83":11,"_84":163,"_89":33,"_90":91},[158],{"_43":44,"_45":46},[49],[61],{"_79":11,"_80":162},[82],{"_86":21,"_87":11,"_88":11},"tags",{"_166":167,"_168":-5,"_169":-5,"_170":171},"count",2,"next","previous","results",[172,175],{"_96":49,"_97":98,"_108":134,"_99":135,"_101":136,"_103":173,"_55":142,"_123":98,"_124":33,"_125":61,"_43":139,"_127":128,"_129":140,"_130":142,"_131":70,"_132":21},[174],{"_106":139,"_108":134,"_110":111,"_112":140,"_114":141,"_116":117,"_118":111,"_119":-5,"_120":135,"_67":70,"_121":-5},{"_96":49,"_97":98,"_99":100,"_101":102,"_103":176,"_55":122,"_123":98,"_124":33,"_125":61,"_43":126,"_127":128,"_129":113,"_130":122,"_131":70,"_132":21},[177],{"_106":107,"_108":109,"_110":111,"_112":113,"_114":115,"_116":117,"_118":111,"_119":-5,"_120":100,"_67":70,"_121":-5},[],"canDeleteTags","actionData","errors"]

dudanski/flaav

Tags for dudanski/flaav