{"id":13812462,"url":"https://github.com/0xzer0x/athany","last_synced_at":"2025-10-29T19:30:25.244Z","repository":{"id":64338551,"uuid":"567624876","full_name":"0xzer0x/athany","owner":"0xzer0x","description":"A lightweight python prayer times/athan application for windows and linux that operates offline","archived":false,"fork":false,"pushed_at":"2023-06-04T20:17:22.000Z","size":55375,"stargazers_count":21,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-02T04:24:18.995Z","etag":null,"topics":["adhan","aladhan","athan","azan","islam","muslim","muslim-prayer-times","prayer","prayer-times","prayertimes","pysimplegui","python","python-ui"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0xzer0x.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-11-18T07:39:34.000Z","updated_at":"2025-01-02T14:42:39.000Z","dependencies_parsed_at":"2023-02-19T02:15:45.336Z","dependency_job_id":null,"html_url":"https://github.com/0xzer0x/athany","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xzer0x%2Fathany","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xzer0x%2Fathany/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xzer0x%2Fathany/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xzer0x%2Fathany/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xzer0x","download_url":"https://codeload.github.com/0xzer0x/athany/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238874405,"owners_count":19545184,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adhan","aladhan","athan","azan","islam","muslim","muslim-prayer-times","prayer","prayer-times","prayertimes","pysimplegui","python","python-ui"],"created_at":"2024-08-04T04:00:52.179Z","updated_at":"2025-10-29T19:30:22.408Z","avatar_url":"https://github.com/0xzer0x.png","language":"Python","funding_links":[],"categories":["Desktop Apps","Other (122 projects)"],"sub_categories":["Python"],"readme":"\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/0xzer0x/athany\"\u003e\n    \u003cimg src=\"images/athany_icon.ico\" alt=\"Logo\" width=\"80\" height=\"80\"\u003e\n  \u003c/a\u003e\n\n\u003ch3 align=\"center\"\u003eAthany\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    a python application to remind you of your purpose\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/0xzer0x/athany/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/0xzer0x/athany\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://www.codefactor.io/repository/github/0xzer0x/athany/overview/master\"\u003e\u003cimg src=\"https://www.codefactor.io/repository/github/0xzer0x/athany/badge/master\" alt=\"CodeFactor\" /\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/0xzer0x/athany#usage\"\u003eView Demo\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/0xzer0x/athany/issues\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/0xzer0x/athany/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003cdetails\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\n      \u003ca href=\"#about-the-project\"\u003eAbout The Project\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#built-with\"\u003eBuilt With\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#prerequisites\"\u003ePrerequisites\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#build-from-source\"\u003eBuilding from source\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#roadmap\"\u003eRoadmap\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contact\"\u003eContact\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#acknowledgments\"\u003eAcknowledgments\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n\n## About The Project\n\n[![Athany Screen Shot][banner]][latest-release]\n\n### قال تعالى: {وَمَا خَلَقْتُ ٱلْجِنَّ وَٱلْإِنسَ إِلَّا لِيَعْبُدُونِ (٥٦) مَآ أُرِيدُ مِنْهُم مِّن رِّزْقٍۢ وَمَآ أُرِيدُ أَن يُطْعِمُونِ (٥٧) إِنَّ ٱللَّهَ هُوَ ٱلرَّزَّاقُ ذُو ٱلْقُوَّةِ ٱلْمَتِينُ (٥٨)} \\[الذاريات]\n\nAthany 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.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n### Built With\n\n- [![python][python]][python-url]\n- [![pysimplegui][psg]][psg-url]\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- GETTING STARTED --\u003e\n\n## Getting Started\n\nInstall the [latest stable version][latest-release] using the windows setup provided in the release, If you want the latest code version up and running follow these simple steps.\n\n### Prerequisites\n\n- Python \u003e= 3.9\n\n- [Fonts][fonts-download-url] used in application.\n\n- `python-tk` Tkinter package (Linux users only)\n\n- `libappindicator-gtk3` \u0026 [appindicator shell extension][gnome-appindicator-ext] if you're using Gnome (Linux users only)\n\n### Installation\n\n1. Install dependencies (Linux users only)\n\n   ```sh\n   sudo apt-get install -y python3-tk python3-dev libappindicator3-1 libappindicator3-dev\n   ```\n\n2. Clone the repo\n\n   ```sh\n   git clone https://github.com/0xzer0x/athany.git\n   ```\n\n3. Install python packages\n\n   ```sh\n   cd athany\n   pip install -r requirements.txt\n   ```\n\n4. Run the application\n   ```sh\n   python main.py\n   ```\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003ca name=\"build-from-source\"\u003e\u003c/a\u003e\n\n### Building from source\n\n**Replace the single-quotes with double-quotes if you're using windows and : with ;**\n\n- After the installation steps, execute the following commands. You will find the built application folder in the _dist_ directory\n\n```sh\n    pip install pyinstaller\n    pyinstaller --noconfirm --onedir --windowed --icon 'images/athany_icon.ico' --add-data 'src/Data:src/Data' --name 'athany' main.py\n```\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\u003c!-- USAGE EXAMPLES --\u003e\n\n## Usage\n\n![choose-location][choose-location]\n\nOn 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)\n\n![main-window][main-window]\n\nthe settings window can be accessed through the bottom left button\n\n![settings-window-general-tab][settings-window-general-tab]\n\nthe general settings tab has the main app settings (mute athan, saving location, theme, change language, change/download athan sound)\n\n![settings-window-custom-athan-tab][settings-window-custom-athan-tab]\n\nthe custom athan tab allows you to choose a local audio file (.wav, .mp3) to play instead of the offered athans\n\n![settings-window-offset-tab][settings-window-offset-tab]\n\nthe offset tab allows you to adjust prayer times by adding/subtracting minutes from the default calculated time\n\n![advanced-settings-tab][advanced-settings-tab]\n\nthe 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\n\n[check out other screenshots](https://github.com/0xzer0x/athany/tree/master/images)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- ROADMAP --\u003e\n\n## Roadmap\n\n- [x] Add advanced settings tab\n  - [x] change calculation method\n  - [x] use custom fajr \u0026 isha angles\n- [ ] Add translations\n- [ ] make an Android version using `kivy` library\n\nSee the [open issues](https://github.com/0xzer0x/athany/issues) for a full list of proposed features (and known issues).\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- CONTRIBUTING --\u003e\n\n## Contributing\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\nIf 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\".\nDon't forget to give the project a star! Thanks again!\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- LICENSE --\u003e\n\n## License\n\nDistributed under the MIT License. See `LICENSE.txt` for more information.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- CONTACT --\u003e\n\n## Contact\n\nFursan team - y.essam2256@nu.edu.eg\n\nProject Link: [https://github.com/0xzer0x/athany](https://github.com/0xzer0x/athany)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- ACKNOWLEDGMENTS --\u003e\n\n## Acknowledgments\n\n- [AlAdhan API](https://aladhan.com/prayer-times-api)\n- [adhanpy library](https://github.com/alphahm/adhanpy)\n- [hijri-converter library](https://hijri-converter.readthedocs.io/en/stable/index.html)\n- [Muezzin](https://github.com/DBChoco/Muezzin)\n- [Athan audios source](https://www.assabile.com/adhan-call-prayer)\n- [This README template](https://github.com/othneildrew/Best-README-Template)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\n[latest-release]: https://github.com/0xzer0x/athany/releases/latest\n[python]: https://img.shields.io/badge/Python-yellowgreen?style=for-the-badge\u0026logo=Python\u0026logoColor=white\n[psg]: https://img.shields.io/badge/PySimpleGUI-blue?style=for-the-badge\u0026logo=Python\u0026logoColor=white\n[python-url]: https://python.org\n[psg-url]: https://pysimplegui.org\n[banner]: images/banner.jpg\n[choose-location]: images/choose-location-121-en.png\n[main-window]: images/main-window-121-en.png\n[settings-window-general-tab]: images/general-settings-121-en.png\n[settings-window-custom-athan-tab]: images/custom-athan-121-en.png\n[settings-window-offset-tab]: images/offset-tab-121-en.png\n[advanced-settings-tab]: images/advanced-settings-121-en.png\n[gnome-appindicator-ext]: https://extensions.gnome.org/extension/615/appindicator-support/\n[fonts-download-url]: https://github.com/0xzer0x/athany/releases/download/1.0.0-stable/fonts.zip\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xzer0x%2Fathany","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xzer0x%2Fathany","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xzer0x%2Fathany/lists"}