prayer-times

What This Skill Does

The Prayer Times skill provides precise Islamic prayer schedules for any location worldwide. By leveraging the AlAdhan API, it retrieves accurate Fajr, Dhuhr, Asr, Maghrib, and Isha timings. Beyond simple lookups, the skill features a sophisticated background reminder system designed to keep users connected to their prayers throughout the day. It supports over 20 country-specific calculation methods—including the Umm Al-Qura method for Saudi Arabia, the Diyanet method for Turkey, and the Egyptian General Authority of Survey—ensuring regional accuracy for diverse communities. The system intelligently handles scheduling, sending notifications 10 minutes prior to the prayer, exactly at the prayer time, and a follow-up 5 minutes later.

Installation

To integrate this capability into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/diepox/muslim-prayer-reminder After installation, ensure you have python3 configured in your environment as the scripts rely on standard local execution. For recurring background alerts, ensure your system cron daemon is active to trigger the check_prayer_reminder.py script at regular intervals.

Use Cases

This skill is designed for daily lifestyle management and spiritual discipline. Use it to:

• Quickly verify the start and end times for daily prayers while traveling.
• Automate desktop or system notifications to maintain a prayer schedule amidst a busy workflow.
• Retrieve specific date-based schedules for future trip planning.
• Calculate local prayer times based on precise GPS coordinates when city data is unavailable.

Example Prompts

1. "What time is Maghrib today in Istanbul?"
2. "Show me the next prayer time for Riyadh and set a reminder for it."
3. "When is the Fajr prayer tomorrow in Cairo?"

Tips & Limitations

• The skill defaults to the most common local calculation methods based on the country provided. If your mosque follows a specific local deviation, use the --method flag to manually select the ID from the references/methods.md documentation.
• Always provide the correct timezone offset if you are using the --next prayer feature to ensure the countdown timer accurately reflects your current local time.
• While the script handles automated reminders, ensure your host environment permits long-running background processes or periodic cron jobs to enable the notification features.