Skip to main content

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

Release files for pyislamic-prayer 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyislamic-prayer 1.0.1
File Size Uploaded
pyislamic_prayer-1.0.1.tar.gz 5.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pyislamic-prayer 1.0.1
File Interpreter ABI Platform
pyislamic_prayer-1.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 12.3 kB

Release files / pyislamic_prayer-1.0.1.tar.gz

Download URL pyislamic_prayer-1.0.1.tar.gz
Size 5.7 kB
Tags Source
SHA-256 checksum
How to use checksums
ec4f6c58972f9026539808f0972c7c188feb7e18b85bf2cd69e5703b23713099
BLAKE2b-256 checksum
How to use checksums
6287a5a6ede32e67a5b7588e1fd090b927e6072fee856337858a4116ad2fd2e9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Release files / pyislamic_prayer-1.0.1-py3-none-any.whl

Download URL pyislamic_prayer-1.0.1-py3-none-any.whl
Size 6.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fe49ec701ee24b79599433b5d30e05479d9b3e17d593530afd2dbc6a29b75ef4
BLAKE2b-256 checksum
How to use checksums
d1b46500a7460eebfef2905afe554461f836cb9830107d526c7a995ca07490c7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page