📅 Annuals – Geburtstage, Jahrestage, Feiertage, Ferien & mehr in Home Assistant

[somansch]

Hallo zusammen!

Ich möchte euch heute meine Home-Assistant-Integration Annuals vorstellen.

Angefangen hat alles mit einem einfachen Wunsch: Geburtstage und Jahrestage vernünftig in Home Assistant verwalten – mit Countdown, Alter/Jahren und einer schönen Darstellung im Dashboard.

Inzwischen ist daraus einiges mehr geworden.

Alles, was irgendwann wiederkommt – und mehr

Mit Annuals könnt ihr unter anderem verwalten:

Geburtstage – inklusive Alter und nächstem Geburtstag
Jahrestage – inklusive Anzahl der Jahre
Eigene jährliche Events
Wiederkehrende Aufgaben & To-dos
Einmalige und mehrtägige Events – z. B. den nächsten Urlaub
Feiertage für 250+ Länder und Regionen
Schulferien – inklusive regionaler Unterschiede
15 unterstützte Sprachen – sowohl in der Integration als auch in der Annuals Card

Alle Einträge stehen als normale Home-Assistant-Entitäten zur Verfügung und können damit natürlich auch in Automationen und eigenen Karten verwendet werden.

Feiertage – einmal einrichten und fertig

Land und gegebenenfalls Bundesland auswählen – den Rest übernimmt Annuals.

Die Feiertage werden automatisch für die kommenden Jahre aktualisiert. Ihr müsst also nicht jedes Jahr neue Termine importieren oder eure Automationen anpassen.

Auch die Namen der Feiertage können in unterschiedlichen Sprachen importiert oder individuell angepasst werden.

Schulferien – und zwar die Tage, die wirklich zählen

Auch Schulferien werden automatisch von Jahr zu Jahr aktualisiert und regionale Unterschiede berücksichtigt.

Eine Besonderheit: Offizielle Feriendaten entsprechen nicht immer dem tatsächlichen Zeitraum, in dem Familien unterwegs sein können.

Beginnen die Ferien offiziell beispielsweise am Montag und enden am Freitag, kann Annuals daraus automatisch den tatsächlichen Zeitraum Samstag bis Sonntag berechnen.

Das kann nicht nur für Countdowns interessant sein, sondern beispielsweise auch für Reise- und Verkehrsplanung oder entsprechende Automationen.

Ihr könnt außerdem entscheiden, ob ihr Ferienbeginn, Ferienende oder jeden einzelnen Ferientag als Event benötigt.

Und der eigene Urlaub?

Natürlich darf der wichtigste Urlaub nicht fehlen.

Mit einmaligen und mehrtägigen Events könnt ihr beispielsweise euren nächsten Urlaub hinterlegen:

Italien · 22. August – 5. September

Annuals zählt die Tage bis zur Abreise und zeigt auch laufende mehrtägige Events entsprechend an.

Eine Karte für alles

Dazu gibt es eine eigene Annuals Lovelace Card mit verschiedenen Layouts, Filtern und Darstellungsoptionen.

Wer bereits eine andere Kalenderkarte verwendet, muss aber nicht wechseln: Annuals stellt Kalender-Entitäten bereit und bestehende Home-Assistant-Kalender können umgekehrt auch direkt in die Annuals Card integriert werden.

Weitere Screenshots findet ihr hier:
GitHub

https://github.com/somansch/annuals

Ich freue mich über Feedback, Ideen und Bug Reports. Gerade bei Feiertagen und Schulferien gibt es international erstaunlich viele Sonderfälle – falls euch etwas auffällt, gerne melden!

Und wenn euch Annuals gefällt, würde ich mich sehr über einen Star auf GitHub freuen. Das hilft dem Projekt, sichtbarer zu werden und motiviert natürlich auch für die nächsten Features.

Vielen Dank vorab und viele Grüße

Andreas

[DukeNukem]

Herzlich Willkommen bei uns im Forum.

[somansch]

Mit dieser Integration lässt sich dann auch der heutige Feiertag international in einem Eintrag abbilden

[Stefan_HA]

