rezaali7 / quranhub-android

Native Android app for QuranHub

QuranHub for Android

QuranHub is an open-source project that aims to be the single destination to read & study the Quran.

The QuranHub Android mobile app provides the following features:

• The Quran in both Hafs & Warsh recitations.
• Quran audio by various reciters.
• Customizable audio repeat.
• Quran tafsir (explanation) & translation in various languages.
• Ability to highlight verses (ayas) to show more options like playing their audio or showing their tafsir.
• Verse bookmarking, and sharing.
• Ability to add text & audio notes to verses.
• Advanced search in the Quran.
• Quran reader (mus'haf) night mode for easier reading in the Quran.
• Islamic library with various books to download as PDF files and view inside the app.
• Quran topics with their verses in the Quran.

Download the app from the Google Play Store:

What's New

See the project's releases page for a list of versions with their changelogs.

View Releases

If you Watch this repository, GitHub will send you an email every time we publish an update.

Contributing

When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before making a change.

Please read CONTRIBUTING.md for our code of conduct and details on contributing to the project.

Also, refer to the repository's project boards where we organize and prioritize the work.

Steps for contributing to this repository:

1. Fork it.
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git add . git commit -m 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Create new Pull Request.

Code Style Guidelines

We follow the code style guidelines outlined in Ribot's Project & Code Guidelines.

Versioning

We use SemVer for versioning.

Documentation & Wiki

Info and documentation are available in this repository's GitHub Wiki. If you have any questions feel free to open a new issue on this repository.

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Acknowledgments

• Mohamed Halim ElGendy: Project analysis. Initial planning & project management.
• Nada Mahany: Android app testing.
• Mostafa Hussien: Android development.
• Abdallah Abdelazim: Project open-source maintainer & lead developer. Mobile & web (backend/frontend) development.
• Abdelrahman Elhellawy: Backend development.