Assalamu'alaikum

This is an Islamic calendar and Prayer time integration for Malaysia.
Instead of creating a sensor for each events and prayer time, I thought of using calendar entity instead.

May this be beneficial to all, InshaAllah

🚩 Features

• Automatic prayer time retrieval from JAKIM (and stored locally)
• Takwim/Calendar information from JAKIM
• Prayer time information available as attributes in the calendar entity
• Prayer time format in Datetime UTC (e.g. 2023-07-29T22:01:00+00:00)
• current and next prayer time indicator available as attribute

🕹️ Installation

With HACS

Tip

If you are unable to use the button above, manually search for eSolat Takwim in HACS.

Manual

1. Copy the esolattakwim directory from custom_components in this repository and place inside your Home Assistant's custom_components directory.
2. Restart Home Assistant
3. Follow the instructions in the Setup section

Warning

If installing manually, in order to be alerted about new releases, you will need to subscribe to releases from this repository.

📦 Setup

Tip

If you are unable to use the button above, follow the steps below:

1. Navigate to the Home Assistant Integrations page (Settings --> Devices & Services)
2. Click the + ADD INTEGRATION button in the lower right-hand corner
3. Search for eSolat Takwim Malaysia
4. Select location zone to your preference

🪄 Prayer Time Markdown Card

I have prepared a markdown card template for this integration. You may refer to the Markdown.md and copy the markdown codes.

🪄 Automation Azan Blueprint

Features:

• Speaker selection
  • Choose either Google or Alexa
• Mobile Notification
  • Push notification for 15min reminder and during prayer time
• Audio Notification
  • Audio playback based on speaker selection
  • Custom audio for adhan (except for audio announcement that are currently fixed).
• Miscellaneous Audio
  • Morning supplication dua'
  • Takbir during Eidul Fitr and Eidul Adha

Caution

Important Note:
Due to some limitation on the Alexa media playback, I had to make the audio permanent and could not be changed (both announcement and adhan itself). Only applicable to Alexa speaker 🔊

📢 Disclaimer & Data Source

Important Notice & Reliability Disclaimer

This integration pulls data directly from the official e-Solat JAKIM (Department of Islamic Development Malaysia) portal. However, please note:

• No Liability: This integration is a community-driven project provided "as is" without any guarantees. The maintainer is not solely or legally responsible for any discrepancies, inaccuracies, delays, or omissions in prayer times or calendar dates.
• Verify Important Times: Users are strictly advised to regularly check and verify times against the official JAKIM eSolat Portal or official local announcements, especially for critical obligations (e.g., fasting, community prayers).
• Network & Upstream Dependencies: Synchronization depends on upstream API availability and local network connectivity. Discrepancies caused by unexpected server updates from JAKIM or local server downtime are outside the control of this software.

By using this integration, you acknowledge and agree that the developer holds no liability for missed schedules or data inaccuracies.

🎖️ Credits

• Takwim and prayer time data are provided by e-solat JAKIM (Department of Islamic Development Malaysia)
• Join our Community Home Assistant Malaysia