GENQURAN

GENQURAN

An Android application for reading the Quran with random verses, a Qibla compass, AI Quran recitation, voice recording, and the Quran.com browser.

Package: com.miftahkun.genquran
Minimum SDK: 21 (Android 5.0)
Target SDK / Compile SDK: 36
Key Features
1. Random Verses from quran.db

The quran.db database is in the assets/ folder with two tables:

table_ayat(Surah, Verse, Arabic, Translation) — 6236 verses

table_surah(Surah, Verse, Translation, Number_of_Verses) — 114 suras
Filter:
Per specific surah: spinner lists 114 suras
Per theme: spinner lists 11 themes (Teachings, Commands, Prohibitions, Stories, Prayers, Heaven & Hell, Morals, Faith, Knowledge, Patience & Gratitude)
Fallback loader: If quran.db is invalid, automatically uses sample data from strings.xml (sample_verses).

2. Minimalist Interface

MaterialCardView for verses with Arabic + Latin + translation
Buttons: Shuffle, Read (TTS), Save, Copy, Share
List of saved verses synchronized via SavedVerseRepository (SharedPreferences + Gson)
Bright mode (DayNight) with green-gold palette (gq_primary / gq_secondary)

3. Qibla Compass

Sensor: TYPE_ROTATION_VECTOR (smoothed with CompassSmoother)
Location: NETWORK + GPS provider
Calculation of the great circle to the Kaaba (21.4225°N, 39.8262°E)
Visual: Custom CompassView — red needle (north), green arrow (qibla), tick marks, N/S/W/T labels
Calibration: Smoother reset button + number-8 instructions

4. AI Quran Reading Method

Endpoint: https://gpt.1forum.my.id/v1 (compatible with OpenAI Chat Completions)
The AIClient performs a POST with the payload {model, messages[], temperature}.
Prompt system: expert tahsin & tajwid assistant, Indonesian language, Markdown output.
The resulting instruction can be read aloud with Google TTS (literal fast reading).
Service AIReadingService (binder) — MainActivity binds to prevent blocking the UI.

5. TTS (Google Voice)

TtsManager wraps TextToSpeech
Default language: en-ID, fallback to en-US
Controls: speed (50%–200%), pitch (50%–200%), engine selection
Settings are stored in GenQuranApplication.prefs

6. Voice Recording + Playback

RecordingManager records to /sdcard/Download/GENQURAN/Recordings/GENQURAN_yyyyMMdd_HHmmss.m4a
Format: MPEG_4 / AAC / 128 kbps / 44.1 kHz
Pause/Resume on API 24+
Playback: MediaPlayer with progress callback
Recordings list: .m4a / .mp4 / .3gpp files in the recordings folder
Actions: Play, Stop, Share (FileProvider), Delete

7. Quran.com Browser

QuranBrowserActivity opens https://quran.com/id/
WebView with JavaScript + DOM Storage + zoom
Navigation features:
Undo / Redo: webView.goBack() / webView.goForward()
Refresh: webView.reload()
Download Page: DownloadHelper.downloadHtml() → /sdcard/Download/GENQURAN/Pages/