Table of Contents
قال تعالى: {وَمَا خَلَقْتُ ٱلْجِنَّ وَٱلْإِنسَ إِلَّا لِيَعْبُدُونِ (٥٦) مَآ أُرِيدُ مِنْهُم مِّن رِّزْقٍۢ وَمَآ أُرِيدُ أَن يُطْعِمُونِ (٥٧) إِنَّ ٱللَّهَ هُوَ ٱلرَّزَّاقُ ذُو ٱلْقُوَّةِ ٱلْمَتِينُ (٥٨)} [الذاريات]
Athany is a lightweight python program for windows and linux that calculates the times for the five mandatory muslim prayers, tells you the time remaining until the next prayer, and plays the athan sound when the prayer time comes.
Install the latest stable version using the windows setup provided in the release, If you want the latest code version up and running follow these simple steps.
-
Python >= 3.9
-
Fonts used in application.
-
python-tkTkinter package (Linux users only) -
libappindicator-gtk3& appindicator shell extension if you're using Gnome (Linux users only)
-
Install dependencies (Linux users only)
sudo apt-get install -y python3-tk python3-dev libappindicator3-1 libappindicator3-dev
-
Clone the repo
git clone https://github.com/0xzer0x/athany.git
-
Install python packages
cd athany pip install -r requirements.txt -
Run the application
python main.py
Replace the single-quotes with double-quotes if you're using windows and : with ;
- After the installation steps, execute the following commands. You will find the built application folder in the dist directory
pip install pyinstaller
pyinstaller --noconfirm --onedir --windowed --icon 'images/athany_icon.ico' --add-data 'src/Data:src/Data' --name 'athany' main.py
On first launch, the choose-location window will prompt you for a valid location. you can either type your location manually or use the automatically fetched location (note: your location is fetched using your public IP, so it may not be totally accurate)
the settings window can be accessed through the bottom left button
the general settings tab has the main app settings (mute athan, saving location, theme, change language, change/download athan sound)
the custom athan tab allows you to choose a local audio file (.wav, .mp3) to play instead of the offered athans
the offset tab allows you to adjust prayer times by adding/subtracting minutes from the default calculated time
the advanced settings tab allows you to use a different calculation method or set the calculation parameters manually. It also shows you the default method used in your country
- Add advanced settings tab
- change calculation method
- use custom fajr & isha angles
- Add translations
- make an Android version using
kivylibrary
See the open issues for a full list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
Distributed under the MIT License. See LICENSE.txt for more information.
Fursan team - y.essam2256@nu.edu.eg
Project Link: https://github.com/0xzer0x/athany