Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/DBChoco/Muezzin
A prayer times (Adhan) and Quran app for Windows, macOS and GNU/Linux.
https://github.com/DBChoco/Muezzin
adhan app application athan azan electron islam islamic islamic-prayer-times linux macos muslim muslim-prayer-times quran quran-audio quran-online salat salawat software windows
Last synced: 23 days ago
JSON representation
A prayer times (Adhan) and Quran app for Windows, macOS and GNU/Linux.
- Host: GitHub
- URL: https://github.com/DBChoco/Muezzin
- Owner: DBChoco
- License: mit
- Created: 2022-02-14T21:47:07.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-02-18T20:22:32.000Z (4 months ago)
- Last Synced: 2024-02-25T01:32:32.362Z (4 months ago)
- Topics: adhan, app, application, athan, azan, electron, islam, islamic, islamic-prayer-times, linux, macos, muslim, muslim-prayer-times, quran, quran-audio, quran-online, salat, salawat, software, windows
- Language: JavaScript
- Homepage:
- Size: 44.5 MB
- Stars: 102
- Watchers: 4
- Forks: 16
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Lists
- awesome-Islam - Muezzin
- Awesome-Muslims - Muezzin
README
# Muezzin
Muezzin - مؤذن
A prayer times and Adhan application for Windows, macOS and GNU/Linux
Download »
View Demo
·
Report Bug
·
Request Feature
## Table of Contents
## About The Project
We may all be familiar with Muslim Pro on our smartphones, but as someone who doesn't use my phone much, I wanted an app to help me keep track of prayer times without having to go on my smartphone, I wanted an app that was highly customizable and would let me choose my own Adhan and theme. And Alhamdoulillah after a few weeks of hard work, I did just that.
On Muezzin you can choose to play an Adhan or not, you can import your own audio file; you can also chose to have a background or not, and import your own.
Currently we support 10 languages (and growing), and if you want us to add one more, you can submit a report here
The app also contains a Qur'an reader that is able to show translations and transliterations. It supports many languages and you can expect many improvements in the future inshaAllah.
### Supported Languages
* English
* Français
* Español
* Italiano
* Arabic
* Deutsch
* Nederlands
* Norks
* Svenska
* Dansk
* Urdu
* Turkish (thanks @emrergin)
* Bengali (thanks @iFarhaan)
### Built With
* [Electron](https://www.electronjs.org/)
* [Bootstrap](https://getbootstrap.com)
* [Bootstrap-dark-5](https://vinorodrigues.github.io/bootstrap-dark-5/)
* [adhan-js](https://github.com/batoulapps/adhan-js)
* [FontAwesome](https://fontawesome.com/)
* [Quran.com API](https://quran.api-docs.io) & [Quran-JSON](https://github.com/risan/quran-json)
* [OpenWeather](https://openweathermap.org/)
* [Weather Icons](https://github.com/erikflowers/weather-icons)
* A few other electron modules
### Roadmap
- [x] Native app port [done, still needs updates](https://github.com/DBChoco/Salawat)
- [x] Add Qur'an reading page
- [x] Improve the Qur'an page
- [ ] Add mosque mode (improved visibility from afar & delays to prayers) [delayed](https://github.com/DBChoco/Muezzin-Mim)
- [ ] Mosque interface with delays
- [ ] Manual times
- [ ] Custom text
- [x] Add Tasbih (Left-Click (or space) on top-left "Muezzin" to add 1, right click (or escape) to reset)
- [ ] Add Sunnah (API key request sent)
- [ ] Multi-language Support
- [ ] Russian
- [ ] Indonesian
- [ ] NEED TRANSLATORS !
See the [open issues](https://github.com/DBChoco/MuezzinPrayerTimes/issues) for a full list of proposed features (and known issues).
## How to install
### Windows
From the download page, select the .EXE installer.
Download it and install it.
You might receive a warning, that is because the app is not signed and I do not have the money to do so. The app is completely safe, you can read through the source code or have a trusted friend do it for you, all the code is Open-Source.
### macOS
From the download page, select the .DMG installer.
Download it and install it. Some versions might not have .DMG versions, you should then go look at an earlier version.
Same problem as the Windows installer
> You might receive a warning, that is because the app is not signed and I do not have the money to do so. The app is completely safe, you can read through the source code or have a trusted friend do it for you, all the code is Open-Source.
### GNU/Linux
### Global
#### Arch based distributions
You can either:
-
Download the .PACMAN file and install it through your favorite package manager - Install it thorugh the AUR package muezzin-bin with
`yay -S muezzin-bin`
#### Debian based distributions
You can download the Download the .DEB file and install it through your favorite package manager
`sudo apt install path/to/file.deb`
#### Others
For other distributions, on the download page you can choose from:
- The .APPIMAGE file, which you can run on any Linux distribution and add to your autorun script
- The .TAR.GZ file, which you can unarchive wherever you want and launch via the terminal
## Contributing
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".
If you noticed a translation error or want to add a language yourself, feel free to contact me!
**Don't forget to give the project a star! Thanks again!**
***Jazzaka Lahu khairan!***
## License
Distributed under the MIT License. See `LICENSE.txt` for more information.
## Contact
[Project Link](https://github.com/DBChoco/Muezzin)
[Official Discord server](https://discord.gg/cpF9TTstN5)
Email: [email protected]
## Acknowledgments
* [Source of Mecca Adhan](https://www.youtube.com/watch?v=MaEzj5eRmjc&t)
* [Source of al-Aqsa Adhan](https://www.youtube.com/watch?v=z2xEwSi2vaI)
* [Source of Bismillah startup sound](https://www.youtube.com/c/FatihSeferagic/featured)
* [Inspiration for logo](https://www.youtube.com/watch?v=oM5hNuAmWs0)
* [Template for the README page](https://github.com/othneildrew/Best-README-Template)
* [Source of Arabic fonts](https://github.com/fawazahmed0/quran-api)
* Thanks to a few of my friends for helping me translate Muezzin and build it for macOS
### Source of images
* [Light mode background image](https://unsplash.com/photos/njEXjDmYn8w)
* [Dark mode background image](https://unsplash.com/photos/TAfqq1B3-2s)