Prayer Notifier 🕌

A lightweight desktop app that detects your location automatically and reminds you of prayer times with a Windows notification and a sound alert.

Built for Muslims who spend long hours on the computer and don't want to miss a prayer.

---

Features

• 📍 Auto-detects your city and country from your IP
• 🕐 Fetches accurate daily prayer times from AlAdhan API
• 🔔 Sends a Windows notification 5 minutes before each prayer
• 🕌 Sends another notification at the exact prayer time
• 🔊 Plays a beep sound with every alert
• 📅 Shows the current Hijri date
• ⚡ Highlights the next upcoming prayer
• 🖥️ Clean Arabic UI

---

Project Structure

prayer_notifier/
├── prayer_notifier/
│   ├── __init__.py
│   ├── core.py        # location + prayer times logic
│   ├── notifier.py    # notifications + sound
│   └── gui.py         # main window
├── tests/
│   └── test_core.py
├── main.py
├── requirements.txt
└── README.md

---

Install & Run

pip install -r requirements.txt
python main.py

CLI mode (shows today's times in terminal)

python main.py --cli

---

Run Tests

python -m unittest discover tests/ -v

---

Requirements

• Python 3.9+
• Windows 10 or 11
• Internet connection (for location + prayer times)

---

APIs Used

• ipapi.co — IP-based location
• AlAdhan — Prayer times (Egyptian method)