deen-time

# Deen Time

Your daily Islamic prayer companion. Provides accurate Salah times (Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha) for any city or coordinates worldwide. During Ramadan, also provides Suhoor (pre-dawn meal) and Iftar (fast-breaking) schedules with full monthly calendars.

## When to Use This Skill

Use this skill when the user asks about:
- Prayer times for a specific location
- Iftar or Suhoor times
- Ramadan schedule or timetable
- When to break fast or start fasting
- Fajr, Dhuhr, Asr, Maghrib, or Isha times
- Islamic prayer schedule

## How It Works

This skill uses the **Aladhan Prayer Times API** (`https://aladhan.com/prayer-times-api`), a free and reliable public API that requires no authentication.

### Fetching Prayer Times by City

```bash
curl -L "https://api.aladhan.com/v1/timingsByCity?city={CITY}&country={COUNTRY}&method={METHOD}"
```

Replace `{CITY}`, `{COUNTRY}`, and `{METHOD}` with actual values. URL-encode spaces (e.g., `New%20York`). Always use `-L` to follow redirects.

### Fetching Prayer Times by Coordinates

```bash
curl -L "https://api.aladhan.com/v1/timings/{DD-MM-YYYY}?latitude={LAT}&longitude={LNG}&method={METHOD}"
```

Use this when the user provides latitude/longitude or when a city name is ambiguous.

### Fetching a Full Monthly Calendar

```bash
curl -L "https://api.aladhan.com/v1/calendarByCity/{YEAR}/{MONTH}?city={CITY}&country={COUNTRY}&method={METHOD}"
```

Use this for Ramadan schedules. `{MONTH}` is the Gregorian month number (1-12).

## Calculation Methods

The `method` parameter controls prayer time calculation. Pick the most appropriate one based on the user's region:

| Method | Organization | Best For |
|--------|-------------|----------|
| 1 | University of Islamic Sciences, Karachi | Pakistan, Bangladesh, India |
| 2 | Islamic Society of North America (ISNA) | North America |
| 3 | Muslim World League (MWL) | Europe, Far East |
| 4 | Umm Al-Qura University, Makkah | Saudi Arabia, Gulf |
| 5 | Egyptian General Auth...

# Deen Time

Your daily Islamic prayer companion for OpenClaw. Get accurate Salah times, Iftar/Suhoor schedules, and full Ramadan calendars for any location worldwide.

## Features

- **Daily Salah times**: Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha — works year-round
- **Suhoor & Iftar times**: With Imsak (recommended cutoff) for fasting days
- **City or coordinates**: Look up by city name or lat/lng
- **Monthly Ramadan calendar**: Full month Suhoor/Iftar schedule in one query
- **15+ calculation methods**: ISNA, MWL, Umm Al-Qura, Egyptian, Diyanet, and more — auto-selected by region
- **Hijri dates**: Displays both Gregorian and Islamic calendar dates

## Usage

Once installed, just ask your OpenClaw agent:

- "What are the prayer times for London?"
- "When is Maghrib in Calgary?"
- "Iftar time for Dubai"
- "Give me the Ramadan schedule for Istanbul"
- "Suhoor time for New York?"

## Installation

```bash
clawhub install deen-time
```

## API

Powered by the [Aladhan Prayer Times API](https://aladhan.com/prayer-times-api) — free, public, and requires no API key.

## Security and Privacy

- All API calls are **read-only HTTPS** requests to `api.aladhan.com`
- Only city/country names or coordinates are sent — **no personal data**
- No API keys, authentication, or credentials required
- No data is stored or written to disk

## License

MIT