Saint of the Day

Features

• Saint of the day sensor: the calendar label as the state (Ste Geneviève, Sts Anne et Joachim, Noël), with the first names wished, the date and the next 7 days as attributes
• Saint of tomorrow sensor, for an evening reminder
• Updated at midnight in the Home Assistant time zone; the 366 days (29 February included) are embedded in the integration
• custom:saint-of-the-day-card card, shipped with the integration and loaded automatically: today's feast with a name day wish, the date and the next days
• custom:saint-of-the-day-mini-card compact card: today's feast, with a button to open the full card
• Visual editor for both cards
• Diagnostics download
• English, French, German, Spanish, Serbian (Cyrillic and Latin), Italian, Dutch, Portuguese, Polish, Romanian, Danish, Swedish, Bulgarian, Russian, Ukrainian, Hungarian, Slovak, Czech, Slovenian, Latvian and Greek (the calendar itself stays French)

Prerequisites

• Home Assistant 2024.12 or later

Configuration

Integration#

Settings → Devices & services → Add integration → Saint of the day, then confirm. There is nothing to set up, and a single entry is allowed.

The entity ids above are those created with Home Assistant in English; they follow the language of your instance at creation.

Card#

Add the Saint of the day card from the card picker: every option is set in the visual editor. In YAML:

type: custom:saint-of-the-day-card

Click the feast to open the sensor's details.

Mini card#

A compact card for dashboards: today's feast and the wish. The button at the top right opens the full card in place; a click outside the card folds it back.

type: custom:saint-of-the-day-mini-card

It takes the same options as custom:saint-of-the-day-card (set in the same visual editor); upcoming_days applies to the full view.

Automation example#

triggers:
  - trigger: time
    at: "08:00:00"
conditions:
  - condition: template
    value_template: "{{ state_attr('sensor.saint_of_the_day_saint_of_the_day', 'names') | count > 0 }}"
actions:
  - action: notify.mobile_app_phone
    data:
      message: >-
        Today is {{ states('sensor.saint_of_the_day_saint_of_the_day') }}:
        happy name day to {{ state_attr('sensor.saint_of_the_day_saint_of_the_day', 'names') | join(', ') }}!

Diagnostics#

Settings → Devices & services → Saint of the day → ⋮ → Download diagnostics gives the time zone, the day the integration sees and its feast, for bug reports.

How it works

The calendar of name days (the classic French calendar, one feast per day) is stored in data/saints.json, read once at startup. The sensors compute the day in the Home Assistant time zone and refresh at midnight; nothing is polled and nothing leaves Home Assistant. A day whose feast has no first name to wish (Noël, Toussaint, Fête nationale…) has an empty names list: the card then shows the feast without a wish.

Support

If you find this project useful, you can support its development:

Features

• Saint of the day and Saint of tomorrow sensors: the French name day (calendar label as the state, first names, date), updated at local midnight. The today sensor also lists the next 7 days in its upcoming attribute.
• The 366-day calendar (29 February included) is embedded in the integration: no external API, no account, no polling.
• custom:saint-of-the-day-card, shipped with the integration and loaded automatically: today's feast with a name day wish, the date, and the next days (upcoming_days, 0 to 7). A click on the feast opens the sensor's details.
• custom:saint-of-the-day-mini-card: today's feast only, with a button to open the full card in place.
• Visual editor for both cards.
• Single config entry, nothing to set up.
• Diagnostics download (time zone and the day the integration sees).
• English, French, German, Spanish, Serbian (Cyrillic and Latin), Italian, Dutch, Portuguese, Polish, Romanian, Danish, Swedish, Bulgarian, Russian, Ukrainian, Hungarian, Slovak, Czech, Slovenian, Latvian and Greek. In the release zip, the card keeps English only and loads the other languages on demand.