How zubir2k/homeassistant-esolattakwim works
eSolat Takwim is a Home Assistant integration for Malaysian prayer times and Islamic calendar events. A user selects a JAKIM zone in the integration setup; Home Assistant sets up calendar and sensor entities, which obtain and expose prayer and Hijri data, while the calendar also retrieves Islamic events. Prayer times and calendar events are cached locally and reused when retrieval fails. The README also documents a Markdown card and Azan automation blueprint with audio and notification features. The graph includes these documented user-facing capabilities, but their runtime wiring is not established by the sampled source.
Main entry points: prayer_times.py Prayer-time retrieval & cache · calendar.py Calendar & Islamic events · __init__.py Integration lifecycle · config_flow.py Zone setup
Components 14
Setup & lifecycle
- Zone setup
custom_components/esolattakwim/config_flow.py - Integration lifecycle
custom_components/esolattakwim/__init__.py - Zones & API config
custom_components/esolattakwim/const.py
JAKIM data & cache
- Prayer-time retrieval & cache
custom_components/esolattakwim/prayer_times.py - Prayer-time formatting
custom_components/esolattakwim/utils.py - JAKIM e-Solat
- Prayer-time storage
Home Assistant entities
- Calendar & Islamic events
custom_components/esolattakwim/calendar.py - Calendar-event storage
- Prayer & Hijri sensors
custom_components/esolattakwim/sensor.py
User experiences
- Prayer-time Markdown card
MARKDOWN.md - Azan automation blueprint
blueprints/esolat_automation.yaml - Azan & supplication audio
media
Other components
- Home Assistant user
Connections 14
- Home Assistant user → Zone setup: selects zone
README.md - Zone setup → Zones & API config: offers zones
custom_components/esolattakwim/config_flow.py - Integration lifecycle → Calendar & Islamic events: forwards setup
custom_components/esolattakwim/__init__.py - Integration lifecycle → Prayer & Hijri sensors: forwards setup
custom_components/esolattakwim/__init__.py - Calendar & Islamic events → Prayer-time retrieval & cache: fetches & reads
custom_components/esolattakwim/calendar.py - Calendar & Islamic events → JAKIM e-Solat: requests events
custom_components/esolattakwim/calendar.py - Prayer-time retrieval & cache → JAKIM e-Solat: fetches times
custom_components/esolattakwim/prayer_times.py - Prayer-time retrieval & cache → Prayer-time storage: loads & saves
custom_components/esolattakwim/prayer_times.py - Prayer-time retrieval & cache → Prayer-time formatting: formats times
custom_components/esolattakwim/prayer_times.py - Calendar & Islamic events → Calendar-event storage: loads & saves
custom_components/esolattakwim/calendar.py - Prayer & Hijri sensors → Prayer-time retrieval & cache: reads times
custom_components/esolattakwim/sensor.py - Home Assistant user → Prayer-time Markdown card: uses template
README.md - Home Assistant user → Azan automation blueprint: imports automation
README.md - Azan automation blueprint → Azan & supplication audio: plays audio