Willkommen im Forum. Ich habe deine Integration bei mir schon ein paar Wochen am Laufen. Gefällt mir sehr gut

[hrglzpf]

Und Österreich.

Ich fühle mich diskriminiert!

[somansch]

Das darf natürlich nicht sein . Habe jetzt bei mir noch die Feiertage des befreundeten Nachbarlands hinzugefügt.

[SmartHobbyt]

Grüß dich Andreas und willkommen in dieser Gemeinschaft.

[tinob]

Herzlich Willkommen somansch

[somansch]

Hier die Feiertagsübersetzungen für die Schweiz, Italien, Spanien, Frankreich, UK und die Niederlande. Sorry, Österreich ist nicht dabei

country,subdivision,category,holiday_key,observed,language,name
CH,,public,Neujahrstag,,de,Neujahr
CH,,public,Auffahrt,,de,Christi Himmelfahrt
CH,,public,Weihnachten,,de,Erster Weihnachtstag
CH,ZH,public,Tag der Arbeit,,de,Erster Mai
CH,ZH,public,Stephanstag,,de,Zweiter Weihnachtstag
IT,,public,Capodanno,,de,Neujahr
IT,,public,Epifania,,de,Heilige Drei Könige
IT,,public,Pasqua,,de,Ostersonntag
IT,,public,Lunedì dell'Angelo,,de,Ostermontag
IT,,public,Festa del Lavoro,,de,Erster Mai
IT,,public,Assunzione della Beata Vergine Maria,,de,Mariä Himmelfahrt
IT,,public,Giorno dell'unità nazionale; Ognissanti,,de,Allerheiligen
IT,,public,Natale,,de,Erster Weihnachtstag
IT,,public,Santo Stefano,,de,Zweiter Weihnachtstag
FR,,public,Jour de l'an,,de,Neujahr
FR,,public,Lundi de Pâques,,de,Ostermontag
FR,,public,Lundi de Pentecôte,,de,Pfingstmontag
FR,,public,Fête du Travail,,de,Erster Mai
FR,,public,Ascension,,de,Christi Himmelfahrt
FR,,public,Assomption,,de,Mariä Himmelfahrt
FR,,public,Toussaint,,de,Allerheiligen
FR,,public,Noël,,de,Erster Weihnachtstag
ES,,public,Año Nuevo,,de,Neujahr
ES,,public,Epifanía del Señor,,de,Heilige Drei Könige
ES,,public,Viernes Santo,,de,Karfreitag
ES,,public,Fiesta del Trabajo,,de,Erster Mai
ES,,public,Asunción de la Virgen,,de,Mariä Himmelfahrt
ES,,public,Natividad del Señor,,de,Erster Weihnachtstag
ES,MD,public,Jueves Santo,,de,Gründonnerstag
ES,MD,public,Lunes siguiente a Todos los Santos,,de,Allerheiligen
GB,,public,Good Friday,,de,Karfreitag
GB,,public,May Day,,de,Erster Mai
GB,,public,New Year's Day,,de,Neujahr
GB,,public,New Year's Day,1,de,Neujahr
GB,,public,Christmas Day,,de,Erster Weihnachtstag
GB,,public,Christmas Day,1,de,Erster Weihnachtstag
GB,,public,Boxing Day,,de,Zweiter Weihnachtstag
GB,,public,Boxing Day,1,de,Zweiter Weihnachtstag
GB,ENG,public,Easter Monday,,de,Ostermontag
NL,,public,Nieuwjaarsdag,,de,Neujahr
NL,,public,Goede Vrijdag,,de,Karfreitag
NL,,public,Eerste paasdag,,de,Ostersonntag
NL,,public,Tweede paasdag,,de,Ostermontag
NL,,public,Hemelvaartsdag,,de,Christi Himmelfahrt
NL,,public,Tweede Pinksterdag,,de,Pfingstmontag
NL,,public,Eerste Kerstdag,,de,Erster Weihnachtstag
NL,,public,Tweede Kerstdag,,de,Zweiter Weihnachtstag

Diese kann man über „Feiertags-Übersetzungen“ als CSV importieren.

[somansch]

