An Android app for listening to the Quran: 146 reciters, each surah streamed or kept on the phone, and a page-image mushaf that reads offline once it is downloaded.
It is built around one rule that every play follows: look on the phone first, and use the network only for what isn't there. A downloaded surah plays in airplane mode; a surah that would need the network says so at once instead of hanging.
The mushaf reader, bookmarks and read-along audio are adapted from the open-source Quran for Android project. The reciter list, the phone-first lookup, the network check and the downloads are this app's own code.
Plays the five stages below in order, about 40 seconds. Scroll or press Esc to stop.
com.medoapps.www.onlinequranSwitch the connection, then tap a surah. Four of these six are on the phone Illustrative input
MediaPlayerService.kt:357-361.The reciter list ships inside the app, so building it needs no request. Each reciter carries everything needed to make its surah list on the phone.
LnaguageClass.java:150-480).serverNumber(), :481-1025).managment.java:163). A partial reciter only lists what is in its range.117 reciters have all 114 surahs. The other 29 range from 113 surahs down to a single one.
146 reciters, filled by how many surahs each has
serverNumber() and autherRanageDetermine(), copied verbatim from the published code, over all 146 reciters offline.| Reciter id | Server | Surahs | List |
|---|
Before anything plays, every surah in the list is resolved to one source, checked in a fixed order: a file in Music/MyStream, then a MediaStore entry, and only then a stream URL. The answer is shown on the row as “From phone” or “online”.
AhmedHashim_<reciter><surah>.mp3, so each check is a lookup in a set (LnaguageClass.java:1370-1387).RecitesName.java:189). The code's comments put the old cost at up to 114 disk and system calls per list.:1342).Resolving a reciter's list
Music/MyStream/AhmedHashim_afs001.mp3 …afs018.mp3 …afs036.mp3, and a MediaStore entry for AhmedHashim_afs067.mp3 left from before a reinstallexistingFiles.contains(name)0From phonedownloadedUris.get(name)0From phonehttps://server8.mp3quran.net/…0onlineGuranAya() method, copied verbatim from the published code and run offline against a scratch folder. Which files exist is illustrative, and the MediaStore query is replaced by a fixed map.The whole list becomes the play queue, each row carrying the source it resolved to. Right before ExoPlayer prepares a source, the player checks the connection: a URL with no network stops there, with the toast “Network Error”, and the playback service shuts down.
SongsManager.getPlayList, NewQuranPlayer.kt:359-370).!isNetworkAvailable && data.contains("http") (MediaPlayerService.kt:357). It only stops URLs.content:// URI is prepared without asking (:363-364), which is why a downloaded surah plays in airplane mode.Without the check, a stream with no network would leave the player loading, since a playback error is only logged (:279-281). With it, the answer is immediate and says why.
Three sources at the check
Music/MyStream/AhmedHashim_afs018.mp3content://media/external/audio/media/1042https://server8.mp3quran.net/afs/002.mp3355 val test = SeparateFunctions(applicationContext) 356 Log.d(TAG, "startMediaSeparatly: network=${test.isNetworkAvailable}") 357 if (!test.isNetworkAvailable && activeAudio!!.data.contains("http")) { 358 Toast.makeText(applicationContext, "Network Error", Toast.LENGTH_SHORT).show() 359 destroyService() 360 return 361 } 362 363 if (!activeAudio!!.data.contains("http") || test.isNetworkAvailable) { 364 exoPlayer!!.prepare() // always async in ExoPlayer — no race condition 365 }
ClearedEverything above comes from the phone. Below this line the app goes to the network: mp3quran.net for surah audio, and the mushaf's page hosts.
Past the check, a URL streams through ExoPlayer in a foreground media service. Any surah can also be downloaded, and the next lookup finds it on the phone.
MediaPlayerService.kt:751). It drops to 10% volume while another app plays a short sound, and pauses when headphones are unplugged or, where phone-state access is granted, a call comes in (:283-310, :500-560).AyaList.java:786-795), and “Select all” picks exactly those (:746-761).Music/MyStream, with the same fixed name the lookup checks (DownloadService.java:357-366).AyaList.java:898). The files sit in shared storage, so they outlive a reinstall.Download two surahs, then look again
The mushaf tab shows the printed page as an image. The reader is adapted from the open-source Quran for Android project, and it follows the same shape as the listening side: before opening a print it checks that the pages are on the phone, and asks before downloading them.
OnboardingMushafFragment.java:50-67), and Madinah Colored is the default (OnboardingState.java:34).MadinaColoredPageProvider.kt:29-32). The other seven come from android.quran.com.QuranDataActivity.kt:430-496, from Quran for Android).AudioPresenter.kt:36-42).Eight prints, and the first open of the default
zips/images_1000.zip from geohashim-quran, eu-central-1MadinaColoredPageProvider.kt:51-54).Bookmarks, tags and recently read pages live in a SQLite database on the phone; that module is adapted from Quran for Android, and it keeps the three most recent pages. Two pieces of memory are this app's own: the reader remembers the last repeat drill across restarts, and the listening player saves its queue and which surah it was on.
Recent pages, three slots
addLastPage {
REPLACE INTO last_pages(page) VALUES(?);
DELETE FROM last_pages WHERE _ID NOT IN(
SELECT last_pages._ID FROM last_pages ORDER BY added_date DESC LIMIT ?
);
}
LastPage.sq run in SQLite, with the two edits plain SQLite needs: the SQLDelight type adapter removed, and the limit bound to 3 (Constants.MAX_RECENT_PAGES). The pages visited are illustrative.Start and end ayah, verse repeats, range repeats and whether to stop at the end are saved the moment playback starts, so they survive the app being closed (QuranSettings.java:97-112). Reopening the panel inside that range restores them.
The surah list and the index of the current surah are kept in the app's preferences, and the playback service reads them from there each time it starts (StorageUtil.java:69, :107; MediaPlayerService.kt:157-159). The position inside a surah is held in memory only.
A bookmark is a page, or a surah and ayah; tags group them. Import, export and CSV export come with the Quran for Android module.
Install it from Google Play, open the Quran tab and pick a reciter. Download a surah or two, then turn on airplane mode: the downloads still play, with the player showing “Offline”, and the rest stop with “Network Error”.