Skip to content

superyass/quran_android

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

quran for android

this is a simple (madani based) quran app for android.

patches, comments, etc are welcome.

contributors:

graphics by Somaia Gabr.

Arabic support for non-Arabic phones by Rehab Mohamed, based on Arabic Reshaper project by Ahmed Essam.

Code Style

  • tab size: 2
  • indent : 2
  • continuous indent: 4

you can set these under code style and code style java in android studio or intellij.

Setup

  1. get and install the android sdk
  2. make sure $ANDROID_HOME is set to the correct place.
  3. build from the command line by running ./gradlew assembleDebug
  4. if you want an ide, download the latest version of android studio (latest as of this writing is version 0.5.8)
  5. run android studio, choose import project, then choose build.gradle from the main quran source code directory.

and that's it!

App localization

  • Farsi for version 2.0 by M. Jafar Nakar
  • Farsi for version 1.6 by khajavi.
  • Turkish by Mehmed Mahmudoglu.
  • Russian by Rinat (Ринат Валеев).
  • Kurdish by Goran Gharib Karim.
  • French by Yasser yasserkad.
  • German by Armin Supuk.
  • Chinese by Bo Li
  • Uyghur by Abduqadir Abliz Sahran
  • Indonesian by Saiful Khaliq
  • Malaysian by Ahmad Syazwan

Terms of use

you are free to use parts of the Quran Android code in your application with some conditions:

  • your app must be respectful of the book of Allah. adding advertisements above and below each page of Quran is unacceptable, for example (yes, someone actually did that).

  • your app must provide some significant value over our app - otherwise, why not just contribute a patch instead?

  • your app cannot make money from ads or from sales. there are many reasons for this:

    • we made this app for the benefit of people and not to make a profit
    • the app costs us money (for serving the pages, translations, etc), not to mention the time to develop it and to support it.
    • not all of the data that we use is okay to be sold. the images, along with some of the translations are on a license that allows their use and distribution for free for non-profit uses, but does not allow users to make money from them.
  • if you write an application using any of the Quran data (the images, the translations, etc), you must provide a link to the respective data source page (tanzil.net for the translations and the quran images project for the images) both within your application (in an about page) and in your application description in the market or app store.

  • if you use part of (or all of) the quran android code or graphics, you must provide a link back to the quran android project in your application description and your application itself in an about section.

Open Source Projects Used

Changelog

current

  • major ui improvements for long press actions
  • option to highlight ayah bookmarks by default
  • malaysian translation (thanks @asyazwan)
  • uyghur translation (thanks @Sahran)
  • right to left layout for arabic (thanks @aessam)
  • bugfixes

You can see our complete set of releases [here] (https://github.com/ahmedre/quran_android/releases)

About

a quran reading application for android

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 99.6%
  • PHP 0.4%