Annuals v3.1.0 – eure Card, euer Layout

Mit Annuals v3.1.0 lag der Fokus ganz klar auf einem Thema: noch mehr Freiheit bei der Gestaltung der Annuals Card.

Statt euch auf ein bestimmtes Layout festzulegen, könnt ihr jetzt noch stärker selbst entscheiden, wie eure Events dargestellt werden sollen.

Mehr Flexibilität

Die einzelnen Elemente der Card lassen sich noch umfangreicher kombinieren, anordnen und gestalten.

Date Block, Icon, Accent Bar, Name, Countdown, Timeline, Badges und weitere Elemente können individuell konfiguriert werden.

Auch Farben lassen sich gezielt nach Event-Typ und Status vergeben – beispielsweise für Geburtstage, Feiertage, Ferien oder externe Kalender sowie für Events, die heute stattfinden oder kurz bevorstehen.

Damit kann dieselbe Annuals Card je nach Konfiguration komplett unterschiedlich aussehen.

Neue Presets

Damit ihr nicht bei jeder Card bei null anfangen müsst, gibt es jetzt drei Presets:

Default · Agenda · Minimal

Ein Klick genügt für ein komplettes Grundlayout – danach könnt ihr es natürlich beliebig weiter anpassen.

Die neue Agenda-Ansicht ist dabei von der großartigen Calendar Card Pro inspiriert und bringt eine kompakte, kalenderähnliche Darstellung zu Annuals.

Ein aufgeräumterer Card Editor

Mehr Optionen sollten nicht automatisch einen komplizierteren Editor bedeuten.

Deshalb wurde auch der visuelle Editor überarbeitet:

Ihr seht nur noch Konfigurationsmöglichkeiten für Elemente, die in eurem aktuellen Layout tatsächlich aktiv sind.

Kein Date Block? → Keine Date-Block-Einstellungen.
Keine Timeline? → Keine Timeline-Einstellungen.

Dadurch bleibt der Editor trotz der deutlich größeren Gestaltungsmöglichkeiten übersichtlich.

Neue Trennlinien

Für längere Eventlisten gibt es außerdem neue Tag-, Wochen- und Monats-Trennlinien.

Gerade bei vielen Feiertagen, Ferien, Geburtstagen und Kalenderterminen macht das die Card deutlich leichter lesbar.

Ich bin gespannt, welche Layouts ihr mit den neuen Möglichkeiten baut – zeigt gerne eure Cards in den Kommentaren!

Feedback, Ideen und Bug Reports sind natürlich ebenfalls jederzeit willkommen.

Und wenn euch Annuals gefällt, freue ich mich sehr über einen Star auf GitHub. Das hilft dem Projekt, sichtbarer zu werden und motiviert für die nächsten Features.

Viele Grüße
Andreas

[somansch]

…und wie immer alles direkt per Karteneditor anpassbar „bis der Arzt kommt“

[somansch]

Ein riesiges Dankeschön an alle, die Annuals nutzen, Feedback geben und das Projekt unterstützen!

Inzwischen sind es über 300 Downloads und mehr als 50 Stars auf GitHub – großartig zu sehen, wie die Community wächst!

[somansch]

Annuals v3.2.0 – erst die Art, dann die Details

Mit Annuals v3.2.0 ändert sich, wie ein Event entsteht – und wie viel Platz die Card auf eurem Dashboard braucht.

Zwei der größten Neuerungen kommen dabei direkt aus dem Issue-Tracker. Genau dafür ist er da!

Erst die Frage, dann das passende Formular

Beim Anlegen fragt Annuals jetzt zuerst, worum es überhaupt geht: ein jährliches Ereignis für jemanden, ein einmaliges oder ein frei wählbares.

Danach bekommt ihr nur noch die Felder, die zu dieser Art gehören – statt eines langen Formulars mit Hinweisen, welches Feld für welchen Typ nicht gilt. Beim Bearbeiten entfällt die Frage: Das Event hat seine Art ja schon gewählt.

Termine, die eine Regel sind – kein Datum

