Smart Islamic Companion

Deen Reminder

رمضان مبارك — الله أكبر

Your personal Islamic companion on Discord. Prayer times, Suhoor & Iftar alerts, Hadith of the day, Islamic calendar, festival reminders, and AI-powered assistance — all in your DMs.

Add to Discord Quick Start

✦All 5 daily prayers

✦Suhoor & Iftar alerts

✦Hadith of the day

✦Islamic calendar

✦Qibla finder

✦AI Islamic assistant

✦9 calculation methods

✦Global timezone support

✦Works without a server

AI-Powered Conversations

Just chat in your DMs — the bot understands natural language and guides you to the right commands.

Getting Started

Quick Start — 3 Steps

Get up and running in under a minute. No server required — works straight from DMs.

Setup flow

Step 1

Set your location

Run /setup with your city and country. Timezone is auto-detected — no need to look it up. Auto-detects your calculation method too.

Step 2

Enable what you want

Use /toggle to turn on categories. Nothing is on by default.

Step 3

Receive DMs

Reminders go straight to your DMs at the right time. Or just chat — the bot understands you.

# Minimal — Suhoor & Iftar only
/setup  city:London  country:UK  # timezone auto-detected!
/toggle reminder:fasting

# Full setup — everything + Hanafi Asr + fix Hijri date
/setup  city:Karachi  country:Pakistan  # timezone auto-detected!
/asr    madhab:hanafi
/toggle reminder:prayers
/toggle reminder:fasting
/toggle reminder:festivals
/toggle reminder:hadith
/adjust fajr:5  # delay by +minutes only — no negatives
/hijriadjust offset:-1  # if your region follows moon sighting

Core System

Reminder Categories

Five distinct categories — enable any combination independently.

Prayer Times

DM at each of the five daily prayers. Each reminder shows the next upcoming prayer and includes a 🕌 Record Prayer button to mark it as done.

/toggle reminder:prayers

Fasting — Suhoor + Iftar

Suhoor fires before Fajr (configurable, default 30 min). Iftar fires at Maghrib. One toggle controls both.

/toggle reminder:fasting

Festival Reminders

Get notified at 6 AM on Eid, Ashura, Mawlid al-Nabi, Laylat al-Qadr, and more — based on the Hijri calendar.

/toggle reminder:festivals

Islamic Calendar

View the full current Hijri month with Gregorian dates, today highlighted, and all special occasions marked. Use /hijriadjust to match your local moon-sighting.

/calendar

Hadith of the Day

Daily DM at 7 AM with a hadith from Bukhari, Muslim, Tirmidhi, Abu Dawud, or Ibn Majah. Or use /hadith on demand anytime.

/toggle reminder:hadith

Qibla Finder

Live animated compass that points toward the Kaaba. Uses your saved location and corrects for magnetic declination — open in your phone browser.

/qibla

AI Assistant

Message the bot naturally in DMs. It understands your question, knows your local time and settings, and tells you exactly which command to run.

Just type in DMs

All reminders are off by default. After /setup, nothing is sent until you enable a category with /toggle.

Reference

All Commands

Every interaction uses Discord slash commands. Type / in any channel or DM.

Setup & Core 6 commands

Command	Parameters	Description
/setup	city, country, timezone (optional)	Save your location. Timezone is auto-detected from your city — you only need to enter it manually if auto-detection fails. Auto-detects best calculation method. Run this first.
/settings	—	View all your current settings.
/today	—	Today's full prayer timetable, Hijri date, and Ramadan status.
/calendar	—	Full current Hijri month calendar. Every day shows its Gregorian equivalent. Today is bolded, special days highlighted.
/contact	—	Shows links to the developer profile, support server, and documentation. Use this to report bugs or request features.
/qibla	—	Opens a live animated Qibla compass in your browser. Uses your saved location — no GPS prompt. Corrected for magnetic declination via the NOAA World Magnetic Model.

Reminders & Toggles 3 commands

Command	Parameters	Description
/toggle	reminder: prayers \| fasting \| festivals \| hadith \| all	Turn reminder categories on or off. Each is independent. `all` is a master switch.
/suhoor	minutes: 1–90	Set how many minutes before Fajr the Suhoor reminder fires. Default is 30.
/hadith	—	Fetch a random hadith on demand from Bukhari, Muslim, Tirmidhi, Abu Dawud, or Ibn Majah.

