📅 Calendrier Hijri et notifications

Le calendrier Hijri structure toute la vie d’un Muslim. L’intégrer dans votre domotique vous permet de ne jamais manquer un événement religieux important. Grâce à l’intégration Muslim Calendar dans Home Assistant, vous avez accès aux horaires de prière, aux dates Hijri, aux événements islamiques et à la direction de la Qibla — tout dans un seul plugin.

Muslim Calendar dans Home Assistant

Le plugin Muslim Calendar est disponible via HACS. Il fournit :

sensor.muslim_calendar_hijri_date — date Hijri complète (ex : « 10 Ramadan 1447 »), avec 5 attributs (jour, mois, mois complet, année)
sensor.muslim_calendar_tomorrow_hijri_date — date Hijri du lendemain (même structure)
sensor.muslim_calendar_next_months — dates de début de chaque mois Hijri (12 attributs)
sensor.muslim_calendar_events — prochain événement + tous les événements islamiques indexés par nom
sensor.muslim_calendar_qibla_direction — direction de la Qibla en degrés depuis le Nord
25 entités au total : horaires, Iqamah, dates Hijri, événements, Qibla…

Installation et configuration

Étape 1 : Installez HACS sur votre instance Home Assistant si ce n’est pas déjà fait.

Étape 2 : Ajoutez le dépôt Muslim Calendar dans HACS. Dans HACS, allez dans les trois points en haut à droite, sélectionnez « Dépôts personnalisés », collez l’URL https://github.com/lunarok/muslim_calendar et choisissez « Intégration » comme catégorie.

Étape 3 : Recherchez « Muslim Calendar » dans les intégrations HACS et téléchargez-la. Redémarrez Home Assistant après l’installation.

Étape 4 : Ajoutez l’intégration depuis Configuration > Appareils et services > Ajouter une intégration. Recherchez « Muslim Calendar » et configurez votre position géographique.

Étape 5 : Sélectionnez votre méthode de calcul préférée (15 méthodes disponibles : ISNA, MWL, Umm Al-Qura, Qatar, Singapore, France, Turkey, etc.) ou configurez une méthode personnalisée avec les angles Fajr et Isha.

Méthodes de calcul disponibles

Le plugin supporte 15 méthodes de calcul pour les horaires de prière :

isna — Islamic Society of North America (défaut, recommandé pour les Amériques)
makkah — Umm Al-Qura University, Makkah (recommandé pour l’Arabie Saoudite)
mwl — Muslim World League (recommandé pour l’Europe)
karachi — University of Islamic Sciences, Karachi
egypt — Egyptian General Authority of Survey
qatar — Qatar Calendar House
singapore — Islamic Religious Council of Singapore
france — UOIF (France)
turkey — Presidency of Religious Affairs of Turkey
jafari — Shia Ithna Asheri
custom — angles Fajr et Isha configurables par l’utilisateur

Automatisation du premier jour de Ramadan

Cette automation se déclenche quand le sensor sensor.muslim_calendar_events détecte le prochain événement « First Day of Ramadan ». Elle utilise l’attribut next_event_name.

automation:
  - alias: Premier jour Ramadan detected
    trigger:
      - platform: state
        entity_id: sensor.muslim_calendar_events
        attribute: next_event_name
        to: "First Day of Ramadan"
    action:
      - service: notify.mobile_app_votre_telephone
        data:
          message: "Le Ramadan a commencé ! Que ce mois soit une bénédiction pour vous et votre famille."
          title: "Calendrier Hijri"
    mode: single

Rappel quotidien pendant le Ramadan

Chaque jour pendant le Ramadan, envoyez un rappel avant la première prière (Fajr). La condition vérifie que l’événement « First Day of Ramadan » est dans les 30 prochains jours.

automation:
  - alias: Rappel quotidien Ramadan
    trigger:
      - platform: time
        at: "06:00:00"
    condition:
      - condition: template
        value_template: >
          {% set events = state_attr('sensor.muslim_calendar_events', 'event_first_day_of_ramadan') %}
          {{ events is defined and events != '' }}
    action:
      - service: notify.mobile_app_votre_telephone
        data:
          message: "Il est temps de préparer le pre-Sahur."
          title: "Ramadan"
    mode: single

Notification du premier jour de Shawwal (Aid el-Fitr)

Quand l’événement « Eid al-Fitr » est détecté :

automation:
  - alias: Aid el-Fitr detected
    trigger:
      - platform: state
        entity_id: sensor.muslim_calendar_events
        attribute: next_event_name
        to: "Eid al-Fitr"
    action:
      - service: notify.mobile_app_votre_telephone
        data:
          message: "Eid Mubarak ! L'Aid el-Fitr est aujourd'hui. Que Allah accepte vos prières et vos jeûnes."
          title: "Calendrier Hijri"
    mode: single

Rappels personnalisés pour votre foyer

Vous pouvez ajouter des automatisations basées sur les événements islamiques. Le sensor sensor.muslim_calendar_events indexe tous les événements par nom :

event_islamic_new_year — 1er Muharram (nouvel an Hijri)
event_ashura — 10 Muharram
event_mawlid_al_nabi — 12 Rabi al-Awwal
event_first_day_of_ramadan — 1er Ramadan
event_eid_al_fitr — 1er Shawwal
event_eid_al_adha — 10 Dhu al-Hijjah
event_day_of_arafat — 9 Dhu al-Hijjah

Le sensor sensor.muslim_calendar_qibla_direction vous donne en permanence la direction de la Mecque, utile pour orienter une boussole murale ou un afficheur.