Manche Tage sind kein Datum. Muttertag ist der zweite Sonntag im Mai, in Australien ist Vatertag der erste Sonntag im September. Ein festes Datum wäre in einem Jahr richtig und in jedem anderen falsch.

Ein frei wählbares Event kann deshalb jetzt einer Regel folgen: Ersten / Zweiten / Dritten / Vierten / Letzten + Wochentag + Monat. Damit sind Muttertag, Vatertag, Großelterntag und all die Gedenktage abgedeckt, die die Feiertags-Datenbank gar nicht kennt.

Eure importierten Feiertage bleiben davon unberührt – die rechnen ihr Datum ohnehin jedes Jahr selbst aus.

Die Card passt sich jeder Größe an

In der Sections-Ansicht lässt sich die Card jetzt richtig in der Größe verändern – der Hinweis „This card does not fully support resizing yet" ist Geschichte. Bis hinunter auf eine einzige Zeile, wenn ihr wollt: oben links eine volle Liste, rechts oben eine Timeline und darunter eine Card mit genau einem Event.

Dazu zwei neue Schalter:

• Rest einklappen – die Liste zeigt nur die ersten Events, der Rest liegt hinter einem Pfeil. Wie viele sichtbar bleiben, bestimmt ihr über Sichtbare Ereignisse.
• Minimal (eine Zeile, schmaler Rand) – schmalere Ränder, damit ein Event wirklich in eine Zeile passt.

Mehrtägige Events aus euren Kalendern

Mehrtägige Ereignisse gilt jetzt auch für eingebundene Kalender, nicht mehr nur für einmalige Events mit Enddatum. Eine Urlaubswoche aus dem Familienkalender könnt ihr als ersten Tag, letzten Tag, beides oder als eine Zeile pro Tag anzeigen – und jede Zeile sagt dazu, welcher Teil sie ist: Skiurlaub (Start), (Ende), (Tag 3).

Außerdem behoben

• Die Card erschien gelegentlich erst nach einem Seiten-Reload.
• Beim erneuten Import von Feiertagen entstehen keine Duplikate mehr, wenn die Bibliothek einen Namen umbenannt hat – und mehrere Kategorien ergeben jetzt einen Eintrag pro Feiertag.

Danke!

Ein riesiges Dankeschön an alle, die Annuals nutzen, Feedback geben und Ideen einbringen! Inzwischen sind es 689 Downloads des letzten Releases und über 70 Stars auf GitHub – großartig zu sehen, wie es weitergeht.

Release Notes · Changelog · GitHub

Kleiner Hinweis: HACS bietet euch bereits v3.2.1 an – ein reiner Validierungs-Fix, an dem ihr nichts merkt.

[somansch]

v3.3.0 – eine Card, mit der ihr jetzt interagiert

Bisher hat die Annuals Card gezeigt, was kommt. Jetzt könnt ihr durch sie blättern, in ihr suchen und eure Events direkt aus ihr heraus anlegen, ändern und löschen.

Blättern wie im Kalender – und suchen

Kalendernavigation macht aus der Liste einen Zeitraum nach dem anderen – Tag, Woche, Monat oder Jahr, mit Pfeilen, Datumswähler und Wisch auf dem Handy; ein Tipp auf den Zeitraum führt zurück zu heute. Das Suchfeld darunter filtert beim Tippen nach Name, Typ, Feiertagskategorie und Ort.

Events direkt in der Card pflegen

Ein + neben dem Titel öffnet das Formular der Integration in einem Dialog über dem Dashboard – dieselben Felder wie unter Einstellungen → Geräte & Dienste. Ereignis bearbeiten und löschen legt Stift und Papierkorb ans Zeilenende, ohne eigenen Platz zu brauchen; Beim Klick einblenden holt sie auf Handy und Tablet per Klick hervor. Nur für Administratoren, jeder Knopf einzeln abschaltbar und im Editor frei gestaltbar.

Außerdem neu