AI & Chat New Natural language

You don't need to know any commands. Just send a message like "set me up for London" or "turn on prayer reminders" — the AI understands and responds with the right action.

Prayer Adjustments & Hijri Fine-tune times & dates

Command	Parameters	Description
/adjust	fajr, dhuhr, asr, maghrib, isha (all optional, 0 or more minutes)	Delay any prayer time to match your local mosque. Positive values only. Leave any blank to skip.
/reset_adjustments	—	Reset all prayer time offsets back to 0 in one go.
/hijriadjust	offset: −2 \| −1 \| 0 \| +1 \| +2	Shift your Hijri date by up to ±2 days if your region follows local moon sighting.
/setmethod	method_number: see /methods	Override the auto-detected calculation method. Use `/methods` to browse all options.
/asr	madhab: standard \| hanafi	Switch between Standard (Shafi'i) and Hanafi Asr timing.
/methods	—	List the 9 recommended calculation methods with regional tags.

Intelligence

AI Assistant

The bot is powered by AI — you can speak to it naturally, no command memorisation required.

Try: "Remind me of all prayers", "What's the Hanafi method?", "I'm in Istanbul, set me up", or "Remind me for Asr at 4:30 PM"

One-time prayer reminders: Ask the AI to remind you for a specific prayer at a specific time — e.g. "Remind me for Asr at 4:30". It will fire once at that time only, within the valid prayer window.

Once you've run /setup, the AI knows your location, timezone, and active settings — so it can give accurate, personalised answers without you repeating yourself.

Fasting

Suhoor Alert Timing

Configure how many minutes before Fajr you receive the Suhoor wake-up reminder.

Default is 30 minutes before Fajr. Use /suhoor minutes:45 to change it. Range: 1–90 minutes.

Suhoor and Iftar reminders fire every day once /toggle reminder:fasting is enabled — not just during Ramadan.

Islamic Calendar

Festival Reminders

Receive a DM notification on the morning of each Islamic festival and holy night.

Eid al-Fitr

1 Shawwal

Eid al-Adha

10 Dhul Hijjah

Laylat al-Qadr

27 Ramadan

Mawlid al-Nabi

12 Rabi al-Awwal

Ashura

10 Muharram

Isra wal Mi'raj

27 Rajab

Laylat al-Bara'ah

15 Sha'ban

Islamic New Year

1 Muharram

Festival reminders fire at 6 AM in your timezone on the day of the occasion. Dates are based on the Hijri calendar — use /hijriadjust if your region follows local moon sighting.

Islamic Calendar

Islamic Calendar & Hijri Date

View the full current Hijri month or look up today's Islamic date — and fix it if your region's moon sighting differs from the API.

/calendar — Shows the full Hijri month as a two-column embed. Every day shows its Gregorian equivalent. Today is bolded with a ◀ marker. Special days get their emoji inline and are summarised at the bottom.

/today includes the Hijri date inline with prayer times, along with Sunrise, Ramadan status, and any special occasion.

Hijri date off by 1 day? Use /hijriadjust offset:-1 (or +1) to correct it.

Knowledge

Hadith of the Day

Daily hadith delivered to your DMs, or fetch one on demand anytime.

/toggle reminder:hadith — Enable a daily hadith DM at 7 AM in your timezone. Each hadith shows the chapter, narration, and source reference.

/hadith — Fetch a random hadith on demand. Works in any channel or DM, no setup needed. Randomly selects from Bukhari, Muslim, Tirmidhi, Abu Dawud, and Ibn Majah.

Features

Qibla Finder

Find the direction of the Kaaba from anywhere in the world — a live animated compass that responds to your phone's movement, right in your browser.

/qibla — Sends you a link to a live compass page. Your saved location is passed automatically — no GPS prompt needed. Just tap and hold your phone flat.

The compass uses the NOAA World Magnetic Model to correct for magnetic declination at your exact location — the same model used by aviation and navigation apps — giving you true-north accuracy instead of raw magnetic bearing.

For best results, hold your phone flat and level. Move away from metal objects, speakers, or other electronics which can interfere with the magnetometer. If the needle drifts, wave your phone in a slow figure-8 to recalibrate.

Fine-tuning

Prayer Time Adjustments

Delay individual prayer times by a positive number of minutes to match your local mosque's timetable. The bot validates each offset against the prayer's window — it won't let you push a prayer past the next one.

Example: /adjust fajr:5 maghrib:3 delays Fajr by 5 minutes and Maghrib by 3 minutes. Any combination of the 5 prayers can be adjusted in a single command. Only positive values are accepted.

Adjustments persist across days and survive /setup re-runs. Clear everything at once with /reset_adjustments.

Jurisprudence

Asr Madhab

Choose between the two main schools of thought for Asr timing.

Standard (Shafi'i / Maliki / Hanbali)

Default for most countries. Run /asr madhab:standard.

Hanafi

Makes Asr later in the afternoon. Run /asr madhab:hanafi.

Calculation

Calculation Methods

9 widely-used methods supported. The bot auto-detects based on your country. Override with /setmethod.

University of Islamic Sciences, Karachi

Pakistan / Bangladesh / South Asia

Islamic Society of North America (ISNA)

USA / Canada

Muslim World League (MWL)

International / Europe / default

Umm al-Qura, Makkah

Saudi Arabia

Egyptian General Authority of Survey

Egypt / Middle East / Africa

Gulf Region

Kuwait, Bahrain, Qatar, Oman

Moonsighting Committee Worldwide

Moon-sighting based

Dubai (UAE)

United Arab Emirates

Islamic Affairs and Endowments

India

Use /methods in Discord to see all available methods. Switch with /setmethod method_number:4.

Privacy

DM Access

All reminders go to your Discord DMs. You need to allow DMs from the bot for it to work.

Go to Discord → User Settings → Privacy & Safety → Allow direct messages from server members. Or DM the bot directly first to open the channel.

Global

Timezones

Timezone is now auto-detected from your city and country — you don't need to enter it manually. If auto-detection fails, you can provide it manually using IANA timezone strings. Common examples below.

Middle East

Asia/Riyadh
Asia/Dubai
Asia/Kuwait
Asia/Baghdad
Asia/Tehran

South Asia

Asia/Karachi
Asia/Kolkata
Asia/Dhaka
Asia/Colombo

Europe

Europe/London
Europe/Paris
Europe/Istanbul
Europe/Berlin

North America

America/New_York
America/Chicago
America/Toronto
America/Los_Angeles

SE Asia

Asia/Kuala_Lumpur
Asia/Jakarta
Asia/Singapore
Asia/Manila

Africa

Africa/Cairo
Africa/Lagos
Africa/Nairobi
Africa/Casablanca

Help

Troubleshooting

Common issues and how to fix them.

Hijri date showing wrong day?

The bot uses astronomical calculation which can differ by ±1 day from your region's moon sighting. Fix it with /hijriadjust offset:-1 (or +1).

How does the prayer record button work?

Every prayer reminder DM includes a 🕌 Record Prayer button. Tap it and the message edits itself — the embed turns green, the title updates to "✅ [Prayer] — Recorded", and the button goes grey and disabled. It's personal tracking only. The button is persistent — it never expires and continues to work even after bot restarts.

Not receiving DMs?

Go to Discord → User Settings → Privacy & Safety → Allow direct messages from server members. Or DM the bot directly first.

Prayer times off by 30+ minutes?

Run /methods and switch with /setmethod method_number:. Auto-detection is accurate for most countries but can be overridden.

Setup says city not found?

Use the common English name of the nearest major city without special characters. E.g., Istanbul not İstanbul.

Moved cities and need to update?

Run /setup again. All toggle settings, Asr madhab, Suhoor timing, and adjustments are preserved.

Not sure what to do?

Just message the bot in DMs in plain English — the AI will guide you to the right command.

Contact

Get in Touch

Question, bug, or feature idea? Hit me up directly on Discord.

Talk to the Developer

Questions, bug reports, or feature ideas — send a DM on Discord. I usually respond within a day, InshAllah.

Message on Discord

@fargis

Support Server

Join the community — ask questions, report bugs, suggest features, or just say salaam. 🤝

Join the Server

discord.gg/uv2tJ74SEJ