A MAWAQIT component for Home Assistant

Smart home, Smart mosque : automate things based on prayer times

ٱلسَّلَامُ عَلَيْكُمْ وَرَحْمَةُ ٱللَّٰهِ وَبَرَكَاتُهُ

Essalāmu ʿalaykum wa rahmatu Allahi wa barakatuh

English

This component allows you to integrate the data of your mawaqit mosque into Home Assistant. To do this, a Mawaqit account from https://mawaqit.net is required.

Integration installation options

The component is added to Home Assistant in the form of an integration. There are two methods to install the integration as mentioned below.

With HACS

If you have HACS installed on your Home Assistant then you can use it to install Mawaqit integration.

Go to your HACS dashboard, then open the settings (3 dots at the top right corner) and select Custom Repositories.
Now in Repository text field put the URL of this repo: https://github.com/mawaqit/home-assistant
In the type field select Integration
Click Add button to finish the setup

Manual installation

For the manual installation, you must copy the custom_components/mawaqit folder from this repository to the custom_components directory of your Home Assistant installation (create it if it does not exist).

Setup Mawaqit integration

Restart Home Assistant installation (e.g. From UI go to Settings > System > Hardware > Power button at top right)
After restarting Home Assistant, go to Settings > Devices & Services > Add Integration and search for "Mawaqit".
Enter the login and password of your mawaqit.net account and click on Submit.
Based on your GPS coordinates (latitude/longitude) stored in Home Assistant, the component searches for Mawaqit mosques within a radius of 20km around you and will ask you to select your preferred mosque.

Components of Mawaqit Integration

Integration allows you to add 14 components of type sensor :

The 5 prayer times
The Iqama of 5 prayers,
The Shuruq
The Jumu'a time
A sensor sensor.my_mosque which summarizes all the data of your mosque (address, website, jumua, iqama, etc...)

Automation Examples

In the automations.yaml file, you have an example of code to create automation in Home Assistant with Mawaqit sensors, in particular to launch the athan at the time of prayer or to launch specific actions (read the Quran, increase the heating 10 minutes before Al-Fajr, open the shutters during shuruq, etc...). NOTE: The actions are to be adapted according to your Home Assistant installation.

/config/configuration.yaml Make sure that you have time sensor configured in your Home Assistant configuration. In the automations.yaml example this sensor is used to make decision when to launch Azan.

homeassistant:
sensor:
  platform: time_date
  display_options:
    - 'time'
    - 'date_time'

/config/automations.yaml

- id: 'fajr_wakeup'
  alias: Turn on bedroom light and Alexa routine, 20 min before Fajr Athan
  trigger:
  - platform: template
    value_template: >
      {% set before = (as_timestamp(states("sensor.fajr_adhan")) - 20 * 60) | timestamp_custom("%H:%M", True) %} 
      {% set time = states("sensor.time") %}
      {{ time == before }}
  action:
  # turn on the light of the bedroom
  - service: switch.turn_on
    entity_id: switch.sonoff_1000814ec9 # the entity id of the sonoff switch, can be an other entity
  # play a routine on Alexa
  - service: media_player.play_media
    entity_id: media_player.zehhaf_s_echo_dot # the entity id of your alexa device
    data:
      media_content_id: bonjour # the routine name configured on Alexa mobile app, it can be a sequence of actions, like flash info, weather ...etc
      media_content_type: routine
  initial_state: true
  mode: single      

# Play adhan on a connected speaker
- id: 'isha_adhan'
  alias: Isha adhan
  trigger:
    platform: template
    value_template: >
      {% set isha_time = as_timestamp(states("sensor.isha_adhan")) | timestamp_custom("%H:%M", True) %} 
      {% set time = states("sensor.time")  %}
      {{ time == isha_time }}
  action:
    - service: mqtt.publish
      data_template:
        topic: 'commande/play/mini'
        payload: 'http://192.168.10.101/mp3/adhan.mp3' # an http url to mp3 file
  initial_state: true
  mode: single

Français

Ce composant permet d'intégrer les données de votre mosquée Mawaqit dans Home Assistant. Pour ce faire, Un compte Mawaqit https://mawaqit.net est nécessaire.

Le composant est rajouté à Home Assistant sous forme d'une intégration. Pour l'installation, il faut copier le dossier custom_components/mawaqit dans le répertoire custom_components de votre installation Home Assistant (créez le s'il n'existe pas).

Après le redémarrage de Home Assistant, allez dans Paramètres > Appareils et Services > Ajouter une intégration et cherchez "Mawaqit". Entrez le login et mot de passe de votre compte mawaqit.net et cliquez sur Valider. En se basant sur vos coordonnées GPS (latitude/longitude) enregistrées dans Home Assistant, le composant cherche les mosquées Mawaqit dans un rayon de 20 km autour de vous et vous demande de sélectionner votre mosquée préférée.

L'intégration permet de rajouter 14 composants de type sensor : les 5 horaires des prières, les iqamas associées, le Shuruq, les horaires de Jumu'a et un sensor sensor.my_mosque qui résume toutes les données de votre mosquée (adresse, site web, jumua, iqama, etc...).

Dans le fichier configuration.yaml, vous avez un exemple de code pour créer des automatismes dans Home Assistant avec les sensors Mawaqit notamment pour lancer l'athan à l'heure de la prière ou encore pour lancer des actions spécifiques (lire le Coran, augmenter le chauffage 10 minutes avant Al-Fajr, ouvrir les volets lors du Shuruq etc...). Les actions sont à adapter en fonction de vote installation Home Assistant.

mawaqit/home-assistant