{"id":13612300,"url":"https://github.com/quran/quran_android","last_synced_at":"2025-05-13T23:09:01.713Z","repository":{"id":787554,"uuid":"483644","full_name":"quran/quran_android","owner":"quran","description":"a quran reading application for android","archived":false,"fork":false,"pushed_at":"2025-05-10T13:36:44.000Z","size":16739,"stargazers_count":2150,"open_issues_count":344,"forks_count":910,"subscribers_count":113,"default_branch":"main","last_synced_at":"2025-05-10T14:36:51.641Z","etag":null,"topics":["android","quran"],"latest_commit_sha":null,"homepage":"http://android.quran.com","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/quran.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2010-01-22T10:34:05.000Z","updated_at":"2025-05-10T13:36:46.000Z","dependencies_parsed_at":"2023-02-12T13:17:34.386Z","dependency_job_id":"f6b372bb-adf4-4ff2-9e0b-e11df7946c60","html_url":"https://github.com/quran/quran_android","commit_stats":{"total_commits":2875,"total_committers":83,"mean_commits":34.63855421686747,"dds":"0.38017391304347825","last_synced_commit":"c449860b6ae17278023bce2ffbfb0b71a79771cb"},"previous_names":[],"tags_count":170,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quran%2Fquran_android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quran%2Fquran_android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quran%2Fquran_android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quran%2Fquran_android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/quran","download_url":"https://codeload.github.com/quran/quran_android/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254041945,"owners_count":22004809,"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":["android","quran"],"created_at":"2024-08-01T20:00:26.990Z","updated_at":"2025-05-13T23:08:56.664Z","avatar_url":"https://github.com/quran.png","language":"Kotlin","funding_links":[],"categories":["Mobile Apps","Open Source Projects","Quranic Text and Reading (386 projects)"],"sub_categories":["Kotlin","Mobile Apps"],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"https://raw.githubusercontent.com/quran/quran_android/main/app/src/madani/res/drawable-xxhdpi/icon.png\" alt='Quran for Android logo'/\u003e\n\n# Quran for Android\n\n[![Build Status](https://github.com/quran/quran_android/actions/workflows/build.yml/badge.svg)](https://github.com/quran/quran_android/actions/workflows/build.yml)\n[![Version](https://img.shields.io/github/v/release/quran/quran_android?include_prereleases\u0026sort=semver)](https://github.com/quran/quran_android/releases/latest)\n[![Github Downloads](https://img.shields.io/github/downloads/quran/quran_android/total?logo=Github)](https://github.com/quran/quran_android/releases)\n\nThis is a simple (Madani based) Quran app for Android.\n\n[\u003cimg src=\"https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png\"\n      alt='Get it on Google Play'\n      height=\"80\"\u003e](https://play.google.com/store/apps/details?id=com.quran.labs.androidquran)\n[\u003cimg src=\"https://user-images.githubusercontent.com/69304392/148696068-0cfea65d-b18f-4685-82b5-329a330b1c0d.png\"\n      alt='Get it on GitHub'\n      height=\"80\"\u003e](https://github.com/quran/quran_android/releases/latest)\n\n\u003cdiv align=\"left\"\u003e\n\n## Credits\n\n* madani images from [quran images project](https://github.com/quran/quran.com-images) on github.\n* qaloon images used with permission of Nous Memes Editions Et Diffusion (Tunisia).\n* naskh images used with permission of SHL Info Systems.\n* translation, tafsir and Arabic data come from [quranenc](https://quranenc.com) and [King Saud University](https://quran.ksu.edu.sa). a small number of translations also come from [tanzil](http://tanzil.net).\n\n## Contributing\n\nIf you'd like to contribute, please take a look at the [PRs Welcome](https://github.com/quran/quran_android/issues?q=is%3Aissue+is%3Aopen+label%3A%22PRs+Welcome%22) label on the issue tracker. For new features, please open an issue to discuss it before beginning implementation.\n\nUse [`quran_android-code_style.xml`](https://github.com/quran/quran_android/blob/main/quran_android-code_style.xml) for Android Studio / IntelliJ code styles. Import it by copying it to the Android Studio/IntelliJ IDEA codestyles folder. For Android Studio, that folder is located at `~/.AndroidStudio[Version]/config/codestyles` (the root folder name may differ depending on the host machine and Android Studio version, but the rest of the path should be same). After copying the `quran_android-code_style.xml`, go to Code Style preferences screen and choose `quran_android-code_style` from Code Style Schemes.\n\nPlease set your Android studio kotlin code style based on [Kotlin Coding Conventions](https://kotlinlang.org/docs/reference/coding-conventions.html). You can configure it from menu Settings | Editor | Code Style | Kotlin, click on \"Set from…\" link in the upper right corner, and select \"Predefined style / Kotlin style guide\" from the menu.\n\nMay Allah reward all the awesome [Contributors and Translators](https://github.com/quran/quran_android/blob/main/CONTRIBUTORS.md).\n\n\n## Setup\n\n### Command Line\n\nYou can build Quran from the command line by running `./gradlew assembleMadaniDebug`.\n\n### Android Studio / IntelliJ\n\nChoose \"Import Project,\" and choose the `build.gradle` file from the top level directory. Under \"Build Variants\" (a tab on the left side), choose \"madaniDebug.\"\n\n## Using Quran for Android code in other projects\n\nThe intention behind open sourcing Quran for Android is two fold - first, to allow developers to help contribute to the app, thus speeding up the development of new features and ideas. Second, to give back to the community and serve as a code reference.\n\nQuran for Android costs money to run - all the data (pages, audio files, and translations) are hosted on servers that people volunteer their money to pay for every month. Moreover, the data itself is the work of various scholars, organizations, or reciters, many of whom provide this data free for usage for the benefit of the ummah.\n\nTherefore, people planning on taking this project and profiting from it (by way of ads, in app purchases, etc) are in fact stealing from the work of the contributors of this project, and from the people who volunteer to pay for the servers (since they increase the bandwidth costs on them instead of covering them themselves).\n\nPlease keep use of this code for non-profit purposes only. Also, please note that the project is under the GPL 3 license, which requires that modifications to this code be open sourced as well. Please note that the data is licensed under the various licenses of the data's authors (typically, this is [CC BY-NC-ND](https://creativecommons.org/licenses/by-nc-nd/2.0/), but may differ depending on the source of the data).\n\n\n## Open Source Projects Used\n\n* [AndroidX](https://developer.android.com/jetpack/androidx/)\n* [Kotlin](https://kotlinlang.org)\n* [Material Design Components](https://github.com/material-components/material-components-android)\n* [AndroidSlidingUpPanel](https://github.com/umano/AndroidSlidingUpPanel)\n* [OkHttp](https://github.com/square/okhttp)\n* [RxJava 2](https://github.com/ReactiveX/RxJava)\n* [RxAndroid](https://github.com/ReactiveX/RxAndroid)\n* [Moshi](https://github.com/square/moshi)\n* [Dagger2](https://google.github.io/dagger/)\n* [Timber](https://github.com/JakeWharton/timber)\n* [dnsjava](http://dnsjava.org)\n* [NumberPicker](https://github.com/ShawnLin013/NumberPicker)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquran%2Fquran_android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquran%2Fquran_android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquran%2Fquran_android/lists"}