Skip to main content

Astronomy-based Islamic prayer time calculation engine in Python

Project description

🕌 PyIslamic Prayer

An open-source, astronomy-based Islamic prayer time calculation engine written in pure Python.


👨‍💻 Developers

🏢 Organization

Crescenton

📧 crescentononline@gmail.com
🌐 https://cresenton.netlify.app/


✨ Features

  • Accurate prayer times using latitude & longitude
  • Supports all major Sunni madhhab-based Asr calculations
  • Multiple global calculation methods:
    • Muslim World League (MWL)
    • Egyptian General Authority
    • Karachi Method
    • Umm al-Qura
  • Qibla direction calculation using great-circle formula
  • High-latitude adjustment support
  • Fully offline (no internet/API required)
  • Lightweight, fast, and dependency-free

📦 Installation

pip install pyislamic-prayer


🚀 Quick Start

from pyislamic_prayer import PrayerTimes

pt = PrayerTimes( latitude=33.6844, longitude=73.0479, method="MWL" )

times = pt.get_times()

for prayer, time in times.items(): print(prayer, ":", time)


🧭 Qibla Direction

from pyislamic_prayer import qibla_direction

direction = qibla_direction(33.6844, 73.0479) print("Qibla Direction:", direction, "degrees")


📖 Calculation Methods

Method Description
MWL Muslim World League
EGYPT Egyptian General Authority
KARACHI University of Karachi
UMM_AL_QURA Umm al-Qura University

🧮 Example Output

Fajr: 05:12
Dhuhr: 12:30
Asr: 15:45
Maghrib: 18:10
Isha: 19:25


🏗 Project Status

  • ✔ Core calculation engine complete
  • ✔ Offline support implemented
  • ✔ Qibla direction feature added
  • 🔄 Continuous improvements in progress

📜 License

This project is licensed under the MIT License.


🌙 About Crescenton

Crescenton is an open innovation hub focused on:

  • AI systems
  • Educational tools
  • Islamic tech solutions
  • Software & animation development

https://cresenton.netlify.app/


🤝 Contributing

Pull requests are welcome. For major changes, open an issue first.


⭐ Support

If you like this project, star it on GitHub and share it with others.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyislamic_prayer-1.0.0.tar.gz (5.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pyislamic_prayer-1.0.0-py3-none-any.whl (7.2 kB view details)

Uploaded Python 3

File details

Details for the file pyislamic_prayer-1.0.0.tar.gz.

File metadata

  • Download URL: pyislamic_prayer-1.0.0.tar.gz
  • Upload date:
  • Size: 5.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for pyislamic_prayer-1.0.0.tar.gz
Algorithm Hash digest
SHA256 d2cabe0e3ba3bfd0f86973f10daf98053f078894c392ffbfec69ad174c4d3dd4
MD5 6835d417b5cf7a2ca16647d98c7bb353
BLAKE2b-256 eea452142c78faa5d3f2fb5c67b4fb26a7624c6c472e6af0b821c3dedbad0729

See more details on using hashes here.

File details

Details for the file pyislamic_prayer-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for pyislamic_prayer-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d94681a77818c43b2d4f6062d4c01dd0a0d67af373d3acb73d50853b1aef05de
MD5 9c768c683c8b567677d092ed130aa77c
BLAKE2b-256 7f575b0efa586174f8d4486531d7bf65e09a062cc8a1e442b53c762d2a090a15

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page