Deen Reminder
Add to Discord
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.

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.

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

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.

All Commands

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

Setup & Core 6 commands
CommandParametersDescription
/setupcity, 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.
/settingsView all your current settings.
/todayToday's full prayer timetable, Hijri date, and Ramadan status.
/calendarFull current Hijri month calendar. Every day shows its Gregorian equivalent. Today is bolded, special days highlighted.
/contactShows links to the developer profile, support server, and documentation. Use this to report bugs or request features.
/qiblaOpens 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
CommandParametersDescription
/togglereminder: prayers | fasting | festivals | hadith | allTurn reminder categories on or off. Each is independent. all is a master switch.
/suhoorminutes: 1–90Set how many minutes before Fajr the Suhoor reminder fires. Default is 30.
/hadithFetch 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
CommandParametersDescription
/adjustfajr, 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_adjustmentsReset all prayer time offsets back to 0 in one go.
/hijriadjustoffset: −2 | −1 | 0 | +1 | +2Shift your Hijri date by up to ±2 days if your region follows local moon sighting.
/setmethodmethod_number: see /methodsOverride the auto-detected calculation method. Use /methods to browse all options.
/asrmadhab: standard | hanafiSwitch between Standard (Shafi'i) and Hanafi Asr timing.
/methodsList the 9 recommended calculation methods with regional tags.

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.

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.

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 & 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.

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.

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.

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.

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 Methods

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

1
University of Islamic Sciences, Karachi
Pakistan / Bangladesh / South Asia
2
Islamic Society of North America (ISNA)
USA / Canada
3
Muslim World League (MWL)
International / Europe / default
4
Umm al-Qura, Makkah
Saudi Arabia
5
Egyptian General Authority of Survey
Egypt / Middle East / Africa
8
Gulf Region
Kuwait, Bahrain, Qatar, Oman
15
Moonsighting Committee Worldwide
Moon-sighting based
16
Dubai (UAE)
United Arab Emirates
17
Islamic Affairs and Endowments
India
Use /methods in Discord to see all available methods. Switch with /setmethod method_number:4.

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.

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

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.

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