• Personenbild statt Icon, wenn das Ereignis eine Person hat – auch in der Push-Nachricht des Blueprints.
• Alle 6 Monate, alle 2 Jahre – Intervall statt einmal im Jahr: Zahnarzt, TÜV, Reisepass.
• Vorbei ist vorbei – ein Termin von 14 bis 15 Uhr ist um 15 Uhr aus der Card. Ganztägige bleiben bis Mitternacht.
• Countdown in Wochen und Monaten – in 3 Monaten statt in 87 Tagen.
• Rund dreimal schneller aufgebaut, und der Editor baut sich nicht mehr bei jeder Zustandsänderung im Haus neu.

Release Notes · Changelog · GitHub

[Schorsch]

Super Integration.

Mit der Aussicht, keine Geburtstage und ähnliche Anlässe mehr zu vergessen, wäre meine holde Gattin sogar damit einverstanden, ein Dashboard im Flur aufzuhängen.

Da man ics-files importieren kann, wäre auch ein Abfallkalender realisierbar, oder?
Ich habe bereits eine Trash-Card, aber mit Annuals bieten sich evtl. mehr Möglichkeiten.

[somansch]

@Schorsch , danke für dein Feedback. Der ICS-Import von Annuals sucht nach ganztägigen Ereignissen und legt sie dann (natürlich nach Prüfung durch dich) mit dem entsprechend gefundenem Datum an. Das bringt für die Termine des Abfallkalenders nichts, da dort ja die Termine im nächsten Jahr nicht identisch sind. Ich habe bei mir einfach den Abfallkalender als zusätzlichen externen Kalender in die Karte aufgenommen. Er hat eine extra Farbe und Symbol

[somansch]

v3.4.0 ist raus:

Nur die Feiertage, die du willst. Der Feiertagsimport hat einen dritten Schritt: alle Feiertage, die Land, Region und Kategorien ergeben, jeweils mit dem nächsten Datum, in der Reihenfolge, in der sie anstehen – und ein Häkchen für jeden. Nur die angehakten werden zu Ereignissen. Kein Import von dreißig Feiertagen mehr, um drei zu behalten.

Börsentage. Ereignisse importieren → Börsen holt die Tage, an denen eine Börse geschlossen ist oder früher schließt, von 25 Märkten – New York, Nasdaq, London, Frankfurt, Zürich, Tokio, Hongkong, Sydney und weitere. Das sind keine Feiertage, deshalb sind sie ein eigener Ereignistyp, mit eigenem Kalender, eigenem Filter in der Karte und eigener Farbe – und sie sagen, was sie sind: New York Stock Exchange geschlossen ab 13:00, wegen Day after Thanksgiving Day.

Eine Kategorie ohne Feiertage am gewählten Ort meldet sich. Manche gibt es nur unterhalb der Landesebene – Schulferien in Deutschland je Bundesland, die Feiertage nur für Frauen in Indien nur in Himachal Pradesh. Ohne die passende Region meldete der Import bisher nur 0 eingereiht; jetzt nennt er die Regionen, die welche haben.

---

Alle Änderungen: CHANGELOG

Wenn dir Annuals nützt, freue ich mich sehr über einen Stern für das Repo – so finden andere es. Danke!

[DukeNukem]

Ich nutze dieses Programm auch schon seit Wochen und bin sehr zufrieden damit.

So nach und nach fliegen jetzt die alten Kalenderimporte (.ics Dateien) raus.

[MartyBr]

Ich setze die Version 3.4 ein und möchte mich hier für die tolle Anwendung bedanken. Sie hat nun meinen Google-Geburtstagskalender abgelöst.
Schön ist auch die Einbindung der Feiertage.
Ich möchte nun auch meinen Apple Terminkalender als Karte im Dashboard ablösen.
Obwohl ich die Anleitung rauf- und runterlesen habe, finde ich bei den Einstellungen keine Möglichkeit, einen externen Kalender einzubinden. Ich möchte die Termine weiterhin im Apple Kalender belassen, da sie über mehrere Apple Devices “gefüttert” werden.

Kann mir jemand hier kurz beschreiben, wie ich das umsetzen kann?

[luha68]

Tolle Lösung, sehr einfach zu integrieren und da ich die Calendar Card Pro eh schon mit dem Müllabfuhr-Kalender nutze eine super Ergänzug… Danke!