AzanPi

Heyo 👋 Azan is an open source project that helps in scheduling Azan prayers based on the city you are in. The app is built by calling this API adhan library which supports multiple methods (e.g., ISNA)

Excited to run the app? 🚀

The app has the following dependecies:

Python 3 (required) (sorry but Python 2.7 is not supported here anymore!) 😝
Virtual environment (preferred but not required)

Install dependencies:

pip install -r requirements.txt

Configure the app:

To configure the app, navigate to config.py and set the city, state, and other configurations, example:

default = {
    "city": "San Francisco",
    "state": "CA",
    "country": "United States",
    "method": "ISNA",
    "lat": 37.778160,
    "long": -122.412560, 
    "pioled": False,
}

Run app:

> python scheduler.py

Example for the output:

Schedule Dhuhr at 2019-04-07 13:12:25.716128
Schedule Asr at 2019-04-07 16:49:25.716324
Schedule Maghrib at 2019-04-07 19:38:25.716398
Schedule Isha at 2019-04-07 20:53:25.716456

Run the app on boot:

It is important to run the app when the Pi restarts, to do so, you can add the following line to your rc.local file:

> sudo nano /etc/rc.local
python3 <path-to-azan-folder>/azan/scheduler.py

Integrate PiOLED to display Azan schedule on LED screen (Raspberry Pi only)

You wann something cool! 😎.. try to integrate PiOLED into your pi and you can see the Azan schedule displayed on your little small LED display. you will need the following:

PiOLED you can buy it from Amazon or Adafruit directly
Follow this link to install the required libraries: https://www.adafruit.com/product/3527
Don't forget to enable PiOLED from the config file

NOTE:

You are free to use or redistribute the app, but please credit this project when you do so 😊.

License

GPL3 -- it seems good to me 😁

mohanadkaleia/azan