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.1.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.1-py3-none-any.whl (6.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pyislamic_prayer-1.0.1.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.1.tar.gz
Algorithm Hash digest
SHA256 ec4f6c58972f9026539808f0972c7c188feb7e18b85bf2cd69e5703b23713099
MD5 fb12d7156e39f3391438d64ba63c9e9f
BLAKE2b-256 6287a5a6ede32e67a5b7588e1fd090b927e6072fee856337858a4116ad2fd2e9

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyislamic_prayer-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 fe49ec701ee24b79599433b5d30e05479d9b3e17d593530afd2dbc6a29b75ef4
MD5 4cd49fbfba0f87a05f6fdec03c95a78f
BLAKE2b-256 d1b46500a7460eebfef2905afe554461f836cb9830107d526c7a995ca07490c7

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