{"id":22873581,"url":"https://github.com/zubir2k/homeassistantadzan","last_synced_at":"2025-05-06T18:15:22.963Z","repository":{"id":150805817,"uuid":"382654875","full_name":"zubir2k/HomeAssistantAdzan","owner":"zubir2k","description":"🕋 Automation for Malaysia Adzan (Muslim call to prayer) based on JAKIM API. Give support by pressing the ⭐ button. Jazakallahu khair","archived":false,"fork":false,"pushed_at":"2024-02-14T15:01:37.000Z","size":24091,"stargazers_count":28,"open_issues_count":0,"forks_count":8,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-06T18:15:17.449Z","etag":null,"topics":["automation","azan","home-assistant","home-assistant-config","home-automation","homeassistant","integration","jakim","malaysia","prayer-times","template","yaml"],"latest_commit_sha":null,"homepage":"https://sini.la/homeassistantmalaysia","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zubir2k.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml.old","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"zubirjamal","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2021-07-03T15:57:14.000Z","updated_at":"2025-04-14T07:52:34.000Z","dependencies_parsed_at":"2024-02-05T05:41:33.500Z","dependency_job_id":null,"html_url":"https://github.com/zubir2k/HomeAssistantAdzan","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zubir2k%2FHomeAssistantAdzan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zubir2k%2FHomeAssistantAdzan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zubir2k%2FHomeAssistantAdzan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zubir2k%2FHomeAssistantAdzan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zubir2k","download_url":"https://codeload.github.com/zubir2k/HomeAssistantAdzan/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252741474,"owners_count":21797027,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","azan","home-assistant","home-assistant-config","home-automation","homeassistant","integration","jakim","malaysia","prayer-times","template","yaml"],"created_at":"2024-12-13T14:20:11.051Z","updated_at":"2025-05-06T18:15:22.922Z","avatar_url":"https://github.com/zubir2k.png","language":null,"funding_links":["https://ko-fi.com/zubirjamal"],"categories":[],"sub_categories":[],"readme":"![Home Assistant Adzan](https://user-images.githubusercontent.com/1905339/170957516-6173d318-2600-4372-bc19-b13e224272de.png)\\\n![GitHub Repo stars](https://img.shields.io/github/stars/zubir2k/HomeAssistantAdzan?style=social)\n[![Twitter Follow](https://img.shields.io/twitter/follow/zubirjamal?label=Follow\u0026style=social)](https://twitter.com/zubirjamal)\n[![Repo](https://img.shields.io/badge/zubir2k-repository-brightgreen?logo=github)](https://zubirco.de/) \n[![Donate](https://img.shields.io/badge/donate-Coffee-yellow.svg)](https://zubirco.de/buymecoffee)\n\nAutomation for Malaysia Adzan (Muslim call to prayer) based on the following sources:\n- JAKIM Official (eSolat) - [Website](https://www.e-solat.gov.my).\n- AzanPro - [Website](https://api.azanpro.com).\n- Home Assistant Official Islamic Prayer Time - [Website](https://www.home-assistant.io/integrations/islamic_prayer_times).\n\n**Whats New in v4**\n- Fully revamped eSolat sensors.\n- Easy install with minimal configuration.\n- Prayer time sensor will show in timestamp format. 12/24hours format are now in attributes.\n- Automation are now created by default automatically. However, you may choose to create your own.\n- Dynamic Media Player selector.\n- Added support the official Home Assistant Islamic Prayer Time\n- Volume Slider Control based on the selected speaker/media_players (feature added from [pull-request #2](https://github.com/zubir2k/HomeAssistantAdzan/pull/2))\n- Version checker \u0026 updater (NOTE: The updater will only update essential files only).\n\n**The Default Automation will perform the following:**\n- Play TTS (for Google) or Play audio TTS (for Alexa)\n- Play Azan\n- Send Persistent Notification (Azan \u0026 15min Reminder)\n- Send default Notification (notify.notify)\n\n## Screenshot\n![image](https://user-images.githubusercontent.com/1905339/154905774-b63319d5-4b4b-46e5-9fab-8efdeeb10400.png)\n\n![image](https://github.com/zubir2k/HomeAssistantAdzan/assets/1905339/edf6e02f-d883-4bcd-860b-1a0adcf85213)\n\n![image](https://github.com/zubir2k/HomeAssistantAdzan/assets/1905339/83adcf9b-b3be-486e-872f-13c3a8136acd)\n\n![lovelace-dashboard](https://user-images.githubusercontent.com/1905339/196147059-341c5e1d-17af-4d88-b9de-a0932759dc85.png)\n\n![image](https://github.com/zubir2k/HomeAssistantAdzan/assets/1905339/f8a19c2a-dedf-45a1-905a-af0d4110d043)\n\n## Video Tutorial\n\n[![Youtube](https://user-images.githubusercontent.com/1905339/197347154-463881c9-dfdb-4dbb-ae03-5764022a0a84.png)](https://youtu.be/SVzybCpjWGQ)\n\n- Automation Adzan using Home Assistant: https://youtu.be/SVzybCpjWGQ\n- Beginners Guide to Home Assistant: https://youtu.be/-jyegp-mL20 \n\n## Installation\n### 1. Copy all files\n- Browse into your Home Assistant directory and paste all files into `\\config` and `\\media`.\n\n### 2. Add eSolat into [configuration.yaml](configuration.yaml)\n- Add the following line into the config file\n\n```yaml\nhomeassistant:\n  packages: !include_dir_named HAMY/\n```\n\n- Restart Home Assistant to take effect.\n\n### 3. Dashboard [lovelace-ui.yaml](lovelace-ui.yaml)\n- Add new card, scroll at the bottom and choose Manual. \n- Copy \u0026 paste the YAML respectively.\n\n![image](https://user-images.githubusercontent.com/1905339/196153827-56e67de2-1591-46aa-9b10-090d5dfb9633.png)\n\n## Configure eSolat\n### 1. Source\n- Select source (Jakim/AzanPro/Local/Islamic Prayer Time)\n- Enter state code (not applicable for Islamic Prayer Time) -- Refer state code [here](https://www.e-solat.gov.my/index.php?siteId=24\u0026pageId=50). \n- For Islamic Prayer Time, please ensure to complete the configuration in the Home Assistant Integration menu\n\n### 2. Azan Audio \u0026 Automation\n- Select your preferred media player \n- Choose your automation (Google or Alexa). Select Custom if you wish to use your own automation.\n- **For Google**, please enter `azan.mp3` and `azansubuh.mp3` as your audio files. You may use your own mp3 stored in your `\\media` folder.\n- **For Alexa**, please enter your `home_url`. **IMPORTANT**: Please ensure [Alexa_Media_Player](https://github.com/custom-components/alexa_media_player) addon has been configured.\n\n### 3. Refresh\n- Click here \n[![Open your Home Assistant instance and show your automations.](https://my.home-assistant.io/badges/automations.svg)](https://my.home-assistant.io/redirect/automations/) to open your automation panel.\n- Run `Azan Yearly Update`\n\n\u003e ![image](https://user-images.githubusercontent.com/1905339/211257538-94f8e7fb-60dc-4fa9-a355-5e5ea887ece6.png)\n\n- Press both Online and Local sensors to take effect. \n\n## Automation Ideas\nThere are many ways that you can benefit from the prayer time sensors.\n\n### 1. Execute action upon x minute **before** prayer time.\nExample: 15min before Maghrib, play random surah. `15*60` where 15 is in minutes.\n\n```yaml\n{{ state_attr('sensor.solat_maghrib', '24hours') == (now().strftime('%s') | int + 15*60) | timestamp_custom(\"%H:%M\", false) }}\n```\n\n### 2. Random play audio\nExample: Random play Surah before/after azan.\n\n```yaml\n  - service: media_player.play_media\n    data:\n      media_content_type: audio/mp3\n      media_content_id: |\n        {{ [\"media-source://media_source/local/audio/surah1.mp3\",\n            \"media-source://media_source/local/audio/surah2.mp3\",\n            \"media-source://media_source/local/audio/surah3.mp3\",\n            \"media-source://media_source/local/audio/surah4.mp3\",\n            ] | random }}\n```\n\n### 3. Others\nSend notification to any Android TVs and perhaps then shutting off the TV. \\\nExample: Alert family to get ready for Maghrib. Then turn off the TV 😁\n\n## Special Thanks\n- [@farxpeace](https://github.com/farxpeace) - for the original integration code for AzanPro\n- [HomeAssistantMalaysia](https://www.facebook.com/groups/homeassistantmalaysia)\n\n*You may also try [GPS Based](https://github.com/zubir2k/HomeAssistantEsolatGPS) Solat sensor using Appdaemon. (API provided by MPT)*\n\n## ⚠ Disclaimer\nTHIS IS NOT AN INTEGRATION ADD-ON ([issue#3](https://github.com/zubir2k/HomeAssistantAdzan/issues/3)). THIS IS A TEMPLATE THAT CREATES SENSORS AND AUTOMATION FOR ADZAN PRAYER.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzubir2k%2Fhomeassistantadzan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzubir2k%2Fhomeassistantadzan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzubir2k%2Fhomeassistantadzan/lists"}