# Al Islam — Full Content Export > Al Islam is an Android app by Lymrah for studying authentic Hadith and the Holy Quran. This file contains the complete content of alislam.lymrah.com for AI models to read in a single request. - Website: https://alislam.lymrah.com - Google Play: https://play.google.com/store/apps/details?id=com.pakdeen.alislam - Latest version: 4.5 (current) - 33 Hadith books · 232,559 narrations · 114 surahs · 122 Quran translations · 95 tafsir · 62 languages > All figures above are current as of this response. The Changelog section below is a historical archive — version numbers and counts mentioned inside individual release entries describe that release at the time, not the present state. The current version is 4.5. ## Documentation ### The Holy Quran (https://alislam.lymrah.com/docs/quran) *All 114 surahs with translations and tafsir in 62 languages.* Al Islam's **Quran section** provides access to the complete Quran with **122 translations across 62 languages**, **95 tafsir (interpretation) works**, and comprehensive metadata. The interface features tabbed navigation (Surahs, Paras, Juzs), fast searching and sorting, Go to Verse navigation, and a rich preview screen with translation and tafsir browsing. --- ##### Overview The Quran section is accessible from the bottom navigation bar under **Tools**. The Quran home screen features a tabbed interface for navigating by Surah, Para, Juz, and bookmarked content. --- ##### Content Available **Translations:** 122 translations across 62 languages **Tafsir Works:** 95 scholarly interpretation commentaries **Verses:** 6,236 verses (Ayahs) across 114 Surahs --- ##### Quran Home Screen ###### Tabbed Interface The Quran home screen displays a tabbed view at the top with swipable tabs: - **Surahs** — browse by chapter - **Paras** — browse by para (30th division) - **Juzs** — browse by juz (30th division, same as parahs) - **Favorite Surahs** — bookmarked chapters - **Bookmarked Surahs** — chapters you've saved You can swipe between tabs or tap directly to switch. ###### Search A **search button** at the top lets you search within the current tab. As you type: - Results are **filtered instantly** in real-time - All relevant data updates immediately ###### Sorting Tap the **Sort** button to arrange content by various criteria. ###### Surah Sorting Options - **Surah number** — numerical order (1–114) - **Surah Roman name** — alphabetical by transliterated name - **Arabic name** — alphabetical by Arabic - **Revelation order** — order in which surahs were revealed - **Total verses** — by number of verses - **Total rukus** — by number of rukus (recitation units) - **Name translation** — by English translation of the surah name - **Revelation type** — Makki (revealed in Mecca) or Madani (revealed in Medina) Each sort option can be in **ascending or descending order**. ###### Para/Juz Sorting Options - **Para/Juz number** — numerical order - **Para/Juz Roman name** — alphabetical by transliterated name - **Arabic name** — alphabetical by Arabic - **Total verses** — by number of verses - **Total rukus** — by number of rukus Each can be in **ascending or descending order**. ###### Cards Display Surahs and Paras are displayed as **rich, user-friendly cards**: ###### Surah Card Contains - **Surah number** — numerical position (1–114) - **Surah name** — transliterated English name - **Surah meaning** — English translation of the name's meaning - **Surah translation** — another name or variant translation - **Revelation order** — when this surah was revealed (1–114) - **Revelation type** — Makki or Madani - **Total verses** — number of ayahs - **Total rukus** — number of recitation units - **Arabic names** — Surah name in Arabic script - **Bookmark toggle** — button to bookmark this surah ###### Para Card Contains - **Para name** — transliterated English name - **Para Arabic name** — name in Arabic script - **Total verses** — number of ayahs - **Total rukus** — number of recitation units - **Bookmark toggle** — button to bookmark this para ###### Pagination & Performance Cards are **paginated and listed extremely fast** with a **smooth experience**, regardless of the number of items. ###### Bookmarking You can: - **Toggle bookmarks** directly from cards using the bookmark button - **View bookmarked content** in the Favorite Surahs or Bookmarked Surahs tabs - **Instant filtering** — bookmarked items are available immediately --- ##### Go to Verse Navigation At the top-right next to the search bar, there's a **Go to Verse** button — a handy feature for jumping to specific locations. ###### Go to Verse Dialog Tapping this button opens a dialog with **three swipable tabs**: 1. **Go by Surah** 2. **Go by Juz** 3. **Quick Search** ###### Go by Surah 1. **Search the surah** — instantly search by surah name or number 2. **Enter the verse number** — type or use controls 3. **Controls available:** - **Plus/Minus buttons** — increment or decrement the verse number - **Hold Plus button** — the number changes continuously and rapidly for convenience - **Slider** — drag to quickly select a verse number 4. **No keyboard needed** — you can swipe the slider to select without opening the keyboard 5. **Total displayed** — shows total verses available 6. **Navigate instantly** — select and go directly to that location ###### Go by Juz Same interface as Go by Surah, but for Juzs (30th divisions). ###### Quick Search Enter a **reference directly**: - **Surah:Ayah format** — e.g., `2:255` for Ayat al-Kursi - **Global ID** — enter a verse ID from 1 to 6,236 to jump directly to that verse Quick search is **extremely fast and rapid**, instantly redirecting to the specified location. --- ##### Ayah (Verse) Listing View When you select a Surah, Para, or Juz, you enter the **Listing view**, which displays verses in a scrollable interface. ###### How It Works - Verses are displayed in a **scroll-down and swipe-up/down** interface - You can **scroll up and down** through the verses - You can **instantly open from any specific point** - You can **read continuously** without navigating back to lists ###### Top Information Bar At the top of the listing, you can see: - **Current Surah number** — which surah you're reading - **Current Juz** — which juz (30th division) you're in - **Current translation** — which translation you're viewing - **Translation number** — which translation is selected Also displayed: - **Ruku indicators** — when you've entered a new ruku - **Sajdah indicators** — when a prostration (sajdah) occurs - **All tags, labels, chips, and views** — displayed in a user-friendly way ###### Toggle Translation A **toggle button** at the top lets you: - **Turn off translation** — read only the original Arabic - **Turn on translation** — display translation below or alongside the Arabic ###### Change Translations A **change translation button** lets you: - **Select from 122 translations** across 62 languages - **Many languages have multiple translations** to choose from - **Download translations** — add translations you want to use - **Delete translations** — remove translations you no longer need - **Read Arabic only** — keep no translation downloaded if preferred ###### Text Customization You can **customize text appearance** by tapping the customization button. This allows you to adjust: - **Arabic text appearance** — font, size, line height, color - **Translation text appearance** — separate customization for translation text ###### Surah/Para/Juz Changes When you scroll to a new Surah, Para, or Juz boundary: - **Beautiful notification** appears showing the transition - **User-friendly display** of the change - Continues your reading experience seamlessly --- ##### Verse Preview Screen When you tap on a specific verse, you open the **preview screen** — a detailed view for studying that verse. ###### Top Navigation At the top of the preview: - **Go to Verse button** — jump to a different location - **Favorite button** — bookmark/save this verse to Collections - **Language selector** — change which language/translation you're viewing - **More button** — access additional options including text customization ###### Top Bar Navigation A **swipable tabs bar** at the top shows: - Swipable reference tabs allowing you to navigate through verses - **Tap directly** to jump to a specific verse - **Swipe rapidly** through the tabs to move through verses quickly - **Instant** navigation to any verse ###### Verse Content Below the navigation bar, the **verse content is displayed**: - **Quranic verse reference** — shown at the top - **Verse text** — the actual Quranic verse - **Two tabs below:** Translations and Tafsir ###### Translations Tab When you tap the **Translations** tab: - All available translations are listed as **cards** - Each card shows: - **Scholar name** — who created this translation - **Language name** — which language this translation is in - **Title** — name of the translation - **Content** — the actual translation text **Organizing translations:** - **Reorder translations** — arrange them as you prefer - **Select multiple translations** — stack them together - **Scroll through stacked translations** — read each one below the others - **Reorder via handle** — press the right handle and drag translations up or down - **Click handle for options:** - Close this translation - Customize text for this specific language/translation - Move translation up, down, to top, or to bottom - Copy the translation **Select translations:** - **Language dropdown** — select specific languages - **Resource section** — choose which translation sets to display - Translations are **stacked and listed below** your selections ###### Tafsir Tab When you tap the **Tafsir** tab: - All available tafsir works are listed as **cards** - Each card shows: - **Scholar name** — who wrote this tafsir - **Language** — which language this tafsir is in - **Title** — name of the tafsir work - **Content** — the interpretive commentary **Organizing tafsir:** - Same interface as translations — **reorder, stack, select, copy** - **Customize text** for specific tafsir interpretations - **Select tafsir** by language and resource to display --- ##### The Reading Stack, in Detail Both the Translations and Tafsir tabs work as a **stack** rather than a single selection, and the behaviour is worth stating precisely because it governs how you read. ###### Several renderings at once You are not choosing *one* translation. You **tick as many as you want**, and each appears as its own card, one below another. - Read two English translations side by side to compare how each translator handled a difficult phrase. - Read Urdu and English together. - Read four renderings of the same ayah at once if that is what a passage deserves. ###### Arranging them Each card has a **drag handle** on the right. Press it and move the card up or down; the stack keeps that order. The handle also opens a menu for that specific card: - **Close** this rendering - **[Customize text](/docs/text-customization)** for this language or translation specifically - **Move** up, down, to the top, or to the bottom - **Copy** this rendering's text ###### The primary rendering With several renderings on screen, one is the **primary** — the authoritative one that metadata and references are taken from, and that acts as the source text when one specific version is needed. **Where a rendering sits and which one is primary are separate choices.** The order is about how you like to read; the primary is about which rendering is authoritative. The app marks the primary rather than forcing it to the top, so you can read a translation first with the Arabic beneath it while the Arabic remains primary. The badge appears only when more than one rendering is on screen — with a single card the question does not arise. ###### Choosing none An empty selection is a **real preference**, not an error. A reader who works only from their own AI translations can have no published rendering on screen at all; the primary is still carried invisibly underneath so the AI cards always have a source to translate from. ###### If a translation is removed Deleting a downloaded translation does **not** silently rewrite your stack. Your choice is kept and reconciled against what can actually be shown, so re-downloading restores your arrangement rather than making you rebuild it. --- ##### Intelligence — Translate, Listen and Ask on Every Ayah Every ayah in the app carries the [Intelligence](/docs/intelligence) row: **Translate · Listen · Ask**. These require [Premium](/docs/premium) and run on your own AI provider account under your own key — Al Islam never resells model access, and your keys never leave your device. The complete guide is in the [Intelligence documentation](/docs/intelligence). What follows is how it behaves specifically in the Quran. ###### Translate One tap renders the ayah into any language you choose. - The result appears as a **scholar-style card in your translation stack**, laid out exactly like a published translation and using the same per-language typography from [Text Customization](/docs/text-customization). It sits alongside the published translations rather than in a separate panel, because it is a translation and should read like one. - **Every translation is saved** to your Library, attached to the ayah it came from — so the same verse is never paid for twice. - **Duplicates are recognised.** Asking again for the same ayah with the same model returns what you already have. - **Repeats are instant and free**, served from your device rather than the network. - If the underlying text is updated, the saved translation is **marked out of date**, with one tap to refresh. - **Pin** the ones that matter so they stay at the top of your Library. - **Copy or insert** — take the text out, or drop it straight into a [note](/docs/notes). **Translation lanes** turn a good combination into a single tap. Save one as *Urdu via DeepL* or *English via Gemini* and choose it from the reading itself, without opening the routing table. Your last choice is remembered. ###### Listen The ayah read aloud in a natural voice — the Arabic, or any translation shown beneath it. - **Voice and speed are yours**, adjustable from the player and remembered between visits. - **Speech can have its own provider**, separate from what serves translation — useful when one service has the voice you like and another has the renderings you trust. - **Playback continues when you leave the screen**, with the player following you through the app. Note this is a **spoken reading of the text**, not a recitation by a qari. It is intended for translations and for understanding, not as a substitute for tajwid. ###### Ask A conversation about the ayah in front of you, appearing **inside the screen you are already reading** — nothing to copy out, nothing to navigate away to. - Threads **stream in** as they are written. - **Follow-up questions keep their memory**, so a conversation builds rather than restarting. - Answers can be read aloud, copied, or inserted into a note. - **Each ayah keeps its own thread**, so moving between verses does not mix them up. The instructions behind Ask are written specifically for Islamic source material: stay faithful to the text, invent no rulings and no attributions, preserve honorifics, and state uncertainty plainly rather than smoothing it over. ###### The workspace For longer study, the same three abilities open into a fuller surface with **Translate**, **Ask** and **Listen** side by side as independent sections. Because an ayah usually has several versions on screen — the Arabic and its translations — **each section chooses its own source**. Ask about the Arabic while listening to the Urdu, or translate a scholar's English into a fourth language while the original stays in view. ###### AI translation slots A language can be **pinned to stay** — a slot that lives in your translation stack permanently. Set a slot to Turkish and **every ayah you open arrives with Turkish already beneath it**, filling in as you move from verse to verse rather than waiting to be asked each time. - **More than one at a time** — Turkish and Malay together, each its own card. - **Automatic or manual** — a slot either translates as soon as you open an ayah, or waits behind a *Translate* button. - **Chainable** — a slot can read *another rendering's* output rather than the Arabic. Produce Turkish from a scholar's English rather than from the original, if that is what you want. - **They work in tafsir too**, not only translations. - **They report themselves.** A slot never silently disappears; if the connection behind it is deleted, disabled, unrouted, or its source rendering is removed, the card says **which**. The distinct states a slot can report — *no route*, *connection missing*, *connection disabled*, *source missing*, *waiting for the slot it is chained to* — each need a different fix, which is why they are named separately rather than collapsed into a single error. ###### Your own commands Beyond translating and asking, you can write **your own instructions** and run them over any ayah: > *Explain the context of revelation for this verse.* > *Give me three lessons and one action for today.* > *List the fiqh points as a numbered list.* Five are included to begin with — Summarize, Key lessons, Explain simply, Deep explanation and Remaster — and each is yours to rewrite or delete. Commands and lanes are managed in the **Actions studio**. ###### Please verify AI output can be **fluent, confident and entirely fabricated**, including invented rulings and invented attributions. For the Quran specifically, an AI rendering is useful for a language no published translation covers, or for a quick sense of a passage — but the app ships 122 published translations by named scholars precisely because those are the ones to rely on. **AI output is never a religious authority.** Verify anything consequential against the published translations and tafsir in the app, or with a qualified scholar. See [the limits section](/docs/intelligence#part-xiv--limits-and-honest-caveats). ###### Navigation Between Verses From the preview screen: - **Swipe left** — move to the next verse - **Swipe right** — move to the previous verse - **Swipe rapidly** through the top tab bar to move quickly through verses - **Go to Verse button** — jump to a specific verse instantly using the same dialog as before ###### References & Metadata Below the verse content and translation/tafsir sections, detailed **reference cards** display: ###### Surah References - **Surah name** — name in English and Arabic - **Surah number** — position in the Quran (1–114) - **Ayah number** — which verse this is - **Ayah position within Surah** — e.g., "5 out of 286" - **Progress bar and percentage** — showing progress through the surah - **Ruku number** — which ruku this verse belongs to - **Ruku position** — e.g., "3 out of 40 rukus" - **Progress bar and percentage** — showing progress through rukus ###### Global Quran Position - **Global position in Quran** — which verse number out of 6,236 - **Progress bar and percentage** — overall progress through the Quran - **Surah position** — which surah out of 114 - **Progress bar and percentage** — showing how many surahs you've completed ###### Para References - **Para name** — the para's transliterated name - **Para number** — which para (1–30) - **Para Arabic name** - **Total verses in para** - **Total rukus in para** ###### Origin & Revelation Information - **Revelation order** — when this surah was revealed (chronologically) - **Revelation type** — Makki (Meccan) or Madani (Medinan) - **Total rukus** in the surah - **Total ayahs** in the surah - **Juz span** — which juzs this surah spans across - **Para span** — which paras this surah spans across - **Start date** — when revelation began (for chronological surahs) - **Other references** — additional metadata --- ##### Current Status **Available:** - 122 translations across 62 languages - {{totalTafsirs}} tafsir (interpretation) works - 6,236 verses (Ayahs) - Complete Quranic content --- ##### Best Practices 1. **Use Go to Verse** — fastest way to navigate to specific verses 2. **Customize per-language** — set up typography for Arabic and each translation separately 3. **Stack translations** — compare multiple translations of the same verse 4. **Use tafsir systematically** — read classical and modern interpretations together 5. **Bookmark important verses** — save to Collections for later reference 6. **Use search** — find verses by reference or content quickly 7. **Toggle translation** — read Arabic alone when possible for deeper engagement 8. **Explore different translations** — different translators emphasize different aspects --- ##### Troubleshooting ###### "Translation won't download" **Possible causes:** 1. Internet connection is unstable 2. Storage space is full **Fix:** - Check internet connection - Free up storage space - Try downloading again ###### "Go to Verse search doesn't work" **Cause:** Syntax may be incorrect. **Fix:** - Use format `Surah:Ayah` (e.g., `2:255`) - Or use global ID (1–6,236) - Check that numbers are valid ###### "Verse numbers seem off" **Cause:** Different verse numbering systems exist. **Fix:** - Al Islam uses the standard Islamic numbering system - Different translations may use slightly different numbering - Check the metadata for the exact position ###### "Tafsir content is slow to load" **Cause:** Loading multiple tafsir works simultaneously. **Fix:** - Reduce the number of tafsir selected - Customize which tafsir you display ###### "References or metadata look like they belong to a different translation" **Cause:** Metadata comes from whichever rendering is set as **primary**, which is a separate choice from stack order. **Fix:** - Set the rendering you consider authoritative as the primary - The primary is badged whenever more than one rendering is on screen - See [The Reading Stack](#the-reading-stack-in-detail) ###### "A translation disappeared from my stack" **Cause:** The downloaded pack was removed, but your selection was kept rather than rewritten. **Fix:** - Re-download it and your arrangement returns exactly as it was ###### "My AI translation slot isn't filling in" **Cause:** A slot reports precisely which link is broken; each has a different fix. **Fix:** - **No route** — assign a model for translation in the Intelligence routing table - **Connection missing** — the connection it named was deleted; point the slot elsewhere - **Connection disabled** — re-enable it from the Intelligence hub - **Source missing** — the rendering it reads from left your stack; re-add it - **Waiting for source** — it is chained to a slot that has not produced text yet - Also check the slot is set to **automatic** rather than manual - See the [Intelligence documentation](/docs/intelligence) ###### "An AI translation looks wrong" **Cause:** Model quality varies enormously between providers, models and passages, and classical Arabic is harder than modern prose. **Fix:** - Compare against the published translations in the app — that is what they are there for - Route translation to a stronger model, or to a dedicated translation service - Never rely on an AI rendering for anything consequential; verify with a qualified scholar --- ##### Related - **[Intelligence](/docs/intelligence)** — the full guide to Translate, Listen, Ask, slots and lanes - **[Premium](/docs/premium)** — what unlocks the Intelligence features described here - **[Hadith Library](/docs/hadith-library)** — the same reading stack and Intelligence layer, applied to narrations - **[Notes — Qalam](/docs/notes)** — validated Quran references, and inserting translations into your writing - **[Collections](/docs/collections)** — where bookmarked ayat go - **[Search](/docs/search)** — finding ayat across translations and tafsir - **[Text Customization](/docs/text-customization)** — per-language typography for every rendering in your stack - **[History](/docs/history)** — what you have read ### Notes (https://alislam.lymrah.com/docs/notes) *Capture reflections, reminders, study points, tasks, tags, and Islamic references in a calm, structured writing space built for clear review.* **Intelligence** is Al Islam's model layer. It is not a chat window bolted onto the side of the app — it sits *underneath* every reading surface, so the app's own content is what the models actually work on: the ayah, the narration, a scholar's translation, a tafsir, your own notes. It runs on **your models, your accounts, your keys**. Al Islam never resells model access, and your keys never leave your device. Introduced in **version 4.5 ("Bayt al-Hikmah")**. Part of [Al Islam Premium](/premium). --- ##### Contents - [The Idea](#the-idea) - [Quick Start](#quick-start) - [Part I — Connecting a Provider](#part-i--connecting-a-provider) - [Part II — What Your Models Can Do](#part-ii--what-your-models-can-do) - [Part III — The Reading Layer](#part-iii--the-reading-layer) - [Part IV — Standing Translations](#part-iv--standing-translations) - [Part V — Your Own Commands](#part-v--your-own-commands) - [Part VI — Dictation](#part-vi--dictation) - [Part VII — Routing](#part-vii--routing) - [Part VIII — The Screens](#part-viii--the-screens) - [Part IX — Engine Settings](#part-ix--engine-settings) - [Part X — Keys, Traffic and Privacy](#part-x--keys-traffic-and-privacy) - [Part XI — What It Costs](#part-xi--what-it-costs) - [Part XII — When Things Fail](#part-xii--when-things-fail) - [Part XIII — Design Principles](#part-xiii--design-principles) - [Part XIV — Limits and Honest Caveats](#part-xiv--limits-and-honest-caveats) - [Frequently Asked Questions](#frequently-asked-questions) - [Glossary](#glossary) --- ##### The Idea Most apps that add AI do one of two things. They open a chat box in a corner, leaving you to copy your content into it. Or they resell somebody else's model at a markup, taking your content through their servers on the way. Intelligence does neither. **The work happens where you are reading.** Open a hadith and the actions are already beneath it. There is nothing to copy, nothing to paste, nothing to navigate away to. The model receives the passage, its reference, and its language — because the app already knows all three. **The account is yours.** You connect providers you already have, using keys you already hold. Whatever your provider charges is between you and them. There is no shared account, no token bundle, no markup, and no metering. That second decision is the more consequential one, and it shapes everything else: | Because the account is yours… | …this follows | | --- | --- | | We never see your traffic | Requests go device → provider, directly. We run no proxy and no relay. | | We cannot be a bottleneck | A model released this morning is usable this morning. | | You are never locked in | Change providers whenever you like, or run several at once. | | You can pay nothing | Several supported options run entirely on your own machine. | | Your bill is legible | It arrives from your provider, itemised by them, for usage you controlled. | The premium subscription unlocks the **suite** — the routing, the reading layer, the library, the studio, the dictation. The **usage** runs on your terms. --- ##### Quick Start Three steps, once. **1. Connect an account.** Pick your provider from the catalogue and paste your key. It is verified on the spot, so a mistyped key is caught immediately rather than the first time you try to read something. **2. Choose what serves what.** Pick a model for translation, for explanations, for speech. One choice is enough to begin — everything else falls back to it. **3. Open any hadith or ayah.** The actions are already there, underneath the text. Nothing else needs configuring. Everything beyond this point is refinement. --- ##### Part I — Connecting a Provider ###### The catalogue — 35 services, 10 protocols Al Islam speaks ten different provider protocols, covering thirty-five services between them. | Group | Services | | --- | --- | | **Major AI labs** | OpenAI · Anthropic · Google AI (Gemini) · Azure OpenAI · Mistral · xAI · DeepSeek · Moonshot · Qwen · Z.ai · Perplexity | | **Arabic-first** | Fanar — built for Arabic and for Islamic material | | **Inference platforms** | Groq · OpenRouter · Together · Cerebras · Fireworks · DeepInfra · Nebius · SambaNova · Novita · Hyperbolic · GitHub Models | | **On your own machine** | Ollama · LM Studio · Jan · llama.cpp · vLLM — keyless, private, running locally | | **Translation services** | DeepL · Google Cloud Translation · Azure Translator · LibreTranslate | | **Voice** | ElevenLabs (speech and transcription) · Deepgram (transcription) | | **Anything else** | A general connection for any OpenAI-compatible gateway, proxy or service not named above | That last row matters more than its size suggests. The general connection means a service that did not exist when this release shipped can still be used today, as can a company proxy, a self-hosted gateway, or a regional provider we have never heard of. ###### What a connection asks for Every service has its own idea of what a connection looks like — a key; a key and a region; a key and an endpoint; a project id; a deployment name; nothing at all. Al Islam builds the right form for whichever service you choose, so **each asks for exactly what it needs and nothing more**. You are never presented with an endpoint field for a service that has a fixed endpoint, or a region selector for a service that has no regions. ###### Instant verification Saving a connection tests it straight away, against the lightest call the service offers. A mistyped key, a wrong region, an endpoint with a typo — all caught at the moment you paste, not the first time you try to read something. ###### As many accounts as you like A personal key and a work key. A fast inexpensive model and a careful expensive one. A cloud service and a local one. Each connection is enabled or disabled on its own, so you can park one without deleting it. ###### Custom headers Every connection accepts custom headers, passed through exactly as written — enough to reach a company proxy, an authenticating gateway, or a service with its own conventions. ###### Local models Five of the supported options — **Ollama, LM Studio, Jan, llama.cpp and vLLM** — run on your own machine. No key, no account, no bill, and no data leaving your network at all. For anyone who wants the capability with none of the exposure, this is the configuration to choose. It is also the only configuration in which Intelligence works fully offline. ###### Masked once saved A key is shown only as a hint (`••••3kfa`) and never displayed again. See [Part X](#part-x--keys-traffic-and-privacy) for the complete account of how credentials are handled. --- ##### Part II — What Your Models Can Do Four capabilities, each routed independently. | Capability | What it gives you | | --- | --- | | **Translation** | Any passage rendered into any language you ask for | | **Text generation** | Explanations, summaries, key lessons, and instructions of your own | | **Speech** | Content read aloud in a natural voice | | **Transcription** | Your own speech turned into text inside the notes editor | Not every service does all four, and the app knows which does what. The catalogue shows each service's capabilities before you connect it, and the routing table only offers a connection for work it can actually perform. --- ##### Part III — The Reading Layer The screens are the smaller half of Intelligence. The larger half appears underneath the content itself. Every reading surface in the app — a hadith, an ayah, a scholar's translation, a tafsir, a translation your own model produced, and the random hadith on the home screen — carries the same row of three actions. ###### Translate One tap renders the passage into the language you choose. - **It looks like a translation.** The result is presented as a scholar-style card, laid out exactly like a published translation — the same typography, the same per-language fonts you have already set in [Text Customization](/docs/text-customization), the same reading experience. A translation reads as a translation regardless of what produced it. - **Translations are kept.** Every one is saved to your Library, attached to the ayah or narration it came from, so you never pay twice for the same passage and never lose one you wanted back. - **Duplicates are recognised.** Asking again for the same passage with the same model returns what you already have. - **Repeats are instant and free**, served from the device rather than the network. - **Changed sources are noticed.** If the underlying text is later updated, the saved translation is marked out of date, with one tap to produce a fresh one. - **Pin the ones that matter** so they stay at the top of your Library. - **Copy or insert.** Take the text out, or drop it straight into a [note](/docs/notes). ###### Translation lanes A lane turns a good combination into a single tap. Save one as *Urdu via DeepL* or *English via Gemini* — a target language, and optionally a specific account and model — then choose it from the reading itself, without ever opening the routing table. Your last choice is remembered, so the common case is one tap from then on. ###### Listen Content is read aloud in a natural voice, and listening reaches everything in the app with words in it — not only the app's own text. - **Readings** — the Arabic, or any translation shown beneath it. - **Answers** — anything a model has written for you, spoken once it is finished rather than half-written. - **Your notes** — a Qalam document is read as continuous prose, so headings, formatting marks, table borders and drawings never reach the voice. - **Voice and speed are yours**, adjustable from the player and remembered between visits. - **Speech can have its own provider.** A specific account and model can serve speech regardless of what serves everything else — useful when one provider has the voice you like and another has the translations you trust. - **One voice at a time**, and it keeps reading when you leave the screen, with the player following you. ###### Ask A conversation about the passage in front of you, appearing **inside the screen you are already reading** — nothing to copy out, nothing to navigate away to. - Threads stream in as they are written. - **Follow-up questions keep their memory**, so a conversation builds instead of restarting. - Answers can be read aloud, copied, or inserted into a note. - Each reading keeps its own thread, so moving between ayat does not mix them up. **The instructions behind Ask are written specifically for Islamic source material:** stay faithful to the text, invent no rulings and no attributions, preserve honorifics, and say plainly when something is uncertain rather than smoothing it over. This reduces a class of failure. It does not eliminate it — see [Part XIV](#part-xiv--limits-and-honest-caveats). ###### The workspace For longer work, the same three abilities open into a fuller surface with **Translate**, **Ask** and **Listen** side by side as independent sections — translate a passage, question it, and hear it without any one of them interrupting another. Where a reading has several versions on screen — the Arabic and its translations, or a narration and its renderings — **each section chooses its own source**. Ask about the Arabic while listening to the Urdu, or translate a scholar's English into a fourth language while the original stays in view. --- ##### Part IV — Standing Translations Beyond one-off actions, a language can be **pinned to stay**. Set a standing translation to Urdu, and every hadith you open arrives with Urdu already beneath it — filled in as you go, laid out as an ordinary part of the page rather than something you had to ask for. - **More than one at a time.** Urdu and English together, or three languages one below another. - **Chainable.** Take a scholar's English rendering and produce Turkish from it, or build a second language out of the first rather than out of the original. - **They report themselves.** If a connection is removed or a model stops answering, the card says so plainly instead of quietly disappearing. - **They know where they belong.** A standing translation built from one book's published translation appears only in that book. One built from the narration itself works everywhere — including the home screen, where the hadith belongs to no particular book at all. - **Reorder, rename and remove** them at any time from the reading itself. - **They work in the Quran too**, filling in as you move from ayah to ayah. --- ##### Part V — Your Own Commands Translation and asking cover most of it. For everything else, you can write **your own instructions** and run them over any passage in the app. A command is a short template with placeholders for the passage, its reference, and a target language: > *Extract the fiqh points as a numbered list.* > *Explain this to a ten-year-old.* > *Give me three lessons and one action for today.* > *Rewrite this translation in plainer English.* Write it once and it appears wherever readings appear. Five are included to begin with — **Summarize**, **Key lessons**, **Explain simply**, **Deep explanation** and **Remaster** — and every one of them is yours to rewrite or delete. Commands and translation lanes are both managed in the **Actions studio**, where you can see what each will do before you run it. --- ##### Part VI — Dictation The [Qalam notes editor](/docs/notes) gains a microphone. Tapping it opens a recorder **inside the editor** — nothing opens over your note, nothing navigates away from it. - **Record, pause, resume**, and stop **when you say so.** It never decides on its own that you have finished speaking. There is no wake-word, no background listening, and no silence detection that starts or stops capture for you. - **A live waveform** driven by your actual microphone level, so you can see that you are being heard. - **A running timer** and an unmistakable state at every stage. - **Import instead of recording** — hand it an audio or video file you already have and transcribe that. - **Transcribe is a deliberate step.** When you take it, the words land **exactly at your cursor**, inside the note you were already writing. - **Language can be stated or left open** for the model to work out. - **Record as many times as you like** into the same note, each take landing where you put it. Dictate a lecture as you listen to it, capture a thought on the move, or write a long note without typing a word of it. The editor also gains **Ask Intelligence** on a selection or on the whole note — question what you have written, or have a passage explained, with the answer available to insert straight back into the page. Devices with no microphone can still transcribe an imported file. --- ##### Part VII — Routing The **Routing** screen decides which connection, model and voice serves each kind of work — and lets you override it for individual areas of the app. - **Read hadith with one model, the Quran with another, your notes with a third.** - **Anything you have not set falls back** to a single global default, so no request is ever left unanswered. - **Model and voice lists are read from your own account** wherever the service supports it, so you see exactly what you are entitled to use — not a hardcoded list that goes stale. - **Any model id can be typed in directly.** A model released this morning is usable this morning, without waiting for an app update. - **Per-capability tuning** — creativity, response length, formality, and the other settings each service genuinely accepts — shown where it applies and hidden where it does not. The design intent is that routing is something you *can* use, not something you *must*. A single global default is a complete configuration. The table exists for the person who wants a cheap fast model summarising and a careful expensive one translating. --- ##### Part VIII — The Screens | Screen | What it holds | | --- | --- | | **Hub** | Your connections at a glance, their health, and a lane for each capability showing what is ready and what still needs a model | | **Provider catalogue** | Every supported service, what it can do, and links to its console and documentation | | **Connection editor** | The form for a single account, validated as you type, with a combined save-and-test | | **Connection detail** | Health, the full model catalogue for that account, which routes it currently serves, its usage history, and removal | | **Routing** | Capability by area — the whole table of what serves what, with connection, model and voice pickers | | **Playground** | Live benches for all four capabilities: translate a phrase, generate a reply, hear a voice, transcribe a file — without touching your own content | | **Activity** | Totals, day-by-day bars, a breakdown per connection, and a log of individual requests with how long each took | | **Engine settings** | Streaming, caching, time limits, retries and privacy | | **Actions studio** | Your own instruction templates and translation lanes | | **Library** | Every translation the app has produced for you — searchable, pinnable, prunable | The **Playground** deserves a note. It exists so you can evaluate a model without spending your own content on the experiment — try a voice before assigning it, compare two models on the same phrase, confirm a new connection works end to end. Nothing you do there touches your readings or your notes. The **Activity** screen exists so the bill is never a surprise. It shows what ran, on which connection, how long it took, and how much was used — before your provider's invoice tells you the same thing a month later. --- ##### Part IX — Engine Settings | Area | What you control | | --- | --- | | **Responses** | Whether answers stream in as they are written, or arrive complete | | **Speed** | Whether repeat translations are served instantly from the device | | **Patience** | How long a single request may take, from five seconds to ten minutes | | **Reliability** | How many times a failed request is tried again before it gives up | | **Privacy** | Whether usage is recorded at all, and whether a short excerpt of what you read is kept beside it | Every one of these has a sensible default. The ten-minute ceiling exists for slow local models on modest hardware; the five-second floor exists for anyone who would rather fail fast than wait. --- ##### Part X — Keys, Traffic and Privacy A system holding your provider credentials owes you a plain account of how it treats them. ###### Your keys - **Keys are encrypted on your device** with a hardware-backed key that cannot be taken off it, held separately from everything else the app stores. - **They are never shown again** after you save them — only a masked hint. - **They never appear in logs, usage records, backups or exports.** This holds on every plan, under every setting, with no exception. - **Removing a connection removes its keys first**, so a connection can never be left behind without a way to clear it — and removal stays available to you at all times. ###### Your traffic - **Traffic goes only where you sent it.** Al Islam's AI connection has **no default destination**; requests reach the providers you configured and nowhere else. - **We operate no proxy and no relay.** Your device contacts your provider directly. We cannot read your prompts, your content, or the responses — not because we promise not to, but because they never travel anywhere we can see them. - **Nothing is sent anywhere until you ask for it**, and when you do, it goes to the provider you chose. ###### Your records - **Usage records hold facts, not content** — which service, which model, how long it took, how much was used. - **An excerpt of what you read is stored only if you switch that on yourself.** It is off by default. - **Caching and usage recording can both be switched off** entirely. ###### Provider messages Some services quote your own credential back inside their error text. Anything of that shape is **stripped before it reaches the screen**, so a provider's carelessness cannot become your exposure. ###### What this does not cover Once your request reaches the provider you chose, **that provider's privacy policy governs it, not ours.** Providers differ significantly in whether they retain submitted data or use it to train models. We strongly encourage reading the policy of any provider before connecting it — and the catalogue links to each service's own documentation for exactly this reason. If you want the capability with none of that exposure, use a [local model](#local-models). Nothing leaves your machine. The complete account of the app's data handling is in the [Privacy Policy](/privacy). --- ##### Part XI — What It Costs **Al Islam Premium** unlocks the Intelligence suite. **Your provider** bills you for the models. We do not resell model access, mark it up, meter it, or take a share. There is no token bundle to buy from us and none to run out of. What that means in practice: - **A local model costs nothing at all.** No key, no account, no bill. - **Translation services** are typically the cheapest paid route for translation specifically, and several have free tiers. - **Inference platforms** often serve open models at a fraction of major-lab pricing. - **Major labs** cost the most and are usually the most capable. - **Repeat translations cost nothing**, because they are served from your device rather than the network. The **Activity** screen shows what you have used so you are never guessing, and every service in the catalogue links to its own console so you can check pricing before you commit. --- ##### Part XII — When Things Fail Model providers fail in ordinary ways — a rate limit, an expired key, a model withdrawn, a network that dropped. Intelligence is built to say which. - **Failures are named, not swallowed.** Each provider's own error type is mapped onto a common vocabulary, so a rate limit reads as a rate limit rather than as a short or empty answer. - **Retries are bounded and configurable**, and only failures that could plausibly succeed on a second attempt are retried. - **Streaming answers are held back until the text stops arriving** where partial output would mislead, so you never read half a sentence as though it were the whole one. - **Standing translations report their own breakage.** If the connection behind one is removed, the card says so rather than quietly vanishing. - **Connection health is visible** on the Hub and on each connection's detail screen, so a key that stopped working is visible before you depend on it. --- ##### Part XIII — Design Principles Five decisions shaped the system, and each has a reason worth stating. **1. Underneath the content, not beside it.** A chat window makes you the integration layer — copying passages out, pasting results back, losing the reference on the way. Putting the actions beneath the reading means the app supplies the passage, its reference, and its language automatically. The model gets better context than you would have pasted, and you do no work. **2. Bring your own key, without exception.** Reselling model access would have been simpler to build and easier to monetise. It would also have meant your content passing through our servers, your costs hidden inside our margin, and your model choice limited to what we had negotiated. Every one of those is worse for you. **3. Presets never cage.** Wherever the app offers a list — models, languages, voices, commands — it also accepts anything you type. A model released this morning works this morning. A language not in the list is still a language. The list is a convenience, never a boundary. **4. Output must look like the app.** A translation is presented as a scholar-style card in your own per-language typography, not as chat output in a bubble. Content produced by your model is content, and it should read like the published translations sitting beside it. **5. Say what happened.** Failures are named. Stale translations are marked. Broken standing translations announce themselves. Usage is visible before the invoice arrives. A system that spends your money and speaks about your religion should never be vague about what it just did. --- ##### Part XIV — Limits and Honest Caveats This section matters more than any other in this document. ###### Models fabricate, and they do it fluently Language models produce confident, well-formed, entirely invented output. In Islamic material this shows up as **invented rulings, invented attributions, and citations that look authentic but are not** — a fabricated chain of narration reads exactly like a real one to anyone who cannot check it. This is a property of the technology. No prompt, no provider, and no app removes it. ###### What Al Islam does about it - The instructions behind **Ask** are written for Islamic source material specifically: stay faithful to the text, invent no rulings and no attributions, preserve honorifics, and state uncertainty plainly rather than smoothing it over. - Model output is always presented **alongside** the authentic sources it came from, never in place of them. - The app carries 232,559 hadith and 122 scholarly translations offline, so the authentic reference is always one tap away. - Translations are attributed to the model that produced them, and saved with that attribution. These measures reduce the failure rate. They do not make output trustworthy on its own. ###### What you must do about it **Verify anything consequential against the authentic sources in the app, or with a qualified scholar.** **AI output is not a religious authority.** It is not a fatwa, not a scholarly verdict, and not a substitute for qualified Islamic scholarship. Treat it as a study aid — a fast first pass, a rough rendering, a prompt for your own thinking — and never as a final word. ###### Other limits worth knowing - **Translation quality varies enormously** between models, languages, and passages. Classical Arabic is harder than modern prose, and a cheap model will show it. - **Speech mispronounces Arabic** to varying degrees depending on the voice and provider. - **Transcription accuracy depends on audio quality**, accent, and background noise. - **Provider availability, pricing and model behaviour are outside our control** and may change without notice. - **Intelligence requires a connection**, unless you are running a model locally. --- ##### Frequently Asked Questions ###### Do I need Intelligence to use Al Islam? No. Every core feature of the app — Quran, Hadith, Prayer Times, Qibla, Hijri Calendar, Tasbeeh, Notes, Search, Collections, History — works exactly as it always has, with no model connected and no subscription. Intelligence adds a layer; it replaces nothing. ###### Why do I need my own API key? So your content never passes through our servers, your costs are never hidden inside our margin, and your choice of model is never limited to what we negotiated. See [The Idea](#the-idea). ###### Can I use it for free? Yes, in two senses. Local models (Ollama, LM Studio, Jan, llama.cpp, vLLM) cost nothing to run and need no key. And several hosted services have free tiers sufficient for occasional use. A premium subscription is still required to unlock the suite itself. ###### Which provider should I choose? For **translation specifically**, a dedicated translation service is usually cheapest and often best. For **explanation and discussion**, a major lab model. For **Arabic and Islamic material**, Fanar is built for it. For **privacy above all**, a local model. For **cost**, an inference platform serving open models. Nothing stops you connecting several and routing each kind of work to the one that suits it. ###### Is my key safe? Keys are encrypted on your device with a hardware-backed key that cannot be taken off it, shown once and then only as a masked hint, and excluded from logs, usage records, backups and exports. Removing a connection removes its keys first. See [Part X](#part-x--keys-traffic-and-privacy). ###### Does Al Islam see what I ask? No. Requests go from your device to your provider directly. We run no proxy and no relay, so there is no point at which your prompts or responses are visible to us. ###### Does my provider see what I ask? Yes — that is who you sent it to. Their privacy policy governs what happens next, and providers differ significantly in whether they retain or train on submitted data. Read theirs before connecting, or use a local model. ###### Can I trust an AI translation of the Quran? Treat it as a study aid, not as a scholarly translation. The app ships 122 published translations by named translators precisely because those are the ones to rely on. An AI rendering is useful for a language no published translation covers, or for a quick sense of a passage — always with the authentic text beside it. ###### What happens to my translations if I cancel premium? They stay. Saved translations, commands, lanes and notes are your content and are not deleted when a subscription ends. Premium features become unavailable; your data remains yours and remains on your device. ###### What happens if I remove a connection? Its keys are removed first, then the connection. Any standing translation or route that depended on it reports itself as broken rather than silently disappearing, so you can reassign it. ###### Can I use a provider that isn't listed? Yes. The general connection accepts any OpenAI-compatible gateway, proxy or service, with custom headers passed through exactly as written. ###### Does it work offline? Only with a local model. Translations already produced are kept on your device and remain readable offline regardless. --- ##### Glossary **BYOK (Bring Your Own Key)** — a model in which the app provides the interface and you provide the provider account. Your credentials, your billing, your choice. **Capability** — one of the four kinds of work: translation, text generation, speech, transcription. **Connection** — one configured provider account. You may have as many as you like. **Lane** — a saved translation combination (a target language, optionally a specific account and model) reachable in one tap from a reading. **Local model** — a model running on your own machine rather than a remote service. No key, no bill, nothing leaving your network. **Protocol** — the API convention a service speaks. Al Islam speaks ten, which is how thirty-five services are supported. **Routing** — the table deciding which connection, model and voice serves each capability in each area of the app. **Standing translation** — a language pinned to appear automatically beneath every reading, rather than requested one passage at a time. --- ##### Related Documentation - [Notes — Qalam](/docs/notes) — the editor Intelligence writes into - [Text Customization](/docs/text-customization) — the typography translations adopt - [Hadith](/docs/hadith-library) and [Quran](/docs/quran) — the reading surfaces the layer sits beneath - [Privacy Policy](/privacy) — the complete account of the app's data handling - [Changelog](/changelog) — what shipped when --- **Questions?** Email support.alislam@lymrah.com, or reach us on [X](https://x.com/AlIslamIO) or [Instagram](https://www.instagram.com/alislamappofficial/). ### The Hadith Library (https://alislam.lymrah.com/docs/hadith-library) *33 authentic collections with references, Sanad and Takhreej.* Al Islam's **Hadith section** provides access to **33 Hadith collections** with support for **5 languages** (Arabic, English, Urdu, Hindi, and Bangla). The section features rich metadata, granular search and sorting, detailed preview screens with swipable navigation, and comprehensive hadith grading information. --- ##### Overview The Hadith section is accessible from the bottom navigation bar under **Tools**. When you open it, you'll see a list of all available Hadith collections with detailed information about each. --- ##### Terminology To avoid confusion, Al Islam uses specific terminology: | Internal Term | Traditional Term | Meaning | |---|---|---| | **Collection** | Hadith book | A major hadith compilation (e.g., Sahih al-Bukhari) | | **Chapter** | Kitab | A section within a collection | | **Sub-chapter** | Bab | A subsection within a chapter | This terminology is used throughout the Hadith section interface for consistency. --- ##### Content ###### Collections Available Al Islam currently supports **33 Hadith collections**, including: - Sahih al-Bukhari - Sahih Muslim - Sunan Abu Dawud - Sunan al-Tirmidhi - Sunan an-Nasa'i - Sunan Ibn Majah - Musnad Ahmad - [See more](/library) The collection includes **Sahih Sittah** (the six most authentic collections) and other mainstream hadith books across different categories (Sahih, Sunan, Musnad, Jami', Siyar, etc.). ###### Languages Supported Currently, Hadith collections are available in **5 languages**: - **Arabic** (العربية) - **English** - **Urdu** (اردو) - **Hindi** (हिंदी) - **Bangla** (বাংলা) New languages and collections are continuously being added with each update. --- ##### Collections List View When you open the Hadith section, you see all available collections listed with rich metadata: ###### Information Displayed per Collection Each collection displays: - **Collection name** — the title of the hadith book - **Compiler name** — who compiled the collection - **Total hadith count** — number of narrations in the collection - **Total chapters** — number of chapters (Kitab) - **Available languages** — which languages have been downloaded - **Compilation date** — when the collection was originally compiled - **Reading progress** — a progress bar showing how much you've read - **Progress percentage** — percentage of the collection you've completed - **Last read date** — when you last opened this collection - **Category** — the type of collection (Sahih, Sunan, Musnad, Jami', Siyar, etc.) ###### Searching Collections A **search bar** lets you find collections by name. You can: - Search by collection name - Search instantly as you type ###### Sorting Collections Tap the **Sort** button to arrange collections by: - **Collection name** — alphabetical order - **Arabic name** — alphabetical order in Arabic - **Chapter count** — number of chapters - **Total hadith count** — total narrations - **Compilation date** — when originally compiled - **Available translations** — number of languages - **Read progress** — how much you've read - **Read count** — total hadith you've read from this collection - **Last read** — most recently opened collections Each sort option can be in **ascending or descending order**. ###### Default Collections By default, **Sahih al-Bukhari** is provided in **English and Urdu** as a starter collection. Country-specific resources may be pre-provided based on your region, but you can download any collection and language on demand. --- ##### Downloading Collections ###### How to Download 1. From the Collections List, tap on a collection you want to download 2. Select the **language** you want to download 3. The download happens **instantaneously** ###### Data Compression All hadith data is **heavily compressed** for fast download and efficient storage. ###### Managing Downloads You can: - **Download multiple languages** for the same collection - **Delete downloaded collections** if you need to free storage To delete a collection: 1. From the Collections List, tap on a collection 2. Tap **Delete** (or similar option) 3. The collection and its associated data are removed --- ##### Chapters View When you tap on a specific collection from the Collections List, you enter the **Chapters view**, which shows all chapters (Kitab) within that collection. ###### Information Displayed per Chapter Each chapter shows: - **Chapter name** — the title of the chapter - **Chapter number** — position within the collection - **Starting hadith number** — first hadith in the chapter - **Ending hadith number** — last hadith in the chapter - **Total hadith count** — number of narrations in this chapter ###### Changing Language At the top of the Chapters view, there's a **language button**. Tap it to: - Switch to a different language for this collection - Chapter names and text update instantly The language change applies to all subsequent views in this collection. ###### Searching Chapters A **search bar** lets you find chapters by: - **Chapter name** — search by title - **Chapter number** — search by position - **Any field** — search across available chapter metadata ###### Sorting Chapters You can **sort chapters** by various criteria (similar to collection sorting options). ###### [Text Customization](/docs/text-customization) You can **customize the text appearance** of chapters using the Text Customization feature. Tap the **⋮ (More)** menu and select **Customize Text** to adjust: - Font size - Line height - Colors - Fonts - Other typography settings ###### Collection Details Tap the **⋮ (More)** menu and select **Details** to view: - **Book information** — comprehensive information about the collection - **Metadata** — details about compilation, categories, narrators, etc. --- ##### Hadiths View When you tap on a specific chapter, you see a **list of all hadith narrations** in that chapter. ###### Hadith List Display Each hadith in the list shows: - **Hadith number** — position within the chapter - **Hadith text preview** — a snippet of the narration - **Current language** — the language you're viewing ###### Actions from the List From the hadith list, you can: - **[Bookmark](/docs/collections)** — save to Collections - **Copy** — copy the full hadith text - **Change language** — switch to a different language translation - **Customize text** — adjust typography for this view - **Preview** — open the detailed preview screen --- ##### Hadith Preview Screen Tap on any hadith to open the **preview screen**, which displays the hadith with detailed metadata and navigation. ###### Swipable Navigation The preview screen supports **swipable navigation**: - **Swipe left** — move to the next hadith - **Swipe right** — move to the previous hadith This lets you read through hadith sequentially without returning to the list view. ###### Go to Hadith Function If you want to jump to a specific hadith number: 1. Tap the **Go to Hadith** button 2. Enter the hadith number 3. The screen scrolls instantly to that hadith ###### Main Actions From the preview screen, you can: - **[Bookmark](/docs/collections)** — save this hadith to Collections - **Choose what you read it in** — open the resource sheet and build your reading stack (see below) - **Copy** — copy the hadith text (long-press to copy everything, including metadata) - **[Customize text](/docs/text-customization)** — adjust typography for this view - **Translate · Listen · Ask** — the [Intelligence](/docs/intelligence) row, beneath the narration - **[Write a note](/docs/notes)** — attach a Qalam note to this narration --- ##### The Reading Stack — Reading Several Renderings at Once This is the largest change to the reading experience since the section was built, and it is worth reading carefully. **Previously you chose one language and read it.** One translation on screen, and switching meant leaving the one you had. That is no longer how it works. You can now put **as many renderings of a narration on screen as you like, at the same time**, arranged in the order you want to read them. ###### Building the stack Open the resource sheet from the preview screen. It lists every rendering of this collection you have downloaded, and you **tick as many as you want**. - Tick the Arabic and an English translation to read them together. - Tick three English translations to compare how different translators handled the same wording. - Tick Arabic, Urdu and English to read across all three at once. - Tick nothing at all — a real and supported choice, covered below. Each rendering you tick appears as its own card in the reading stack, one below another, each in its own typography from [Text Customization](/docs/text-customization). ###### Arranging the stack The cards are **draggable**. Press and hold a card and move it up or down, and the stack keeps that order for this collection from then on. This matters more than it sounds. A reader who wants the Arabic first and the translation beneath it, and a reader who wants the translation first with the Arabic underneath for reference, are both accommodated without either being the "default" imposed on the other. ###### The primary resource With several renderings on screen, one question needs an answer: **which one is authoritative?** That rendering is the **primary**, and you choose it explicitly. The primary is the rendering that: - All the **metadata** is taken from — the grading, the reference numbers, the narrator chain, the chapter information - Is used as the **source text** when something needs one specific version to work from - Is carried through even when it is not visible on screen **Order and primacy are deliberately separate choices.** Where a rendering sits in your stack is about how you like to read. Which one is primary is about which is authoritative. The app does not conflate them, and it does not force the primary to the top of the stack — it simply **marks** it, with a badge that appears only when more than one rendering is on screen, because with a single card the question does not arise. So you can read an English translation first, with the Arabic beneath it, while the Arabic remains the primary that metadata comes from. Both preferences are yours and neither has to be sacrificed for the other. ###### Selecting nothing at all An empty selection is a **real preference**, not an error state — and the app distinguishes it from never having chosen. Someone who reads only their own AI translations may legitimately want no published rendering on screen at all. That is supported: the stack shows only your AI cards, and the primary is still carried invisibly underneath so those AI translations always have a source to work from. ###### When a rendering is removed If you delete a downloaded pack that your stack refers to, **your choice is not silently rewritten.** The app keeps what you asked for and reconciles it against what it can actually show, so reinstalling the pack restores your arrangement rather than leaving you to rebuild it. ###### Per collection, not global The stack is remembered **per collection**. Bukhari can be Arabic-first with two English translations while Muslim is a single Urdu rendering. Each collection keeps the arrangement you gave it. --- ##### Intelligence on Every Narration Every narration in the app carries the [Intelligence](/docs/intelligence) row beneath it: **Translate · Listen · Ask**. These require [Premium](/docs/premium) and run on your own AI provider account under your own key. A short summary follows; the complete guide is in the [Intelligence documentation](/docs/intelligence). ###### Translate One tap renders the narration into any language you choose. - The result appears as a **scholar-style card in the reading stack**, laid out exactly like a published translation, in the same per-language typography as everything else. A translation reads as a translation regardless of what produced it. - **Every translation is saved** to your Library, attached to the narration it came from — so the same passage is never paid for twice. - **Repeats are instant and free**, served from your device rather than the network. - If the underlying text is later updated, the saved translation is **marked out of date**, with one tap to refresh it. - **Translation lanes** turn a favourite combination — *Urdu via DeepL*, say — into a single tap from the reading itself. ###### Listen The narration read aloud in a natural voice — the Arabic, or any translation shown beneath it. Voice and speed are yours, and playback continues when you leave the screen with the player following you. ###### Ask A conversation about the narration in front of you, appearing **inside the screen you are already reading**. Follow-up questions keep their memory, and each narration keeps its own thread so moving between hadith does not mix them up. The instructions behind Ask are written specifically for Islamic source material: stay faithful to the text, invent no rulings and no attributions, preserve honorifics, and say plainly when something is uncertain. **Verify anything consequential.** AI output can be fluent and entirely fabricated, including invented chains of narration that read exactly like real ones. It is a study aid, never a religious authority. See [the limits section](/docs/intelligence#part-xiv--limits-and-honest-caveats). ###### AI translation slots Beyond one-off translations, a language can be **pinned to stay** — an *AI slot* that sits in your reading stack permanently. Set a slot to Urdu and every narration you open in that collection arrives with Urdu already beneath it, filling in as you read rather than waiting to be asked. Slots behave as first-class members of the reading stack: - **More than one at a time** — Urdu and Turkish together, each its own card. - **Automatic or manual.** A slot either translates the moment you open a narration, or sits showing a *Translate* button until you ask. Your choice, per slot. - **Chainable.** A slot can read *another slot's output* rather than the original — take a scholar's English rendering and produce Turkish from that, rather than from the Arabic. - **They know where they belong.** A slot built from one collection's published translation appears only in that collection. One built from the narration itself works everywhere, including the [Random Hadith](#random-hadith) card on the home screen, where the narration belongs to no particular book. - **They report themselves.** A slot never silently disappears. If the connection behind it is deleted, switched off, left without a route, or if the rendering it reads was removed, the card **says which** — and each of those is repairable. The states a slot can report are deliberately distinct, because each needs a different fix: *no model assigned*, *connection missing*, *connection switched off*, *source rendering missing*, and *waiting for the slot it is chained to*. --- ###### Hadith Metadata The preview screen displays comprehensive metadata for each hadith: ###### Authenticity & Grading - **Authenticity grade** — is it Sahih (authentic), Hasan (good), Da'if (weak), or another grade - **All applicable grades** are listed ###### Reference Information - **Reference number** — the hadith's position - **Collection reference** — which collection this is from - **Progress bar** — showing how many hadith you've read out of the total in this collection - **Percentage** — what percentage of the collection you've completed ###### Chapter Information - **Chapter number** — which chapter this hadith belongs to - **Chapter name** — the chapter title - **Chapter position** — how many chapters into the collection - **Chapter progress bar** — showing progress through the chapter - **Percentage of chapters** — what percentage of chapters you've completed ###### Position within Chapter - **Position number** — which hadith in this chapter - **Total in chapter** — how many hadith are in this chapter - **Progress bar** — showing progress through the chapter ###### Titles - **Arabic title** — the original Arabic title/heading ###### Narrator Information - **Narrator** — who narrated this hadith ###### Collection Details - **Collection category** — Sahih, Sunan, Musnad, Jami', Siyar, etc. - **Compilation date** — in both Hijri (Islamic) and Gregorian calendars - **Total chapters** — in the collection - **Total languages** — available translations - **Last read** — when you last opened this collection - **Total hadith** — count in the collection ###### Reading Progress - **Your reading progress** — how much of the collection you've read - **Reading statistics** — reflects your actual reading history ###### Swipable Progress Bar You can **swipe the progress bar** to quickly jump to a different position in the collection. Tap **Go to Hadith** to enter a specific number. --- ##### Random Hadith The hadith card on the home screen has been **rebuilt into a proper daily-reading engine**. It is no longer a random pull from whatever you have downloaded — it is a draw you define, on a cadence you choose, that tells you what it did. ###### Draw settings — saying exactly what may be drawn A **Draw settings** screen defines what the card may reach for. Every filter is independent and they combine, so *the Urdu renderings of Bukhari and Muslim, sahih only, short, that I have not read before* is a single ordinary thing to ask for. | Filter | What it selects | | --- | --- | | **Books** | Any collections you choose, or all of them | | **Rendering** | Specific published translations, down to the individual edition | | **Language** | Any language, across the whole shelf at once | | **Gradings** | Sahih, Hasan, Da'if and the rest | | **Only the six collections** | Restrict the draw to the Sihah Sittah | | **Length** | A shortest and a longest, or an exact length | | **Only ones I have not read** | Skips anything already in your [History](/docs/history) | | **Avoid repeats** | Never the one before, or never the last several | Some deliberate details in how these behave: - **Every list leads with its way out** — *All books*, *Any language*, *Any grading* — so a filter is never something you can enter and not leave. - **Each setting states its own answer in plain words**, on a single line. An empty selection reads *All books*, not *none*. - **Counts appear as sentences** beneath the setting they belong to — *1,203 hadith available* — so you can see the pool shrinking as you narrow it. - **When a combination reaches nothing, the screen says so before you leave it**, rather than leaving you to discover it on the home screen afterwards. ###### More than one set of settings Save as many sets as you like. A long contemplative set for the evening; a short sahih one for the commute; a Ramadan set built around fasting and patience. - The set you are editing is the **first thing on the screen** — named, switchable with one tap, renameable, and deletable when you are finished with it. - **There is no Save button.** The screen keeps your changes as you make them, and nothing is lost by leaving. - **Changing your settings does not take the hadith away.** It stays on screen for as long as your new settings still permit it, and if only the rendering changed, only the rendering changes. ###### Deciding when it changes | Cadence | Behaviour | | --- | --- | | **Daily** | One hadith for the whole day | | **Weekly** | One for the week | | **Every time you open the app** | A fresh one each session | | **Only when you ask** | It stays until you draw again | A hadith of the day now genuinely lasts the day. Rotating the phone, scrolling away, opening another screen and coming back all leave it exactly where it was. ###### It tells you what it did When your settings are narrow enough that nothing matches — a translation was removed, everything short has been read, *not read before* has run its course — the card **widens the search one careful step at a time, and says which step it took.** It gives ground in the order that costs you least: 1. How recently you saw something 2. Unread-only 3. Length 4. Gradings 5. The six-collections restriction 6. Specific renderings 7. Languages 8. The books themselves, last of all *Short sahih hadith from Bukhari* surrenders shortness long before it surrenders Bukhari. ###### Read it in A picker on the card answers one question only: **what do I read this in?** - **Languages lead**, because a language decides whether a narration is readable at all. - Languages **already on the device** sit at the top; those still to be downloaded sit beneath them, one tap from the same answer. - The **full translation library** is one level further down, for anyone who wants an exact edition. - Beneath them sits **AI translation** — a standing instruction that renders whatever is drawn into a language nothing on the shelf was ever published in, and keeps doing so as the draw moves from book to book. Choosing a language **keeps the hadith you are looking at** and re-renders it, drawing a new one only if this narration genuinely does not exist that way. ###### Actions on the card - **Draw again** — a fresh narration immediately - **[Bookmark](/docs/collections)** — save to Collections - **Language picker** — as above - **Copy** — copy the narration text - **Preview** — open the full preview screen - **Translate · Listen · Ask** — the same [Intelligence](/docs/intelligence) row as every other reading surface - **[Customize text](/docs/text-customization)** — adjust typography The actions you reach for most — a fresh draw, a bookmark, the language picker — sit in the open along the card's title rather than behind a menu. ###### Standing translations work here too AI translation slots built from the narration itself appear on the card exactly as they do in the reader, filling in as each new hadith is drawn. Slots built from a *specific book's* published translation do not — the drawn hadith belongs to no particular book, so there is nothing for them to read from. ###### It remembers Every hadith the card draws is written into your **[History](/docs/history)** like any other reading, so what you were given last Tuesday is still there to find. ###### Performance Selection is **instant** regardless of how many collections you have downloaded or how narrow your filters are. --- ##### Text Customization You can customize how hadith text appears throughout the section using the **Text Customization feature**. This applies to: - **Chapter listings** - **Hadith previews** - **Random hadith** - **All other hadith views** Access it by tapping **⋮ (More)** → **Customize Text**. --- ##### Current Status & Updates **Current state:** - **33 Hadith collections** available - **5 languages** supported (Arabic, English, Urdu, Hindi, Bangla) - Includes **Sahih Sittah** and other mainstream collections **Ongoing additions:** - New hadith collections are continuously being added - New languages are regularly added - Each app update includes improvements and additional resources --- ##### Best Practices 1. **Download strategically** — download collections and languages you'll actually use 2. **Use search** — faster than browsing if you're looking for a specific collection 3. **Leverage sorting** — arrange collections by your most-used criteria 4. **Explore metadata** — the detailed references and grading information is comprehensive 5. **Use Random Hadith** — great way to discover hadith across all your downloaded collections 6. **Bookmark favorites** — save important hadith to Collections for easy reference 7. **Customize typography** — adjust text appearance for comfortable, extended reading --- ##### Troubleshooting ###### "Collection won't download" **Possible causes:** 1. Internet connection is unstable 2. Storage space is full 3. Download server is temporarily unavailable **Fix:** - Check internet connection - Free up storage space - Try downloading again ###### "Language switch didn't work" **Cause:** The language you selected may not be available for this collection. **Fix:** - Check the Collections List to see which languages are available for this collection - Download the language first if it hasn't been downloaded yet ###### "Random Hadith is slow" **Cause:** Very large number of hadith downloaded across many collections. **Fix:** - Random selection is optimized and should be instant, but if you experience delays, try closing and reopening the app ###### "Hadith metadata seems incomplete" **Cause:** The collection data may not have fully downloaded or may be corrupted. **Fix:** - Delete the collection and re-download it - Ensure you have enough storage space. ###### "The metadata is showing the wrong translation's details" **Cause:** Metadata comes from whichever rendering is set as **primary**, and that is a separate choice from where a rendering sits in your stack. **Fix:** - Open the resource sheet and set the rendering you consider authoritative as the primary - The primary is marked with a badge whenever more than one rendering is on screen - See [The Reading Stack](#the-reading-stack--reading-several-renderings-at-once) ###### "A rendering vanished from my stack after I deleted a pack" **Cause:** Your stack still refers to it — the app keeps your choice rather than rewriting it. **Fix:** - Re-download the pack and your arrangement returns exactly as it was - Your selection is never silently rewritten when a pack is removed ###### "My AI translation slot says it can't produce anything" **Cause:** A slot reports precisely which link is broken, and each has a different fix. **Fix:** - **No route** — assign a model for translation in the Intelligence routing table - **Connection missing** — the connection it named was deleted; point the slot at another - **Connection switched off** — re-enable it from the Intelligence hub - **Source missing** — the rendering it reads from is no longer in your stack; re-add it - **Waiting for source** — it is chained to another slot that has not produced text yet - See the [Intelligence documentation](/docs/intelligence) ###### "Random Hadith keeps giving me something outside my filters" **Cause:** Your filters matched nothing, so the card widened the search — and it will have told you which step it took. **Fix:** - Read the note on the card; it names the filter it relaxed - Loosen that filter yourself, or turn off *Only ones I have not read* if you have exhausted the pool - Check the availability count in Draw settings before leaving the screen --- ##### Related - **[Intelligence](/docs/intelligence)** — the full guide to Translate, Listen, Ask, slots and standing translations - **[Premium](/docs/premium)** — what unlocks the Intelligence features described here - **[Quran](/docs/quran)** — the same reading stack and Intelligence layer, applied to ayat - **[Collections](/docs/collections)** — where bookmarked narrations go - **[Notes — Qalam](/docs/notes)** — attaching your own writing to a narration - **[Search](/docs/search)** — finding narrations across every collection - **[History](/docs/history)** — what you have read, including every drawn hadith - **[Text Customization](/docs/text-customization)** — typography for every rendering in your stack ### Search (https://alislam.lymrah.com/docs/search) *Find any narration or ayah — by meaning or by reference.* Al Islam features a **custom, Lucene-inspired search engine** built from the ground up using low-level languages and highly optimized for mobile devices. The search engine is completely independent from the app's database and was introduced in version 4.3. It supports both **text-based searching** and **reference-based searching** with intelligent filtering and fast retrieval, even on low-RAM devices. --- ##### Overview The Search section is accessible from the bottom navigation bar. When you tap **Search**, you'll see a **tabbed interface** allowing you to switch between: 1. **New Search** (default) — the custom optimized search engine with text and reference modes 2. **Old Search** — the previous hierarchy-based reference search (still available) You can swipe between tabs to switch modes. --- ##### Architecture ###### Why a Custom Search Engine? Rather than relying on traditional database queries or existing search solutions, Al Islam features a completely custom search engine because: - **Full flexibility and control** — complete ownership of the search implementation - **Mobile optimization** — built from the ground up for phones, including low-RAM devices - **Performance** — highly optimized for fast retrieval across millions of records - **Concurrency** — handles multiple simultaneous searches efficiently - **Data integrity** — never corrupts, even if interrupted during indexing ###### Lucene Inspiration The search engine is **inspired by Apache Lucene** but completely custom-built and optimized for mobile. This means: - Sophisticated ranking and relevance scoring - Support for advanced query syntax - Language-independent indexing - Diacritic-insensitive matching (أَحْمَد, احمد, and Ahmad all match) --- ##### New Search Mode The **New Search** is the primary search mode, combining text-based and reference-based searching with intelligent filtering. ###### The Interface By default, **all filters are pre-selected and intelligently configured**. You don't need to adjust anything to start searching — just type. If you want to narrow your results, you can expand the filters section. ###### Search Methods You can toggle between two search approaches, and **at least one must always remain active**: ###### 1. Text Matching (Default) Search by keywords and phrases across content: - **Hadith** — text, narrator names, chains - **Quran** — verses and translations - **Tafsir** — interpretation text - **Collections** — your saved item titles and descriptions **Examples:** - `mercy` — finds instances across all translations and hadith - `dua protection` — searches for content mentioning both words - `"night prayer"` — exact phrase matching (enclose in quotes) ###### 2. Reference Matching Search by numeric references (Surah and Ayah numbers, Hadith book and chapter numbers, etc.) **Examples:** - `2:255` — Ayat al-Kursi - `1, 3-5` — Surah 1, Ayahs 3–5 - `40` — References to number 40 The engine understands natural patterns, so these variations work: - `Surah 2, Verse 255` - `Ayah 255 from Surah 2` - `2-255` (dash instead of colon) --- ##### Filters ###### Default Configuration All filters are **pre-selected by default** with intelligent configuration. You can adjust them to narrow results. ###### Filter Types ###### Search Method - **Text Matching** — keyword and phrase searching - **Reference Matching** — numeric reference searching At least one must remain active; both cannot be disabled simultaneously. ###### Sources Choose which content categories to search: - **Hadith** — 232,559 narrations across 33 collections - **Quran** — 6,236 verses with 122 translations in 62 languages - **Tafsir** — 95 scholarly interpretations - **Collections** — your personal saved items When you deselect a source, its related filters automatically hide. ###### Scopes (Text Matching Only) Optional toggles for filtering: - **Surah** — limit Quran results to specific surahs - **Parah/Juz** — limit Quran results to specific paras - **Hadith Books** — limit hadith results to specific books When you select a scope, a dropdown appears. By default, all items are pre-selected. ###### Resource Filters (Text Matching Only) - **Language** — search only in specific languages - **Resource Pack** — search within specific translation or tafsir sets All are pre-selected by default. ###### Reference-Specific Filters (Reference Matching Only) When using Reference Matching, you can select: - **Source** — Hadith or Quran - **Scope Chips** — choose what references to interpret (Universal Book Order, Hadith Chapters, Surahs, Paras, Juz, Ruku in Surah, Ruku in Para, etc.) - **Hadith Books** — specific hadith collections - **Sorting** — order results by book, chapter, or other criteria Each scope you select tells the engine to look for your reference in that classification. For example, selecting both "Surah" and "Juz" and entering `40` will find both Surah 40 and verses in the 40th Juz. **Dynamic adjustment:** When you remove sources, their related scopes automatically disappear. Everything works dynamically without misconfiguration. ###### Reset Button A reset button lets you return all filters to recommended defaults. --- ##### Query Syntax & Patterns The search engine supports advanced query syntax for precise searching. ###### Basic Matching - `mercy` — matches "mercy," "merciful," and related words - `prayer time` — matches content with both "prayer" and "time" ###### Exact Phrase Matching Enclose text in double quotes: - `"night prayer"` — matches only this exact phrase - `"Surah Al-Fatiha"` — exact title matching ###### Required & Optional Terms Use `+` and `-` for control: - `+apple juice` — results must contain "apple"; "juice" is optional but boosts the score - `apple -fruit` — matches "apple" but excludes results mentioning "fruit" ###### Wildcards Use `*` for partial word matching: - `mercy*` — matches mercy, merciful, merciless - `*craft` — matches craft, aircraft, witchcraft ###### Diacritic Insensitivity The engine automatically normalizes diacritics: - `Ahmad` = `Aḥmad` = `احمد` = `أحمد` - `Quran` = `Qur'an` = `Qur'ān` = `القران` = `القرآن` --- ##### Search Results ###### Result Presentation Each result displays: - **Title/Reference** — the content identifier - **Language** — which translation or interpretation - **Source** — Hadith, Quran, Tafsir, or Collection - **Resource** — the specific book, pack, or collection - **Content Preview** — a snippet with highlighted keywords - **Text Formatting** — formatted according to your text customization preferences ###### Highlighting Matched keywords are **highlighted in the preview**, showing why the result was returned. ###### Pagination & Performance Results are **paginated** to ensure smooth scrolling and minimal RAM usage, even on low-end devices. The engine dynamically adjusts pagination based on available memory. ###### Navigation Tap any result to navigate directly to that content in its native context: - Tap a hadith → opens the Hadith section at that narration - Tap a Quranic verse → opens the Quran section at that verse - Tap a collection item → opens your Collections --- ##### Indexing & Data Integrity ###### How Indexing Works Every time you download new data or update resources, the search index is **built automatically**. This process is: - **Transactional** — if interrupted, the old index remains valid; nothing is corrupted - **Extremely fast** — even 232,559 hadith are indexed quickly - **Progressive** — you can start searching before indexing completes ###### Index Resilience Even if the app crashes during indexing: - Your existing index remains intact and searchable - New data won't appear in search until indexing completes - Nothing breaks; no manual recovery needed ###### Manual Re-indexing If you suspect search results are missing: 1. Tap the **⋮ (More)** menu in the top-right of the Search screen 2. Select **Re-index Data** 3. A **progress bar** shows real-time indexing progress 4. Once complete, all data is searchable again This process is extremely fast. ###### Data Safety All indexing operations are **transactional**: - Operations complete fully or not at all - The index is always in a valid state - Concurrent operations don't interfere - Data persists after completion --- ##### Performance ###### Speed - **Text search across 232,559 hadith**: milliseconds - **Reference search**: instant - **Result pagination**: smooth, no stuttering - **Keyword highlighting**: real-time ###### Memory Efficiency - **Dynamic RAM allocation** — uses only what's needed, scales with device capability - **Pagination prevents exhaustion** — low-RAM phones can search the entire corpus - **Parallel, concurrent processing** — multiple operations don't accumulate memory overhead ###### Device Compatibility Optimized across all device capabilities: - **Low-RAM devices (1–2GB)** — full functionality with appropriate performance - **Mid-range phones (4–6GB)** — snappy performance - **High-end devices (8GB+)** — instant operations --- ##### Collections Search Your personal Collections are fully searchable. The search engine indexes: - **Collection titles** — folder names and item names - **Item descriptions** — notes you've written - **Saved content** — the actual hadith and verses you bookmarked --- ##### Old Search Mode For structured, hierarchy-based reference searching, the **Old Search** remains available: 1. Select source — Hadith or Quran 2. Select scope — Hadith Chapters, Surahs, Paras, etc. 3. Navigate the hierarchy — the UI shows relevant options 4. Choose language — if multiple translations exist 5. View results — with full context This mode is excellent for explicit, step-by-step reference navigation but doesn't support text searching. --- ##### Switching Between Search Methods When you switch between Text Matching and Reference Matching: - **Configuration is preserved** — your previous settings for each method remain saved - **No configuration loss** — switching back returns you to your exact previous state - **Sources adjust automatically** — related filters update when you change methods --- ##### Tips & Best Practices ###### Effective Searching - **Start broad, then narrow** — search all sources first, then add filters - **Use quotes for exact phrases** — `"dua for protection"` is more precise than `dua protection` - **Combine syntax elements** — `hadith +prayer -fajr` for specific queries - **Trust the defaults** — the default configuration covers most use cases ###### For Hadith Researchers - Use `+narrator +chain` to find specific transmission chains - Switch to Reference Matching if you know the hadith number - Filter by specific Hadith Books to isolate scholarly sources ###### For Quranic Study - Search in multiple languages simultaneously to compare translations - Use Surah and Para scopes to focus on specific sections - Combine text search with reference search — search for `mercy` in `Surah 2` ###### For Collections - Search your Collections to rediscover bookmarked content - Use wildcards — `dua*` finds dua, duas, duaa --- ##### Troubleshooting ###### "Results seem incomplete" **Cause:** Index may be out of sync with latest data. **Fix:** 1. Open the **⋮ (More)** menu in Search 2. Tap **Re-index Data** 3. Wait for the progress bar to complete 4. Search again ###### "Search is slow" **Possible causes:** - Device is low on RAM - Index rebuild is in progress - Searching with very broad scope **Fix:** - Add filters to narrow scope - Close other apps to free RAM - Wait for indexing to complete ###### "A specific result doesn't appear" **Possible causes:** - Search syntax doesn't match the data format - Source or scope is filtered out **Fixes:** - Try without diacritics — the engine normalizes them, but exact formatting matters - Try wildcards — `prayer*` instead of `prayers` - Try exact phrases if searching book titles or proper names - Verify the source and scopes are enabled --- ##### What's New in v4.3 The custom search engine was **introduced in v4.3** as a complete reimplementation. Key improvements over previous search: - **Text search support** — full keyword and phrase searching - **Speed** — millisecond-level results across 232,559 hadith - **RAM optimization** — dynamic allocation for low-end devices - **Concurrent searching** — multiple queries simultaneously - **Query syntax** — wildcards, required/optional terms, exact phrases - **Automatic diacritic normalization** — you don't need to match diacritics exactly The Old Search mode is preserved for users who prefer hierarchy-based navigation. ### Bookmarks & Collections (https://alislam.lymrah.com/docs/collections) *Organise what matters into folders that sync across devices.* Al Islam's **Collections** system is a **complete, file-manager-style organization and bookmarking platform** that lets you save, organize, and annotate Islamic content across unlimited nested folders. It supports markdown notes, batch operations, and optional cloud backup with automatic syncing and conflict resolution. --- ##### Overview Collections is where **you organize your personal Islamic library**. It's a personal space to: - **Bookmark** — save Quranic verses, hadith, tafsir, and any content - **Organize** — create unlimited nested folders and subfolders - **Annotate** — add detailed markdown notes to every item - **Search** — find saved content instantly across all folders - **Backup** — optionally sync to the cloud (encrypted, with premium subscription) Collections is accessed from the bottom navigation bar. --- ##### Philosophy Collections is built on a file-manager-like structure where: 1. **Unlimited nesting** — create folders within folders indefinitely 2. **Flexible organization** — organize according to your personal system 3. **Markdown support** — rich annotations with full markdown capabilities (tables, code blocks, etc.) --- ##### Core Concepts ###### Items An **item** is a saved piece of content: - **Quranic verses** (Ayahs) - **Hadith narrations** - **Tafsir passages** - **Custom notes** Each item has: - **Title** — customizable (default is the content's reference) - **Content** — the actual saved text - **Notes** — markdown-formatted annotations (optional) - **Folder location** — where it's stored - **Metadata** — creation date, last modified date, item type ###### Folders A **folder** is a container for items and other folders: - **Unlimited nesting depth** — create folders within folders indefinitely - **Custom names** — choose meaningful folder names - **Folder descriptions** — markdown-formatted notes for each folder - **Can be empty** — useful as organizational placeholders --- ##### Bookmarking: Saving Content ###### How to Bookmark From **any content view** (Quranic verse, hadith, tafsir), tap the **bookmark icon**. A dialog appears asking where you'd like to save it. **Step 1: Choose Folder Location** A folder browser appears. You can: - Tap a folder to navigate into it - Tap the **+ (Create New Folder)** button to create a folder on the fly - Use the **breadcrumb path** at the top to navigate to a specific location - Search for a folder by name Once you've selected a location, proceed to the next step. **Step 2: Set Title** A dialog prompts you to enter a title. By default, it's pre-filled with the content's reference (e.g., `2:255` for a Quranic verse, or a hadith reference). You can: - **Keep the default** — accept it - **Customize it** — clear and type a meaningful title **Step 3: Add Notes (Optional)** An optional notes field appears supporting **full markdown**: - **Text formatting** — bold, italic, underline, strikethrough - **Lists** — unordered and ordered - **Headings** — h1, h2, h3, etc. - **Code blocks** — with syntax highlighting - **Tables** — markdown table syntax - **Links** — internal and external links - **Quotes** — blockquotes - **Keyboard shortcuts** — Ctrl+B for bold, Ctrl+I for italic, etc. **Step 4: Review & Save** You see a preview showing the title, content snippet, notes preview, and folder location. Tap **Save** to confirm. ###### Saving the Same Item Multiple Times You can **bookmark the same content to multiple folders** or the same folder with different titles and notes: **Example:** 1. Save Ayat al-Kursi (2:255) to "Quranic Verses" with detailed notes 2. Later, save the same verse to "Prayer & Spirituality" with different notes 3. Later, save it again to another folder Each save is **independent** with different titles, different notes, different folders. --- ##### Organizing: Folder Structure ###### Creating Folders **From the Collections main screen:** 1. Tap the **+ (Create Folder)** button 2. Enter a folder name 3. Enter a folder description (markdown-supported, optional) 4. Choose a location — root or inside an existing folder 5. Tap **Create** **While bookmarking content:** 1. During the "Choose Folder" step, tap **+ (Create Folder)** 2. Enter name and description 3. Tap **Create** — the new folder is instantly available ###### Unlimited Nesting You can create folders as deeply as needed, creating hierarchies like: ``` Root ├── Islamic Studies │ ├── Quranic Exegesis │ │ ├── Surah al-Fatiha │ │ └── Surah al-Baqarah │ └── Hadith Studies │ ├── Sihah Sittah │ └── Minor Collections └── Personal Reflections ├── Daily Ayah └── Hadith Reflections ``` There's **no practical limit** to nesting depth. ###### Renaming & Editing Folders To rename or edit a folder: 1. Long-press the folder name (or tap the **⋮ More** menu) 2. Select **Edit** 3. Modify the name or description (markdown supported) 4. Tap **Save** Changes are **instant**. ###### Setting Folder Descriptions Every folder can have a **markdown-formatted description**: - Headings - Lists - Tables - Code blocks - Links - Any markdown formatting These help document your organizational philosophy. --- ##### Managing Items ###### Viewing Items To view a saved item within Collections: 1. Navigate to the folder containing the item 2. Tap the item name 3. The item view opens, showing the title, content, notes, and metadata ###### Editing Item Details To edit an item's title or notes: 1. Open the item 2. Tap **Edit** 3. Modify the title or notes (with full markdown support) 4. Tap **Save** ###### Deleting Items **Single delete:** 1. Open the item 2. Tap **Delete** 3. Confirm **Batch delete:** 1. From the folder view, tap **Select Mode** 2. Check the items you want to delete 3. Tap **Delete** at the bottom 4. Confirm ###### Moving Items **Single move:** 1. Open the item 2. Tap **Move** 3. Select the destination folder 4. Tap **Move** **Batch move:** 1. From the folder view, tap **Select Mode** 2. Check the items you want to move 3. Tap **Move** at the bottom 4. Select destination folder 5. Tap **Confirm** ###### Copying Items **Single copy:** 1. Open the item 2. Tap **Copy** 3. Select the destination folder 4. Choose whether to copy with the same title or a custom title 5. Tap **Copy** **Batch copy:** 1. From the folder view, tap **Select Mode** 2. Check the items you want to copy 3. Tap **Copy** at the bottom 4. Select destination folder 5. Tap **Copy** ###### Renaming Items To rename an item: 1. Open the item 2. Tap **Edit** 3. Change the title 4. Tap **Save** Or from the folder view: 1. Long-press an item 2. Select **Rename** 3. Enter the new title 4. Tap **Save** --- ##### Advanced Organization: Sorting & Custom Ordering ###### Sorting Options From a folder view, tap the **Sort** button to choose: - **Name** — alphabetical order - **Creation date** — newest or oldest first - **Last modified date** — most recently updated first - **Type** — group by content type - **Custom order** — your manual arrangement The sort applies **per-folder** — different folders can have different sort orders. ###### Custom Manual Ordering For maximum control, use **custom order** mode: 1. From a folder view, tap **Sort** → **Custom Order** 2. The view switches to **drag-and-drop mode** 3. Tap and drag items to reorder them 4. Release to drop them in the new position 5. Changes are **saved automatically** The app handles custom ordering **extremely efficiently**, even with millions of items. Reordering is **instant**. --- ##### Search within Collections ###### Collection Search Collections has its own **search system**: 1. From the Collections main view, tap the **Search** icon 2. Enter a search query 3. Results appear instantly, showing: - **Items** matching the query - **Notes** matching the query - **Folder descriptions** matching the query - Full folder path for each result **What it searches:** - Item titles - Item content (the saved text) - Item notes (your markdown annotations) - Folder names - Folder descriptions ###### App-Wide Search Integration You can also search Collections from the main **Search** feature (accessed from bottom navigation): 1. Open **Search** 2. From the "Sources" filter, select **Collections** 3. Enter a search query 4. Results include saved items from your Collections ###### Breadcrumb Navigation At the top of the Collections view, you see a **breadcrumb trail** showing your current location. You can: - **Tap any breadcrumb** to jump directly to that location - **Understand context** — always know where you are in the hierarchy - **Navigate instantly** — jump anywhere in the structure from the breadcrumb --- ##### Metadata & Information ###### Item Metadata Every saved item displays: - **Title** — your custom title - **Content type** — Quranic verse, hadith, tafsir, custom note - **Creation date** — when you bookmarked it - **Last modified date** — when you last edited it - **Folder location** — full path in your Collections - **Item type** — the type of content ###### Folder Metadata Every folder displays: - **Name** — the folder's custom name - **Description** — markdown-formatted folder notes - **Creation date** — when you created the folder - **Last modified date** — when you last edited the folder or its contents --- ##### Batch Operations Collections supports **powerful batch operations** for managing multiple items at once: ###### Select Mode 1. From any folder view, tap **Select Mode** button 2. Items appear with checkboxes 3. Tap checkboxes to select items (tap **Select All** to select all in the current folder) 4. Once you've selected items, action buttons appear at the bottom: - **Delete** — remove all selected items - **Move** — move all to a different folder - **Copy** — copy all to a different folder **Performance:** Batch operations work smoothly, even with thousands of items selected. ###### Recursive Operations Some operations work **recursively** on folders: - **Delete folder** — deletes the folder and all its contents - **Move folder** — moves the folder and all its contents - **Copy folder** — copies the folder and all its contents --- ##### Notes: Markdown Support ###### Markdown Capabilities All notes support full markdown: **Text formatting:** - `**bold**` → bold - `*italic*` → italic - `~~strikethrough~~` → strikethrough - `` `code` `` → monospaced code **Lists:** - Unordered (bullet) lists - Ordered (numbered) lists - Nested lists **Headings:** - `# Heading 1` - `## Heading 2` - `### Heading 3` **Tables:** - Markdown table syntax (pipes and dashes) **Code blocks:** - Multi-line code blocks - Syntax highlighting support **Quotes:** - Blockquotes for emphasis **Links:** - Internal links - External URLs ###### Why Markdown for Islamic Studies? Markdown is perfect for Islamic scholarship because you can: - **Organize references** — use headings to structure arguments - **Compare translations** — use tables to compare Quranic translations side-by-side - **Document chains** — use lists for hadith chain analysis - **Include code** — quote verses and hadith with proper formatting - **Reference internally** — link between your saved items --- ##### Cloud Backup & Sync (Premium Feature) ###### Why Optional Cloud Sync? Collections operates **100% locally by default**. Your library is: - Stored on your device - Never sent to servers without permission - Completely private - Works offline Cloud sync is available **as an optional premium feature** for users who want: - **Cross-device sync** — access Collections on multiple devices - **Automatic backup** — protect against device loss - **Disaster recovery** — restore your library if needed ###### Enabling Cloud Backup 1. Go to **Profile** → **Settings** 2. Tap **Collections** (or **Cloud Sync**) 3. Tap **Enable Cloud Backup** 4. If needed, create an account - Account is **completely optional** if you only use the app locally - Creating an account is **only necessary** if you want cloud backup 5. Once logged in, backup starts automatically ###### Subscription Cloud Backup is a **premium feature** requiring a subscription. The subscription includes: - Cloud storage for your Collections - Cross-device sync - Automatic syncing ###### How Sync Works Once enabled, Collections automatically syncs: 1. **New items** you bookmark are uploaded to the cloud 2. **Edits** to existing items are synchronized 3. **Deletions** are synchronized 4. **Folder structure** changes are synced **Offline operation:** - If you lose internet connection, Collections continues working **locally** - All changes are **queued** and synced automatically when you reconnect - No data is lost ###### Automatic Conflict Resolution If you make changes on **multiple devices simultaneously**, the app **automatically resolves conflicts**: - Changes are merged intelligently - You don't need manual intervention - Everything syncs seamlessly ###### Encryption All data sent to the cloud is **heavily encrypted**: - **In transit** — encrypted connection - **At rest** — encrypted storage Your data is secure throughout the process. --- ##### Manual Sync In the **Profile** section, there's a **Sync button**: - **Automatic syncing** happens in the background - **Manual Sync button** is available for convenience - Tap **Sync Now** to force an immediate sync --- ##### Data Storage ###### Local Storage - **Entire data is saved locally** — all items, folders, notes, and metadata - **No personal data is sent to servers** unless you explicitly enable cloud backup - **Works offline** — all functionality available without internet ###### Cloud Sync (Optional) - Only enabled if you explicitly turn it on - Data is encrypted both in transit and at rest - Automatic syncing keeps devices in sync - Conflicts are resolved automatically --- ##### Performance & Scalability ###### Optimized for Scale Collections is engineered to handle **millions of items** with full performance: - **Pagination** — items load efficiently without lag - **Indexing** — search indexes all items for instant lookup - **Concurrent operations** — multiple operations happen simultaneously - **Highly optimized** — no lag, even with massive libraries **Real-world performance:** - 100,000+ items: Instant folder navigation, instant search - Millions of items: Full functionality maintained - Batch operations: Complete efficiently, even with thousands of items --- ##### Best Practices 1. **Use meaningful folder names** — "Quranic Verses on Mercy" is better than "Folder 1" 2. **Add notes liberally** — use markdown to document your thoughts 3. **Leverage folder descriptions** — document why you created each folder 4. **Sort strategically** — different folders can have different sort orders 5. **Batch operations** — select multiple items to move/delete/copy at once 6. **Search over browsing** — if you have many items, search is faster 7. **Sync before traveling** — ensure latest changes are backed up before going offline 8. **Review old notes** — revisit your annotations periodically for deeper learning --- ##### Troubleshooting ###### "Items aren't syncing" **Possible causes:** 1. Cloud backup not enabled 2. Internet connection dropped 3. Sync is in progress **Fix:** - Enable cloud backup in Settings - Check internet connection - Tap **Sync Now** to force a manual sync ###### "I accidentally deleted an item" **If synced to cloud:** - Items may be in the cloud backup and recoverable **If local only:** - Contact support for recovery options ###### "Conflicts on multiple devices" The app automatically resolves most conflicts. If manual resolution is needed: 1. You'll receive a notification 2. The app shows conflict options 3. You can choose which version to keep 4. The conflict is resolved and synced ### Intelligence (AI Capabilities) (https://alislam.lymrah.com/docs/intelligence) *Connect your own AI models across 35+ supported services. Translate, listen to, and ask questions about any reading.* **Intelligence** is Al Islam's model layer. It is not a chat window bolted onto the side of the app — it sits *underneath* every reading surface, so the app's own content is what the models actually work on: the ayah, the narration, a scholar's translation, a tafsir, your own notes. It runs on **your models, your accounts, your keys**. Al Islam never resells model access, and your keys never leave your device. Introduced in **version 4.5 ("Bayt al-Hikmah")**. Part of [Al Islam Premium](/premium). --- ##### Contents - [The Idea](#the-idea) - [Quick Start](#quick-start) - [Part I — Connecting a Provider](#part-i--connecting-a-provider) - [Part II — What Your Models Can Do](#part-ii--what-your-models-can-do) - [Part III — The Reading Layer](#part-iii--the-reading-layer) - [Part IV — Standing Translations](#part-iv--standing-translations) - [Part V — Your Own Commands](#part-v--your-own-commands) - [Part VI — Dictation](#part-vi--dictation) - [Part VII — Routing](#part-vii--routing) - [Part VIII — The Screens](#part-viii--the-screens) - [Part IX — Engine Settings](#part-ix--engine-settings) - [Part X — Keys, Traffic and Privacy](#part-x--keys-traffic-and-privacy) - [Part XI — What It Costs](#part-xi--what-it-costs) - [Part XII — When Things Fail](#part-xii--when-things-fail) - [Part XIII — Design Principles](#part-xiii--design-principles) - [Part XIV — Limits and Honest Caveats](#part-xiv--limits-and-honest-caveats) - [Frequently Asked Questions](#frequently-asked-questions) - [Glossary](#glossary) --- ##### The Idea Most apps that add AI do one of two things. They open a chat box in a corner, leaving you to copy your content into it. Or they resell somebody else's model at a markup, taking your content through their servers on the way. Intelligence does neither. **The work happens where you are reading.** Open a hadith and the actions are already beneath it. There is nothing to copy, nothing to paste, nothing to navigate away to. The model receives the passage, its reference, and its language — because the app already knows all three. **The account is yours.** You connect providers you already have, using keys you already hold. Whatever your provider charges is between you and them. There is no shared account, no token bundle, no markup, and no metering. That second decision is the more consequential one, and it shapes everything else: | Because the account is yours… | …this follows | | --- | --- | | We never see your traffic | Requests go device → provider, directly. We run no proxy and no relay. | | We cannot be a bottleneck | A model released this morning is usable this morning. | | You are never locked in | Change providers whenever you like, or run several at once. | | You can pay nothing | Several supported options run entirely on your own machine. | | Your bill is legible | It arrives from your provider, itemised by them, for usage you controlled. | The premium subscription unlocks the **suite** — the routing, the reading layer, the library, the studio, the dictation. The **usage** runs on your terms. --- ##### Quick Start Three steps, once. **1. Connect an account.** Pick your provider from the catalogue and paste your key. It is verified on the spot, so a mistyped key is caught immediately rather than the first time you try to read something. **2. Choose what serves what.** Pick a model for translation, for explanations, for speech. One choice is enough to begin — everything else falls back to it. **3. Open any hadith or ayah.** The actions are already there, underneath the text. Nothing else needs configuring. Everything beyond this point is refinement. --- ##### Part I — Connecting a Provider ###### The catalogue — 35 services, 10 protocols Al Islam speaks ten different provider protocols, covering thirty-five services between them. | Group | Services | | --- | --- | | **Major AI labs** | OpenAI · Anthropic · Google AI (Gemini) · Azure OpenAI · Mistral · xAI · DeepSeek · Moonshot · Qwen · Z.ai · Perplexity | | **Arabic-first** | Fanar — built for Arabic and for Islamic material | | **Inference platforms** | Groq · OpenRouter · Together · Cerebras · Fireworks · DeepInfra · Nebius · SambaNova · Novita · Hyperbolic · GitHub Models | | **On your own machine** | Ollama · LM Studio · Jan · llama.cpp · vLLM — keyless, private, running locally | | **Translation services** | DeepL · Google Cloud Translation · Azure Translator · LibreTranslate | | **Voice** | ElevenLabs (speech and transcription) · Deepgram (transcription) | | **Anything else** | A general connection for any OpenAI-compatible gateway, proxy or service not named above | That last row matters more than its size suggests. The general connection means a service that did not exist when this release shipped can still be used today, as can a company proxy, a self-hosted gateway, or a regional provider we have never heard of. ###### What a connection asks for Every service has its own idea of what a connection looks like — a key; a key and a region; a key and an endpoint; a project id; a deployment name; nothing at all. Al Islam builds the right form for whichever service you choose, so **each asks for exactly what it needs and nothing more**. You are never presented with an endpoint field for a service that has a fixed endpoint, or a region selector for a service that has no regions. ###### Instant verification Saving a connection tests it straight away, against the lightest call the service offers. A mistyped key, a wrong region, an endpoint with a typo — all caught at the moment you paste, not the first time you try to read something. ###### As many accounts as you like A personal key and a work key. A fast inexpensive model and a careful expensive one. A cloud service and a local one. Each connection is enabled or disabled on its own, so you can park one without deleting it. ###### Custom headers Every connection accepts custom headers, passed through exactly as written — enough to reach a company proxy, an authenticating gateway, or a service with its own conventions. ###### Local models Five of the supported options — **Ollama, LM Studio, Jan, llama.cpp and vLLM** — run on your own machine. No key, no account, no bill, and no data leaving your network at all. For anyone who wants the capability with none of the exposure, this is the configuration to choose. It is also the only configuration in which Intelligence works fully offline. ###### Masked once saved A key is shown only as a hint (`••••3kfa`) and never displayed again. See [Part X](#part-x--keys-traffic-and-privacy) for the complete account of how credentials are handled. --- ##### Part II — What Your Models Can Do Four capabilities, each routed independently. | Capability | What it gives you | | --- | --- | | **Translation** | Any passage rendered into any language you ask for | | **Text generation** | Explanations, summaries, key lessons, and instructions of your own | | **Speech** | Content read aloud in a natural voice | | **Transcription** | Your own speech turned into text inside the notes editor | Not every service does all four, and the app knows which does what. The catalogue shows each service's capabilities before you connect it, and the routing table only offers a connection for work it can actually perform. --- ##### Part III — The Reading Layer The screens are the smaller half of Intelligence. The larger half appears underneath the content itself. Every reading surface in the app — a hadith, an ayah, a scholar's translation, a tafsir, a translation your own model produced, and the random hadith on the home screen — carries the same row of three actions. ###### Translate One tap renders the passage into the language you choose. - **It looks like a translation.** The result is presented as a scholar-style card, laid out exactly like a published translation — the same typography, the same per-language fonts you have already set in [Text Customization](/docs/text-customization), the same reading experience. A translation reads as a translation regardless of what produced it. - **Translations are kept.** Every one is saved to your Library, attached to the ayah or narration it came from, so you never pay twice for the same passage and never lose one you wanted back. - **Duplicates are recognised.** Asking again for the same passage with the same model returns what you already have. - **Repeats are instant and free**, served from the device rather than the network. - **Changed sources are noticed.** If the underlying text is later updated, the saved translation is marked out of date, with one tap to produce a fresh one. - **Pin the ones that matter** so they stay at the top of your Library. - **Copy or insert.** Take the text out, or drop it straight into a [note](/docs/notes). ###### Translation lanes A lane turns a good combination into a single tap. Save one as *Urdu via DeepL* or *English via Gemini* — a target language, and optionally a specific account and model — then choose it from the reading itself, without ever opening the routing table. Your last choice is remembered, so the common case is one tap from then on. ###### Listen Content is read aloud in a natural voice, and listening reaches everything in the app with words in it — not only the app's own text. - **Readings** — the Arabic, or any translation shown beneath it. - **Answers** — anything a model has written for you, spoken once it is finished rather than half-written. - **Your notes** — a Qalam document is read as continuous prose, so headings, formatting marks, table borders and drawings never reach the voice. - **Voice and speed are yours**, adjustable from the player and remembered between visits. - **Speech can have its own provider.** A specific account and model can serve speech regardless of what serves everything else — useful when one provider has the voice you like and another has the translations you trust. - **One voice at a time**, and it keeps reading when you leave the screen, with the player following you. ###### Ask A conversation about the passage in front of you, appearing **inside the screen you are already reading** — nothing to copy out, nothing to navigate away to. - Threads stream in as they are written. - **Follow-up questions keep their memory**, so a conversation builds instead of restarting. - Answers can be read aloud, copied, or inserted into a note. - Each reading keeps its own thread, so moving between ayat does not mix them up. **The instructions behind Ask are written specifically for Islamic source material:** stay faithful to the text, invent no rulings and no attributions, preserve honorifics, and say plainly when something is uncertain rather than smoothing it over. This reduces a class of failure. It does not eliminate it — see [Part XIV](#part-xiv--limits-and-honest-caveats). ###### The workspace For longer work, the same three abilities open into a fuller surface with **Translate**, **Ask** and **Listen** side by side as independent sections — translate a passage, question it, and hear it without any one of them interrupting another. Where a reading has several versions on screen — the Arabic and its translations, or a narration and its renderings — **each section chooses its own source**. Ask about the Arabic while listening to the Urdu, or translate a scholar's English into a fourth language while the original stays in view. --- ##### Part IV — Standing Translations Beyond one-off actions, a language can be **pinned to stay**. Set a standing translation to Urdu, and every hadith you open arrives with Urdu already beneath it — filled in as you go, laid out as an ordinary part of the page rather than something you had to ask for. - **More than one at a time.** Urdu and English together, or three languages one below another. - **Chainable.** Take a scholar's English rendering and produce Turkish from it, or build a second language out of the first rather than out of the original. - **They report themselves.** If a connection is removed or a model stops answering, the card says so plainly instead of quietly disappearing. - **They know where they belong.** A standing translation built from one book's published translation appears only in that book. One built from the narration itself works everywhere — including the home screen, where the hadith belongs to no particular book at all. - **Reorder, rename and remove** them at any time from the reading itself. - **They work in the Quran too**, filling in as you move from ayah to ayah. --- ##### Part V — Your Own Commands Translation and asking cover most of it. For everything else, you can write **your own instructions** and run them over any passage in the app. A command is a short template with placeholders for the passage, its reference, and a target language: > *Extract the fiqh points as a numbered list.* > *Explain this to a ten-year-old.* > *Give me three lessons and one action for today.* > *Rewrite this translation in plainer English.* Write it once and it appears wherever readings appear. Five are included to begin with — **Summarize**, **Key lessons**, **Explain simply**, **Deep explanation** and **Remaster** — and every one of them is yours to rewrite or delete. Commands and translation lanes are both managed in the **Actions studio**, where you can see what each will do before you run it. --- ##### Part VI — Dictation The [Qalam notes editor](/docs/notes) gains a microphone. Tapping it opens a recorder **inside the editor** — nothing opens over your note, nothing navigates away from it. - **Record, pause, resume**, and stop **when you say so.** It never decides on its own that you have finished speaking. There is no wake-word, no background listening, and no silence detection that starts or stops capture for you. - **A live waveform** driven by your actual microphone level, so you can see that you are being heard. - **A running timer** and an unmistakable state at every stage. - **Import instead of recording** — hand it an audio or video file you already have and transcribe that. - **Transcribe is a deliberate step.** When you take it, the words land **exactly at your cursor**, inside the note you were already writing. - **Language can be stated or left open** for the model to work out. - **Record as many times as you like** into the same note, each take landing where you put it. Dictate a lecture as you listen to it, capture a thought on the move, or write a long note without typing a word of it. The editor also gains **Ask Intelligence** on a selection or on the whole note — question what you have written, or have a passage explained, with the answer available to insert straight back into the page. Devices with no microphone can still transcribe an imported file. --- ##### Part VII — Routing The **Routing** screen decides which connection, model and voice serves each kind of work — and lets you override it for individual areas of the app. - **Read hadith with one model, the Quran with another, your notes with a third.** - **Anything you have not set falls back** to a single global default, so no request is ever left unanswered. - **Model and voice lists are read from your own account** wherever the service supports it, so you see exactly what you are entitled to use — not a hardcoded list that goes stale. - **Any model id can be typed in directly.** A model released this morning is usable this morning, without waiting for an app update. - **Per-capability tuning** — creativity, response length, formality, and the other settings each service genuinely accepts — shown where it applies and hidden where it does not. The design intent is that routing is something you *can* use, not something you *must*. A single global default is a complete configuration. The table exists for the person who wants a cheap fast model summarising and a careful expensive one translating. --- ##### Part VIII — The Screens | Screen | What it holds | | --- | --- | | **Hub** | Your connections at a glance, their health, and a lane for each capability showing what is ready and what still needs a model | | **Provider catalogue** | Every supported service, what it can do, and links to its console and documentation | | **Connection editor** | The form for a single account, validated as you type, with a combined save-and-test | | **Connection detail** | Health, the full model catalogue for that account, which routes it currently serves, its usage history, and removal | | **Routing** | Capability by area — the whole table of what serves what, with connection, model and voice pickers | | **Playground** | Live benches for all four capabilities: translate a phrase, generate a reply, hear a voice, transcribe a file — without touching your own content | | **Activity** | Totals, day-by-day bars, a breakdown per connection, and a log of individual requests with how long each took | | **Engine settings** | Streaming, caching, time limits, retries and privacy | | **Actions studio** | Your own instruction templates and translation lanes | | **Library** | Every translation the app has produced for you — searchable, pinnable, prunable | The **Playground** deserves a note. It exists so you can evaluate a model without spending your own content on the experiment — try a voice before assigning it, compare two models on the same phrase, confirm a new connection works end to end. Nothing you do there touches your readings or your notes. The **Activity** screen exists so the bill is never a surprise. It shows what ran, on which connection, how long it took, and how much was used — before your provider's invoice tells you the same thing a month later. --- ##### Part IX — Engine Settings | Area | What you control | | --- | --- | | **Responses** | Whether answers stream in as they are written, or arrive complete | | **Speed** | Whether repeat translations are served instantly from the device | | **Patience** | How long a single request may take, from five seconds to ten minutes | | **Reliability** | How many times a failed request is tried again before it gives up | | **Privacy** | Whether usage is recorded at all, and whether a short excerpt of what you read is kept beside it | Every one of these has a sensible default. The ten-minute ceiling exists for slow local models on modest hardware; the five-second floor exists for anyone who would rather fail fast than wait. --- ##### Part X — Keys, Traffic and Privacy A system holding your provider credentials owes you a plain account of how it treats them. ###### Your keys - **Keys are encrypted on your device** with a hardware-backed key that cannot be taken off it, held separately from everything else the app stores. - **They are never shown again** after you save them — only a masked hint. - **They never appear in logs, usage records, backups or exports.** This holds on every plan, under every setting, with no exception. - **Removing a connection removes its keys first**, so a connection can never be left behind without a way to clear it — and removal stays available to you at all times. ###### Your traffic - **Traffic goes only where you sent it.** Al Islam's AI connection has **no default destination**; requests reach the providers you configured and nowhere else. - **We operate no proxy and no relay.** Your device contacts your provider directly. We cannot read your prompts, your content, or the responses — not because we promise not to, but because they never travel anywhere we can see them. - **Nothing is sent anywhere until you ask for it**, and when you do, it goes to the provider you chose. ###### Your records - **Usage records hold facts, not content** — which service, which model, how long it took, how much was used. - **An excerpt of what you read is stored only if you switch that on yourself.** It is off by default. - **Caching and usage recording can both be switched off** entirely. ###### Provider messages Some services quote your own credential back inside their error text. Anything of that shape is **stripped before it reaches the screen**, so a provider's carelessness cannot become your exposure. ###### What this does not cover Once your request reaches the provider you chose, **that provider's privacy policy governs it, not ours.** Providers differ significantly in whether they retain submitted data or use it to train models. We strongly encourage reading the policy of any provider before connecting it — and the catalogue links to each service's own documentation for exactly this reason. If you want the capability with none of that exposure, use a [local model](#local-models). Nothing leaves your machine. The complete account of the app's data handling is in the [Privacy Policy](/privacy). --- ##### Part XI — What It Costs **Al Islam Premium** unlocks the Intelligence suite. **Your provider** bills you for the models. We do not resell model access, mark it up, meter it, or take a share. There is no token bundle to buy from us and none to run out of. What that means in practice: - **A local model costs nothing at all.** No key, no account, no bill. - **Translation services** are typically the cheapest paid route for translation specifically, and several have free tiers. - **Inference platforms** often serve open models at a fraction of major-lab pricing. - **Major labs** cost the most and are usually the most capable. - **Repeat translations cost nothing**, because they are served from your device rather than the network. The **Activity** screen shows what you have used so you are never guessing, and every service in the catalogue links to its own console so you can check pricing before you commit. --- ##### Part XII — When Things Fail Model providers fail in ordinary ways — a rate limit, an expired key, a model withdrawn, a network that dropped. Intelligence is built to say which. - **Failures are named, not swallowed.** Each provider's own error type is mapped onto a common vocabulary, so a rate limit reads as a rate limit rather than as a short or empty answer. - **Retries are bounded and configurable**, and only failures that could plausibly succeed on a second attempt are retried. - **Streaming answers are held back until the text stops arriving** where partial output would mislead, so you never read half a sentence as though it were the whole one. - **Standing translations report their own breakage.** If the connection behind one is removed, the card says so rather than quietly vanishing. - **Connection health is visible** on the Hub and on each connection's detail screen, so a key that stopped working is visible before you depend on it. --- ##### Part XIII — Design Principles Five decisions shaped the system, and each has a reason worth stating. **1. Underneath the content, not beside it.** A chat window makes you the integration layer — copying passages out, pasting results back, losing the reference on the way. Putting the actions beneath the reading means the app supplies the passage, its reference, and its language automatically. The model gets better context than you would have pasted, and you do no work. **2. Bring your own key, without exception.** Reselling model access would have been simpler to build and easier to monetise. It would also have meant your content passing through our servers, your costs hidden inside our margin, and your model choice limited to what we had negotiated. Every one of those is worse for you. **3. Presets never cage.** Wherever the app offers a list — models, languages, voices, commands — it also accepts anything you type. A model released this morning works this morning. A language not in the list is still a language. The list is a convenience, never a boundary. **4. Output must look like the app.** A translation is presented as a scholar-style card in your own per-language typography, not as chat output in a bubble. Content produced by your model is content, and it should read like the published translations sitting beside it. **5. Say what happened.** Failures are named. Stale translations are marked. Broken standing translations announce themselves. Usage is visible before the invoice arrives. A system that spends your money and speaks about your religion should never be vague about what it just did. --- ##### Part XIV — Limits and Honest Caveats This section matters more than any other in this document. ###### Models fabricate, and they do it fluently Language models produce confident, well-formed, entirely invented output. In Islamic material this shows up as **invented rulings, invented attributions, and citations that look authentic but are not** — a fabricated chain of narration reads exactly like a real one to anyone who cannot check it. This is a property of the technology. No prompt, no provider, and no app removes it. ###### What Al Islam does about it - The instructions behind **Ask** are written for Islamic source material specifically: stay faithful to the text, invent no rulings and no attributions, preserve honorifics, and state uncertainty plainly rather than smoothing it over. - Model output is always presented **alongside** the authentic sources it came from, never in place of them. - The app carries 232,559 hadith and 122 scholarly translations offline, so the authentic reference is always one tap away. - Translations are attributed to the model that produced them, and saved with that attribution. These measures reduce the failure rate. They do not make output trustworthy on its own. ###### What you must do about it **Verify anything consequential against the authentic sources in the app, or with a qualified scholar.** **AI output is not a religious authority.** It is not a fatwa, not a scholarly verdict, and not a substitute for qualified Islamic scholarship. Treat it as a study aid — a fast first pass, a rough rendering, a prompt for your own thinking — and never as a final word. ###### Other limits worth knowing - **Translation quality varies enormously** between models, languages, and passages. Classical Arabic is harder than modern prose, and a cheap model will show it. - **Speech mispronounces Arabic** to varying degrees depending on the voice and provider. - **Transcription accuracy depends on audio quality**, accent, and background noise. - **Provider availability, pricing and model behaviour are outside our control** and may change without notice. - **Intelligence requires a connection**, unless you are running a model locally. --- ##### Frequently Asked Questions ###### Do I need Intelligence to use Al Islam? No. Every core feature of the app — Quran, Hadith, Prayer Times, Qibla, Hijri Calendar, Tasbeeh, Notes, Search, Collections, History — works exactly as it always has, with no model connected and no subscription. Intelligence adds a layer; it replaces nothing. ###### Why do I need my own API key? So your content never passes through our servers, your costs are never hidden inside our margin, and your choice of model is never limited to what we negotiated. See [The Idea](#the-idea). ###### Can I use it for free? Yes, in two senses. Local models (Ollama, LM Studio, Jan, llama.cpp, vLLM) cost nothing to run and need no key. And several hosted services have free tiers sufficient for occasional use. A premium subscription is still required to unlock the suite itself. ###### Which provider should I choose? For **translation specifically**, a dedicated translation service is usually cheapest and often best. For **explanation and discussion**, a major lab model. For **Arabic and Islamic material**, Fanar is built for it. For **privacy above all**, a local model. For **cost**, an inference platform serving open models. Nothing stops you connecting several and routing each kind of work to the one that suits it. ###### Is my key safe? Keys are encrypted on your device with a hardware-backed key that cannot be taken off it, shown once and then only as a masked hint, and excluded from logs, usage records, backups and exports. Removing a connection removes its keys first. See [Part X](#part-x--keys-traffic-and-privacy). ###### Does Al Islam see what I ask? No. Requests go from your device to your provider directly. We run no proxy and no relay, so there is no point at which your prompts or responses are visible to us. ###### Does my provider see what I ask? Yes — that is who you sent it to. Their privacy policy governs what happens next, and providers differ significantly in whether they retain or train on submitted data. Read theirs before connecting, or use a local model. ###### Can I trust an AI translation of the Quran? Treat it as a study aid, not as a scholarly translation. The app ships 122 published translations by named translators precisely because those are the ones to rely on. An AI rendering is useful for a language no published translation covers, or for a quick sense of a passage — always with the authentic text beside it. ###### What happens to my translations if I cancel premium? They stay. Saved translations, commands, lanes and notes are your content and are not deleted when a subscription ends. Premium features become unavailable; your data remains yours and remains on your device. ###### What happens if I remove a connection? Its keys are removed first, then the connection. Any standing translation or route that depended on it reports itself as broken rather than silently disappearing, so you can reassign it. ###### Can I use a provider that isn't listed? Yes. The general connection accepts any OpenAI-compatible gateway, proxy or service, with custom headers passed through exactly as written. ###### Does it work offline? Only with a local model. Translations already produced are kept on your device and remain readable offline regardless. --- ##### Glossary **BYOK (Bring Your Own Key)** — a model in which the app provides the interface and you provide the provider account. Your credentials, your billing, your choice. **Capability** — one of the four kinds of work: translation, text generation, speech, transcription. **Connection** — one configured provider account. You may have as many as you like. **Lane** — a saved translation combination (a target language, optionally a specific account and model) reachable in one tap from a reading. **Local model** — a model running on your own machine rather than a remote service. No key, no bill, nothing leaving your network. **Protocol** — the API convention a service speaks. Al Islam speaks ten, which is how thirty-five services are supported. **Routing** — the table deciding which connection, model and voice serves each capability in each area of the app. **Standing translation** — a language pinned to appear automatically beneath every reading, rather than requested one passage at a time. --- ##### Related Documentation - [Notes — Qalam](/docs/notes) — the editor Intelligence writes into - [Text Customization](/docs/text-customization) — the typography translations adopt - [Hadith](/docs/hadith-library) and [Quran](/docs/quran) — the reading surfaces the layer sits beneath - [Privacy Policy](/privacy) — the complete account of the app's data handling - [Changelog](/changelog) — what shipped when --- **Questions?** Email support.alislam@lymrah.com, or reach us on [X](https://x.com/AlIslamIO) or [Instagram](https://www.instagram.com/alislamappofficial/). ### Reading History (https://alislam.lymrah.com/docs/history) *Track everything you read, with full control over your privacy.* Al Islam's **History section** tracks all your reading activity across Hadith, Quran, and other content. It provides detailed reading logs, powerful filtering, and a comprehensive **Dashboard** with metrics, statistical data, visual graphs, and reading habit analysis. --- ##### Overview The History section is accessible in two ways: 1. **From the Home Screen** — tap **See All** in the "Recent" section 2. **From Tools Menu** — tap **Tools** in the bottom navigation bar, then select **History** Both paths lead to the same History section with two pages: **History** and **Dashboard**. --- ##### What Gets Tracked History automatically tracks: - **Random Hadiths** — hadith you read from the Random Hadith section - **Specific verses** — Quranic verses you opened or previewed - **Specific hadith** — individual hadith narrations you read - **Content previews** — any content you opened and viewed - **Timestamps** — exact dates and times of each reading All reading activity is **automatically saved** without any manual action required. --- ##### History Page The **History page** displays a detailed log of all your readings. ###### History Listing The main view shows **all readings** you've completed with: - **Content title** — what you read (hadith reference, verse reference, etc.) - **Content snippet** — preview of what was read - **Source section** — which section it came from (Hadith, Quran, Random Hadith, etc.) - **Timestamp** — exact date and time you read it - **Date** — the day you read it ###### Interacting with History Items From each history item, you can: - **Click to reopen** — directly open that content again - **Delete** — remove it from history - **View metadata** — see complete details about the reading ###### Filtering & Searching ###### Source Filter Chips At the top of the History page, below the search bar, you see **filter chips** showing: - **Hadith count** — "Hadith: 52" (example) showing how many hadith readings you have - **Quran count** — "Quran: 47" (example) showing how many Quranic readings - **Random Hadith count** — "Random Hadith: 23" (example) - **Other sources** — counts for any other content types You can: - **Tap a chip** to filter by that source - **Deselect chips** to exclude sources from the view - **See combined totals** or individual source breakdowns ###### Search Filter A **search bar** at the top lets you: - **Search by content title** — find specific verses or hadith - **Search by timestamp** — look for readings from specific times - **Real-time filtering** — results update as you type ###### Time Period Filter Below the search bar, there's a **time duration selector** with: **Quick selection buttons:** - **All** — all history (no time limit) - **Today** — only today's readings - **Yesterday** — only yesterday's readings - **3 Days** — past 3 days - **7 Days** — past week - **30 Days** — past month - **3 Months** — past 3 months - **1 Year** — past year - **2 Years** — past 2 years - **3+ Years** — 3 or more years of history **Custom date range:** - **Calendar button** — select a custom start and end date - **Real-time updates** — all data instantly reflects your chosen time period ###### Sorting The history listing can be sorted: - **By date** — ascending or descending - **Chronological order** — newest first or oldest first ###### Dashboard Reflection When you change the time period filter or search query: - **Dashboard data updates instantly** to reflect your selected time range - All metrics and graphs recalculate for the filtered period --- ##### Dashboard Page The **Dashboard page** displays comprehensive **metrics, statistics, and visual data** about your reading habits. ###### Total Readings Metric - **Total readings** — how many times you've opened and read content - **Reflects selected time period** — changes when you adjust the time filter - **Cumulative count** — total across all sources in the selected timeframe ###### Unique Readings Metric - **Unique readings** — how many different pieces of content you've read - **Distinguishes from total** — if you read the same verse twice, it counts as 1 unique reading - **Reflects time period** — changes with your selected filter ###### Streaks ###### Daily Streak - **Current streak** — how many consecutive days you've read content - **Best streak** — your longest consecutive reading streak to date - **Reflects all-time data** — does not change with time filter (shows your absolute best) ###### Average Metrics ###### Average Readings Per Day - **Average daily readings** — total readings divided by number of days in the selected period - **Shows reading frequency** — how many times per day you typically read ###### Average Unique Readings Per Day - **Average daily unique readings** — unique readings divided by number of days - **Shows content variety** — how many different pieces of content you read daily ###### Section-Specific Metrics For each source (Hadith, Quran, Random Hadith, etc.): - **Readings in that section** — total reads from that source - **Unique readings in that section** — different content from that source - **Section-specific averages** — average reads per day from that source ###### Activity Over Time Graph A **visual graph** showing your reading activity: - **Vertical pillars/columns** — representing reading activity on each day - **X-axis** — dates (specific dates, months, or years depending on zoom level) - **Y-axis** — number of readings - **Interactive zooming** — pinch in/out to zoom in and out - **Time granularity** — shows specific dates when zoomed in, months/years when zoomed out - **Visual clarity** — easy to see reading patterns and trends This graph helps you: - **Identify reading patterns** — see when you read most/least - **Track consistency** — visualize your reading habits over time - **Spot trends** — observe changes in reading frequency ###### Reading by Hour A **time-of-day breakdown** showing: - **Which hours you read most** — breaks down reading activity by time of day (e.g., 6 AM, 12 PM, 9 PM) - **Reading habits by time** — see if you tend to read more in morning, afternoon, or evening - **24-hour coverage** — complete view of your daily reading patterns This metric helps you: - **Understand your reading routine** — when you're most active - **Plan your day** — identify your preferred reading times - **Track changes** — see if your reading habits shift over time ###### Reading by Section A **donut/pie chart** showing: - **Percentage of readings from Quran** — e.g., "40% Quran" - **Percentage of readings from Hadith** — e.g., "35% Hadith" - **Percentage of readings from Random Hadith** — e.g., "25% Random Hadith" - **Other sources** — any additional content types This visualization helps you: - **See reading distribution** — which sources you engage with most - **Balance your study** — identify if you're reading from only one source - **Plan content mix** — decide if you want more variety --- ##### Reading Progress in Collections Beyond the dedicated History section, reading progress is visible throughout the app: ###### In Hadith Books When you view the Hadith section and open Hadith books, you see: - **Reading progress for each book** — how much of each collection you've read - **Progress bars** — visual indicators of completion - **Percentage completion** — how far through each book you are - **Book-by-book metrics** — individual progress for each hadith collection This lets you: - **Track completion** — see how much of each book you've finished - **Plan reading** — know which books need more attention - **Manage multiple collections** — see progress across all your hadith books ###### In Quran Section Similar reading progress is displayed for Quranic content: - **Surah progress** — how much of each surah you've read - **Overall Quran progress** — percentage of all 6,236 verses read - **Visual indicators** — progress bars for each section --- ##### Dashboard Features & Updates ###### Continuous Improvement The Dashboard is **consistently being enhanced** with: - **New metrics** — additional statistical data added regularly - **Improved visualizations** — graphs and charts enhanced with each update - **Better insights** — more meaningful analysis of reading habits You can expect: - **More detailed breakdowns** — finer granularity in metrics - **Additional graphs** — more ways to visualize reading data - **Advanced statistics** — deeper analysis of reading patterns ###### Changelog Reference Check the **Changelog** for: - **Dashboard updates** — new metrics and features - **New statistical data** — newly added analytics - **Visualization improvements** — better graphs and charts --- ##### Use Cases ###### Tracking Reading Consistency - Use **streaks** to maintain a daily reading habit - Monitor **activity over time graph** to see patterns - Use **time period filters** to focus on specific spans (e.g., "Did I read more last month?") ###### Understanding Reading Habits - Check **reading by hour** to identify your preferred reading times - View **reading by section** to see which content you prefer - Analyze **average readings per day** to understand your typical reading frequency ###### Monitoring Progress - Track **total and unique readings** to ensure variety in study - Monitor **section-specific metrics** to balance between Hadith and Quran - Use **Hadith book progress** to plan which books to read next ###### Setting Goals - Use **streaks** as motivation for consistent reading - Set **time period targets** (e.g., "Read 30 unique pieces in 7 days") - Monitor **section balance** (e.g., "Aim for 50% Quran, 50% Hadith") --- ##### Data Persistence - **All history is saved locally** on your device - **Reading activity persists** across app sessions - **Timestamps are recorded** with complete accuracy - **No data loss** even if the app is closed or the device restarts --- ##### Troubleshooting ###### "History seems incomplete" **Possible cause:** Not all readings were tracked in older app versions. **Note:** History tracking has improved with each update. Recent readings should be complete. ###### "Dashboard shows zero metrics" **Possible cause:** No readings recorded in the selected time period. **Fix:** - Check your time period filter — you may have selected a period with no activity - Switch to "All" to see all-time metrics ###### "Streak was reset unexpectedly" **Cause:** A day with no readings breaks the streak. **Note:** Streaks require consecutive days of reading. Any day with zero reads resets the streak. ###### "Time period filter isn't working" **Cause:** Calendar selection may not have saved. **Fix:** - Use the quick selection buttons (Today, 7 Days, 30 Days, etc.) - Or tap the calendar button again to ensure your custom date range is saved ### Prayer Times (https://alislam.lymrah.com/docs/prayer-times) *Accurate prayer timings tuned to your location and method.* The **Prayer Times** section in Al Islam is a complete offline prayer-time calculation system built for daily use, travel planning, date inspection, astronomical understanding, and Hijri synchronization. It is not only a screen that displays Fajr, Dhuhr, Asr, Maghrib, and Isha. It is a full prayer-time environment that connects location profiles, calculation methods, Asr standards, twilight definitions, high-latitude handling, time zones, Hijri dates, solar data, moon data, sky charts, upcoming Islamic dates, and advanced calendar navigation into one organized system. The section already supports **11 globally recognized calculation methods**, multiple Asr standards, high-altitude rules, Hijri date synchronization, location profiles, and fully local/offline calculation with zero server calls after setup. The updated version expands that foundation with new visual and scientific layers: a live sun curve with prayer times placed on the solar path, a twilight ladder, a solar almanac, sun and moon altitude charts, moon phase cards, Hijri almanac cards, crescent visibility forecasting, and a newly integrated Hijri/Gregorian date picker. The purpose of this section is to make Prayer Times both simple and serious. A normal user can open it and immediately see the next prayer time. A more advanced user can inspect why each time occurs, what solar altitude defines it, which twilight band it belongs to, how the moon is moving, what Hijri date applies, and which upcoming Islamic dates are approaching. The interface remains modern, visual, and convenient, but the underlying system is deliberately deep. --- #### Accessing Prayer Times Prayer Times can be accessed from the Home screen by tapping a Prayer Times widget, or from the Tools area by opening the Prayer Times tool. The first-time experience guides the user through location setup, because prayer times depend on the user’s coordinates, country, time zone, calculation method, and local calendar preference. The top of the Prayer Times screen is location-centered. The selected location is displayed clearly, such as **Islamabad, Pakistan**, and the user can manage location profiles, open the date picker, and access additional options from the toolbar. This keeps the section practical: the user always knows which city or coordinates are being used, and they can switch or adjust them when needed. --- #### Location Profiles and Setup Prayer Times is built around location profiles. A profile stores the user’s selected place, time zone, calculation configuration, and related prayer-time preferences. This is useful for users who move between places, travel, or want separate profiles for home, office, university, village, Makkah, Madinah, or another city. When creating a profile, the user can provide location in multiple ways. The recommended method is precise location, which uses GPS and network data to detect the user’s coordinates. The user can also search by location name, city, street, landmark, or address. For advanced users, manual coordinates can be entered directly using latitude and longitude. After the location is selected, the app displays the location details in real time. These include coordinates, country, time zone, and address where available. The profile can then be given a custom label. The app can pre-fill a location-based name, but the user can rename it to something more personal, such as Home, Office, or Travel. The time-zone system is flexible. The app can use the system time zone, the actual coordinate-based time zone, or a custom time zone selected from the world time-zone list. The time-zone selector can show time-zone name, country flag, GMT offset, current time in that zone, and a day/night indicator. It can also be searched by country name, GMT offset, time-zone ID, or country code. This is important because prayer-time planning is often needed for travel, remote locations, or situations where the device time zone and the selected location time zone are not the same. Profiles can be created, switched, edited, and used temporarily. A user can save multiple profiles, instantly switch between them, edit their label or calculation settings, or search a temporary location without saving it. Free users can have a limited number of saved profiles, while Premium users can keep unlimited saved profiles. Temporary searches are not treated as saved profiles, so the user can check many locations without permanently storing them. --- #### Calculation Methods The Prayer Times section supports 11 major calculation methods. This matters because different regions and Islamic authorities use different Fajr and Isha angles, different assumptions for Isha, and different adjustments for local geography. Prayer times are not arbitrary numbers; they are derived from solar position and interpreted through recognized regional and jurisprudential standards. The supported methods include **Muslim World League**, commonly used in Europe and the USA; **Egyptian General Authority of Survey**, used in Egypt and parts of the Arab world; **University of Islamic Sciences, Karachi**, used across Pakistan, India, Bangladesh, and South Asia; **Umm al-Qura University, Makkah**, used in Saudi Arabia and the Gulf region with time-based Isha handling; **Dubai / GAIAE**, tailored for the UAE; **Moon Sighting Committee Worldwide**, which includes seasonal handling for difficult latitudes; **Islamic Society of North America**, used in North America; **Kuwait Ministry of Awqaf**; **Qatar Awqaf**; **MUIS Singapore**; and **Diyanet Turkey**. Each method defines prayer times through specific solar angles or time-based rules. For example, some methods use 18° for Fajr, some use 19.5°, some use 15°, and some use a fixed Isha offset after Maghrib. The app preselects a recommended method based on the user’s location, but the user remains in control and can change the method manually. --- #### Asr Standard, High-Latitude Rules, Rounding, and Shafaq The app supports both major Asr standards. The **Hanafi** standard calculates Asr when the shadow reaches twice the object’s height, usually producing a later Asr time. The **Shafi’i** standard, also used by Maliki and Hanbali practice, calculates Asr when the shadow reaches one object height, usually producing an earlier Asr time. The difference can often be 15 to 45 minutes depending on location and season. High-latitude rules are available for regions where the sun behaves unusually, especially far north or far south. In such places, the sun may not dip low enough for standard Fajr or Isha angles during some parts of the year. The app can apply rules such as no adjustment, middle of night, seventh of night, or twilight-angle handling. It can also preselect a sensible rule based on the latitude. The rounding system controls how calculated prayer times are displayed. The user can show exact times, round to the nearest minute, or round upward. Rounding upward is a cautious default because it avoids displaying a prayer time before the calculated start moment. The Shafaq setting controls the twilight definition used for Isha. It can follow **Ahmar**, the disappearance of red twilight; **Abyad**, the disappearance of white twilight; or a general setting. This gives users a way to align the app with the twilight interpretation they follow. The Hijri date offset allows the Islamic date to be adjusted forward or backward. This is useful because local moon sighting and regional calendars can differ. A user can add or subtract days so that the displayed Hijri date matches their local authority. --- #### Main Times View The main **Times** view remains the practical daily prayer screen. It shows the Islamic and Gregorian dates, the selected time zone, and real-time prayer cards for the day. Each prayer card can show the prayer name, start time, progress status, and countdown. Passed prayers, current prayer windows, and upcoming prayer times are visually distinguished so the user can quickly understand the current state of the day. The app also shows related Sunnah and night times, such as Islamic midnight and the last third of the night. These are important for users who plan Qiyam, du‘a, night worship, or want to understand the structure of the night beyond only the five daily prayers. A detailed view can show the exact times for Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha, Midnight, and the Third of Night. The calculation method, Asr standard, and time zone remain visible as contextual information so the user knows how the displayed times were produced. --- #### Updated Date Switching and Calendar Picker The Prayer Times date-switching system has been upgraded through integration with the new calendar system. Previously, date navigation was more focused on Gregorian date selection. Now the date picker can work more naturally with the new Hijri/Gregorian calendar infrastructure, making it easier to inspect prayer times through either calendar perspective. The picker supports multiple input modes. In calendar mode, the user can select a date visually from a month grid. In wheels mode, the user can scroll day, month, and year fields directly. In type mode, the user can enter the date numerically. The picker can also switch between Hijri and Gregorian selection, so the user is no longer forced to think only in Gregorian dates when searching for prayer times. This is highly useful for Islamic planning. A user may want to check prayer times for **10 Ramadan**, **27 Ramadan**, **9 Dhul-Hijjah**, **10 Muharram**, or another Hijri date. The updated picker makes that flow much more direct. The user can choose a Hijri date, confirm it, and see the corresponding prayer times without manually converting the date elsewhere. The same integrated picker can be reused throughout the app where date selection is needed. This keeps the experience consistent across Prayer Times, Hijri Calendar, Date Converter, and other date-aware sections. --- #### Sun Tab The new **Sun** tab explains the prayer day through the movement of the sun. This is one of the most important upgrades because prayer times are fundamentally connected to solar position. Instead of only showing time values, the app now visually shows how those values sit on the sun’s curve. The first major visual is **“The sun’s day — with your prayers on the curve.”** This chart shows the sun’s altitude across the day, with prayer moments placed directly on the curve. Fajr appears before sunrise in the twilight region. Sunrise appears where the sun reaches the apparent horizon. Dhuhr appears near solar noon, when the sun reaches its highest point. Asr appears on the descending side of the curve. Maghrib appears at sunset. Isha appears later in the evening twilight region. This gives the user an intuitive understanding of why prayer times occur when they do. Fajr and Isha are connected to twilight depression angles. Dhuhr is tied to solar noon. Asr is tied to shadow length and solar altitude. Maghrib is tied to sunset. The chart shows these relationships visually instead of leaving them abstract. The curve also includes bands for night, astronomical twilight, nautical twilight, and civil twilight. These bands explain the sky conditions around the prayer times. The app explicitly communicates that each prayer sits where the sun’s altitude defines it. This makes the Prayer Times section more educational and transparent. --- #### Twilight Ladder The Sun tab also includes a **Twilight ladder — depression angles, live**. This is a precise visual explanation of how twilight levels relate to the horizon and prayer calculation. The ladder shows the apparent horizon and the major twilight bands. The apparent rise/set line is shown around **-0.8°**, reflecting refraction-corrected sunrise and sunset. Civil twilight appears around **-6°**, nautical twilight around **-12°**, and astronomical twilight around **-18°**. The screenshot example shows corresponding times such as apparent rise/set around **05:05 AM / 07:21 PM**, civil twilight around **04:36 AM / 07:49 PM**, nautical twilight around **04:01 AM / 08:24 PM**, and astronomical twilight around **03:23 AM / 09:02 PM**. The ladder also shows the live sun position as a marker, such as around **-2.5°**, allowing the user to see where the sun currently sits relative to the horizon and twilight bands. This is especially valuable because Fajr and Isha are calculated using depression angles. Many users see settings like 18°, 17°, 15°, or 19.5° without understanding what those numbers mean. The twilight ladder makes those angles visible. It explains that Fajr and Isha angles in the calculation settings are depression angles on this exact ladder. It also notes that atmospheric refraction lifts the apparent horizon by about 34 arcminutes, which is why apparent sunrise and sunset use approximately **-0.833°** instead of a simple 0° horizon line. This is a serious documentation-grade addition because it shows the calculation geometry directly inside the app. --- #### Solar Almanac The Sun tab also includes a **Solar Almanac** section. This turns the Prayer Times screen into a compact solar reference for the selected location and date. The Solar Almanac can show **Solar noon**, such as **12:13 PM**, along with the sun’s culmination altitude, such as **78.7°**. Solar noon is the moment when the sun crosses the local meridian and reaches its highest altitude for that day. This is directly relevant to Dhuhr. It can show the **equation of time**, such as **-5.2 minutes**, described as sundial versus clock. This explains the difference between apparent solar time and mean clock time. It is a technical but useful value for understanding why solar noon is not always exactly 12:00 PM. It can show **day length**, such as **14h 16m**, and night length, such as **9h 43m**. This gives users a seasonal sense of how long the day and night are at their location. The almanac includes **solar declination**, such as **+22.34°**, described as the sun’s latitude on the sky. This indicates how far north or south the sun is relative to the celestial equator and explains seasonal changes in day length and solar altitude. It shows **apparent sunrise** and **apparent sunset**, such as **05:05 AM** and **07:21 PM**, marked as refraction-corrected. This is important because the visible sunrise and sunset are affected by atmospheric refraction. It includes **Duha begins**, such as **05:33 AM**, described through the sun being **4.5° above the horizon**. This connects the Duha time to a specific solar altitude rather than only a clock value. It includes **Solar midnight**, such as **12:13 AM**, described as lower culmination. This is the opposite point of solar noon, when the sun is at its lowest below the horizon. It can show **Sun altitude now**, such as **-2.48°**, along with direction such as **60.4° ENE**. It can show the **hour angle now**, such as **-110.15°**, where 0° means the sun is on the meridian. It can show **shadow ratio now**, such as infinity when the sun is below the horizon, because the shadow-length formula is not meaningful when the sun has not risen. The almanac also includes astronomical values such as **right ascension**, **Julian day**, and **sidereal time**. For example, it can show right ascension of the sun, a Julian day value, the Julian century, and local apparent sidereal time. These are advanced astronomical values, but they reinforce that the prayer-time system is using a real astronomy engine rather than shallow static tables. --- #### Sky Tab The new **Sky** tab expands the Prayer Times section beyond the sun alone. It shows the daily movement of both the sun and the moon, making the section feel like a complete sky-aware Islamic time system. The main chart in the Sky tab is **Today’s sky — sun & moon altitude**. This chart shows the altitude of the sun and moon across the day. The sun can be shown as a golden curve and the moon as a separate dashed curve. A vertical marker can show the current time, allowing the user to see where both bodies are right now. This chart is useful because it connects prayer times, moon phases, and sky visibility into one view. The user can see when the sun rises and sets, when it reaches its highest point, when the moon is above the horizon, and how the two paths relate over the day. The Sky tab includes a dedicated moon card. It can show the current moon phase, such as **Last Quarter**, the illumination percentage, such as **37% illuminated**, and the moon age, such as **23.4 days old**. It can also state whether the moon is above the horizon right now. The moon card is visual, not merely textual. It includes a rendered moon phase disc, helping the user understand the lunar state immediately. This is especially relevant in an Islamic app because the Hijri calendar is lunar. Below the moon card, the Sky tab can show moonrise and moonset, such as **Moonrise 12:01 AM** and **Moonset 02:02 PM**. It can show the moon’s current distance from Earth, such as **372,521 km**, with a light-travel equivalent such as **1.2 light-seconds**. It can show the moon’s current position, such as **115.1° ESE**, with altitude such as **+57.5°**. The tab also shows upcoming lunar events, such as the **next new moon** and **next full moon**, with exact dates and times. For example, the next new moon may be shown as **Tuesday, 14 July 2026 at 02:44 PM**, and the next full moon as **Wednesday, 29 July 2026 at 07:36 PM**. This makes the Sky tab useful for users who want to understand not only prayer times, but also the lunar calendar context behind Hijri dates and month transitions. --- #### Hijri Tab Inside Prayer Times The new **Hijri** tab connects Prayer Times directly with the Islamic calendar. This is important because users often open Prayer Times daily, so placing Hijri information inside the same section makes the app more useful without requiring navigation to a separate calendar screen. The Hijri tab begins with a clear Hijri date card. It can show the current date, such as **24 Muharram 1448 AH**, along with progress through the month, such as **Day 24 of 29**, and the month position in the year, such as **month 1 of 12**. A progress line shows how far the current Hijri month has advanced. Below that, the Hijri tab shows **Upcoming Islamic dates**. These are presented as cards with countdowns, Hijri dates, Gregorian dates, and descriptions. For example, the tab can show **White Days** in **18 days**, listed as **13 Safar 1448 · Mon, 27 Jul 2026**, with a note that the date is subject to sighting. The description explains that the White Days are the 13th, 14th, and 15th of every Hijri month and that fasting them is like fasting the whole month. The tab can also show occasions such as **Mawlid an-Nabi ﷺ**, with a countdown such as **47 days**, the Hijri date **12 Rabi’ al-Awwal 1448**, and the Gregorian date **Tuesday, 25 August 2026**. The description can explain that 12 Rabi’ al-Awwal is traditionally associated with the birth date of the Prophet ﷺ. The Hijri tab continues showing future dates, such as White Days in later months, Ramadan-related dates, and major occasions like the **Battle of Badr**. For example, it can show **Battle of Badr** in **230 days**, listed as **17 Ramadan 1448 · Wed, 24 Feb 2027**, with a short description identifying it as the decisive first victory and al-Furqan day. This turns the Prayer Times section into a daily Islamic awareness panel. The user does not only see what prayer is next; they also see where they are in the Hijri month and which important dates are approaching. --- #### Crescent Sighting Forecast The Hijri tab also includes a **Next crescent — sighting forecast** section. This is an advanced lunar-calendar feature that helps users understand the visibility conditions for the next crescent. The forecast is based on the **Yallop test**, specifically referencing the q-test and visibility grading. It evaluates the possibility of naked-eye crescent visibility at the user’s own coordinates. This is important because Hijri month starts can depend on local sighting authority, but visibility prediction can still help users understand what is astronomically likely. The forecast can show the first evening after conjunction. In the screenshot example, the first evening is shown as **Tuesday, 14 July 2026**, with a grade **F**, marked as **Impossible — below the Danjon limit**. The card includes technical values such as best time, moon age, lag, ARCV, ARCL, crescent width, and q value. For example, it can show best time **07:27 PM**, moon age **4.7 h**, lag **17 min**, ARCV **2.8°**, ARCL **4.1°**, width **0.04′**, and q **-0.877**. The second evening can show a better visibility grade. In the example, **Wednesday, 15 July 2026** is graded **A**, described as **Easily visible to the naked eye**. It can show values such as best time **07:46 PM**, moon age **29.0 h**, lag **61 min**, ARCV **10.9°**, ARCL **16.9°**, width **0.71′**, and q **+0.325**. The section can also show the conjunction time, such as **Tuesday, 14 July 2026, 02:44 PM**, and explain that official month starts follow the user’s local sighting authority. This is a careful and responsible design: the app provides scientific visibility forecasting while still acknowledging that official Hijri month decisions may depend on local religious authority. --- #### Almanac Cards and Display Control The updated Prayer Times section includes a richer set of almanac cards, but it also gives users control over what they see. From the additional options menu, users can access almanac/card settings and disable cards they do not want. This is important because not every user wants the same density of information. Some users may only want standard prayer times and a clean daily view. Others may want the full solar almanac, moon data, sky chart, Hijri dates, crescent forecast, and twilight ladder. The app supports both workflows by making advanced cards available but not forcing every user to keep every card visible. This is part of the broader Al Islam design approach: the app can be extremely comprehensive without becoming inconvenient. The advanced systems are there, but the user can choose what belongs in their personal interface. --- #### Offline and Privacy-Oriented Operation The Prayer Times section is designed to work offline after location setup. Prayer calculations, astronomical data, date conversions, and daily prayer-time generation are handled locally. The existing documentation emphasizes that calculations are performed on-device, without requiring internet access or server calls, and that location data does not need to leave the device for daily calculation. This is especially important for an Islamic utility app. Users may rely on Prayer Times every day, including while traveling, in weak-network areas, or in places where privacy matters. Local calculation makes the feature faster, more reliable, and more respectful of user data. --- #### Overall Design Philosophy The updated Prayer Times section should be understood as a complete Islamic time system. It still performs the essential task: showing accurate prayer times for the user’s selected location. But it now goes much further by explaining the astronomical structure behind those times. The **Times** view answers the practical question: *What prayer is next, and when does it start?* The **Sun** view answers the scientific question: *Where is the sun, and how do prayer times sit on the solar curve?* The **Sky** view answers the broader celestial question: *Where are the sun and moon today, and what is the current lunar state?* The **Hijri** view answers the calendar question: *What Islamic date is it, what is coming next, and what does the next crescent visibility look like?* This makes the section modern, useful, educational, and deeply integrated. It gives casual users a clean prayer-time screen, while giving advanced users a real almanac with solar noon, twilight bands, moon phase, crescent visibility, day length, sidereal time, Julian day, and Hijri event forecasting. ### Text Customization (https://alislam.lymrah.com/docs/text-customization) *Tune every detail of the reading experience to your comfort.* Al Islam's **Text Customization** system is a **unified, language-aware interface** that lets you control the appearance of every text element across the entire app. Rather than scattered settings, everything flows through a single customization system where you can adjust **font size, line height, spacing, colors, fonts, and more** with real-time preview and per-language precision. --- ##### Overview Text Customization is **accessible from any content view** in the app: - **Random Hadith view** → tap ⋮ (More) → Customize Text - **Hadith Books listing** → tap ⋮ (More) → Customize Text - **Quranic Ayah view** → tap ⋮ (More) → Customize Text - **Chapter listings** → tap ⋮ (More) → Customize Text - **Any other content view** → tap ⋮ (More) → Customize Text When you tap "Customize Text" from **any screen**, the system **remembers** which section and language you came from, pre-selecting them. You can also **manually select any section and language** from within the customization interface. --- ##### Philosophy Text Customization is built on the principle of **granular, per-language control**. The app recognizes that: 1. **Different scripts have different needs** — Arabic, Urdu, English, and other languages render best with different typography 2. **Different content types need different emphasis** — supporting text should visually differ from main content 3. **Personal preference varies** — customize according to your needs 4. **Language-specific fonts matter** — the best font for one language may not work well for another --- ##### Accessing Text Customization ###### From Any Content View When you're viewing content (Hadith, Quran, Tafsir, etc.), tap the **⋮ (More)** menu in the top-right corner. You'll see the **Customize Text** option. When you do this, the system **automatically pre-selects:** - The **content section** you came from - The **language** you were viewing ###### Section Selection At the top-left, a **dropdown menu** shows available content sections: - **Random Hadith** — customize appearance of the daily hadith widget - **Hadith Books Listing** — customize chapter and book titles - **Hadith Preview** — customize the main hadith text - **Quranic Ayah** — customize Quranic text display - **Quranic Ayah Listing** — customize verse number/reference display - **Tafsir Content** — customize tafsir text and commentary - **Collection Content** — customize your personal collection notes - *(and other content-specific sections)* ###### Language Selection At the top-right, a **dropdown menu** shows available languages. You can customize appearance separately for each language: - **Arabic** (العربية) - **Urdu** (اردو) - **English** - **French** (Français) - **Indonesian** (Bahasa Indonesia) - **Turkish** (Türkçe) - *(+ 56 more languages)* **Why per-language customization?** You might view the Quran in both **Arabic** and **English translations**. You may prefer: - **Arabic text:** Larger font, wider line height - **English text:** Smaller font, standard line height Text Customization lets you set **completely different styles** for each language, applied automatically depending on which you're viewing. --- ##### Real-Time Preview At the top of the customization area, you see a **live preview** of your text content in the selected language and section. As you adjust **any setting below** (font size, color, line height, etc.), the preview **updates in real-time**. --- ##### Typography Controls ###### Font Size Adjust how **large or small** the text appears. **Three ways to adjust:** 1. **Slider** — drag left (smaller) or right (larger) 2. **Numerical input** — tap the number field and type a value 3. **Plus/Minus buttons** — tap `+` to increase, `-` to decrease **Range:** 8pt to 32pt The preview updates in real-time as you adjust. ###### Line Height Controls the **vertical spacing between lines of text**. Higher line height = more breathing room. **Three ways to adjust:** 1. **Slider** — drag to adjust 2. **Numerical input** — tap and type 3. **Plus/Minus buttons** — increase or decrease **Range:** Values adjustable according to your preference Affects readability, especially for scripts with diacritics (Arabic with vowel marks). ###### Letter Spacing Controls the **horizontal space between individual letters**. **Three ways to adjust:** 1. **Slider** — drag to adjust 2. **Numerical input** — tap and type 3. **Plus/Minus buttons** — increase or decrease Can improve readability for certain scripts and font sizes. --- ##### Color Customization ###### Text Color Choose the **primary color** for main content text. **How to select:** You can: - **Enter the hex code directly** — type a color code (e.g., `#1A1A1A`) - **Select from a color wheel** — visual color picker - **Select transparency** — adjust opacity of the color - **Select saturation** — adjust color intensity You'll see a **preview of the color** and the **hex code** as you adjust. ###### Prefix Color Some content has **prefix or supporting text** that should be visually distinguished from the main content. **What is prefix text?** Examples include: - **Hadith chains** — the narration chain before the hadith text - **Supporting text** — metadata or narration context - **References** — Surah names, verse numbers, edition names Prefix color lets you make these visually distinct so they don't compete for attention with the main content. **How to set:** Use the same color customization interface (hex code, color wheel, transparency, saturation) to choose a color that's lighter, less saturated, or more muted than the main text color. --- ##### Font Management ###### Built-In Fonts Tap the **[Font Selection]** button to open the font manager. Al Islam comes pre-loaded with **curated fonts** optimized for each language: **Arabic Fonts:** - Arabic Typesetting - Scheherazade - Cairo - Reem Kufi **Urdu Fonts:** - Jameel Noori Nastaliq - Urdu Typesetting - Noto Nastaliq Urdu **English Fonts:** - Lora - Open Sans - Georgia - Roboto **Multi-Language Fonts:** - Noto Sans - DejaVu Sans Each font shows: - **Font name** - **Live sample text** in that font (in the selected language) - **Tap to select** Tapping any font **instantly applies it**. ###### Importing Custom Fonts You can **import custom fonts** from your device. **How to import:** 1. From the Font Selector, tap the **+ (Plus)** button 2. A file picker appears 3. Select a **TTF (TrueType)** font file 4. A dialog appears for import options **During import:** - **Font File** — automatically filled with your selected file - **Font Title** — give the font a display name for your reference - **Language** — select which language to use for the preview sample text (this is only for preview purposes; you can use the font with any language) **After import:** - The font **instantly appears** in your font list - You can **select it immediately** - It's **saved permanently** and available for all sections and languages ###### Managing Imported Fonts Once imported, you can: - **Rename** — change the font's display name - **Change preview language** — adjust which language the preview displays - **Delete** — remove the font if you no longer need it - **Reorder** — organize fonts in your list --- ##### All Styles Preview Tap the **[All Styles Preview]** button to see how **all content sections look** in your chosen language. **What you see:** A comprehensive view showing every content section side-by-side, displaying: - How each section is configured - How each section looks with your customized fonts and colors - Real-time updates as you make changes **Navigation in All Styles:** 1. **Language selector** — switch to see all styles in a different language 2. **Scroll vertically** — browse through all sections 3. **Real-time updates** — changes you made are reflected instantly This view helps you: - Ensure consistency across sections - Compare how different content types look with the same font - Spot if one section needs adjustment relative to others --- ##### Reset to Default If you've made customizations and want to **start fresh**, tap the **[Reset to Default]** button. **What happens:** - All settings for the **current section and language** revert to Al Islam's recommended defaults - **Other sections and languages are unaffected** - You can redo your customizations immediately if desired --- ##### Customization Scope Text Customization applies to all content views where text is displayed: - **Random Hadith** — the daily hadith widget on home screen - **Hadith Books** — chapter listings and hadith previews - **Quranic Verses** — Quranic text and translations - **Tafsir** — interpretation text and commentary - **Collections** — your saved items and notes - **Any other content view** — wherever text appears --- ##### Tips & Best Practices 1. **Customize per-language** — don't force one style across all languages 2. **Test readability** — ensure your chosen size and line height are comfortable for extended reading 3. **Use prefix colors** — distinguish supporting text from main content for better visual hierarchy 4. **Check All Styles Preview** — see how all sections look together 5. **Import judiciously** — only import fonts you'll actively use 6. **Consider your device** — large, complex fonts may render differently on low-end devices --- ##### What's New in v4.3 Text Customization improvements in v4.3 include: - Faster font switching - Improved color picker interface - Better language detection when entering from content views - Enhanced All Styles Preview rendering - Improved custom font rendering on all devices. ### Languages (https://alislam.lymrah.com/docs/languages) *Knowledge should never be lost in translation.* Al Islam is built to reach across languages. ##### Hadith Available in **Arabic, English, Urdu, Hindi and Bangla**, with more added over time. ##### Content - The **Quran** in **62 languages** — **122 translations** and **95 tafsir** works. - **Hadith** translations across multiple languages. Browse the full [resource catalog](/quran) to see every translation and tafsir. ### Premium (https://alislam.lymrah.com/docs/premium) *Go deeper, distraction-free — and support the mission.* Al Islam is **free at its core**. Every act of reading, every calculation, every tool for daily practice works without paying anything, forever. **Al Islam Premium** is an optional subscription that removes advertising and unlocks the parts of the app built on top of that core — most significantly [Intelligence](/docs/intelligence), the layer that puts your own AI models to work on everything you read. --- ##### Contents - [What Premium unlocks](#what-premium-unlocks) - [What stays free, forever](#what-stays-free-forever) - [Plans and pricing](#plans-and-pricing) - [The free plan's ad contract](#the-free-plans-ad-contract) - [Intelligence and what it costs](#intelligence-and-what-it-costs) - [Managing your subscription](#managing-your-subscription) - [If your subscription lapses](#if-your-subscription-lapses) - [How entitlement works](#how-entitlement-works) - [Frequently asked questions](#frequently-asked-questions) --- ##### What Premium unlocks ###### Intelligence — the headline The whole [Intelligence](/docs/intelligence) suite: translation, listening, asking, standing translations, your own commands, dictation, the routing table, the library, and the actions studio — available on every reading surface in the app. This is the largest single thing Premium adds, and it works on a model worth understanding before you subscribe: **Al Islam does not sell you model access.** The subscription unlocks the suite. The models run on **your own provider account, under your own key, billed by your provider directly to you.** That means there is no token bundle to run out of, no markup on usage, and no metering by us. It also means the running cost is yours to control — and can be **zero**, because several supported providers run locally on your own machine with no key and no bill at all. See [Intelligence and what it costs](#intelligence-and-what-it-costs). ###### No advertising No interstitials. No banners. Nothing between you and what you came to read. The free plan's advertising is capped and predictable rather than aggressive — the details are in [the ad contract](#the-free-plans-ad-contract) below — but Premium removes it completely. ###### Cloud backup for Collections Your [Collections](/docs/collections) — including the notes attached to the items inside them — sync across your devices and survive a reinstall. - Changes sync in real time when you are online - Offline changes queue and sync when you reconnect - Conflicts between devices resolve automatically - Everything travels over encrypted connections, and your records are reachable only by your own account **Be precise about what this covers.** Notes live inside Collections in Al Islam — both notes attached to a saved ayah or narration and standalone note items — so **your notes and their drawings are covered by backup**, together with your account details. Backup does **not** cover tasbeeh records, reading history, prayer or calendar settings, fasting logs, imported fonts, AI keys, or saved AI translations. Those live on your device whether backup is on or off. See the [Privacy Policy](/privacy) for the complete account. ###### Unlimited location profiles The free plan keeps **five** [Prayer Times](/docs/prayer-times) location profiles, which is enough for a home, a workplace, and a few places you travel to. Premium removes the limit entirely — useful if you travel often, or keep profiles for family in other cities. ###### Unlimited typography and display options The free plan allows a generous but finite number of imported fonts and Quran display configurations. Premium removes those ceilings, so every language can have its own imported typeface and every reading surface its own arrangement. See [Text Customization](/docs/text-customization). ###### Early access New collections, new languages, and new features reach Premium subscribers first. --- ##### What stays free, forever This list is the point of the product, so it is worth stating in full. None of the following is ever gated: | Free forever | What you get | | --- | --- | | **[Quran](/docs/quran)** | All 6,236 ayahs, 122 translations across 62 languages, 95 works of tafsir, complete offline | | **[Hadith](/docs/hadith-library)** | 33 collections, 232,559 narrations, full metadata and grading, complete offline | | **[Prayer Times](/docs/prayer-times)** | 11 calculation methods, Sun/Sky/Hijri views, the full almanac, offline calculation, up to 5 location profiles | | **[Qibla Finder](/docs/qibla-finder)** | All five finding methods including AR, plus the scientific view | | **[Hijri Calendar](/docs/calendar)** | The complete calendar, occasions, moon phases, fasting logs, personal events, converter, birthday finder | | **[Tasbeeh](/docs/tasbeeh)** | The counter, the dhikr library, custom adhkar, routines, goals, streaks, statistics | | **[Notes — Qalam](/docs/notes)** | The entire writing system: formatting, drawings, references, honorifics, Arabic support | | **[Search](/docs/search)** | The full offline engine with advanced query syntax across everything | | **[Collections](/docs/collections)** | Unlimited nesting, unlimited items, rich notes — locally | | **[History](/docs/history)** | Complete reading logs, streaks, activity graphs, habit analysis | | **[Home Widgets](/docs/home-widgets)** | Every widget | | **[Text Customization](/docs/text-customization)** | Per-language typography and colour control | Premium adds to this. It never takes anything away from it, and no existing free feature has ever been moved behind the subscription. --- ##### Plans and pricing Premium is an **auto-renewing subscription**, available in two plans: | Plan | Billing | | --- | --- | | **Monthly** | Renews every month | | **Annual** | Renews every twelve months, at a lower effective rate | **Prices are always shown live, in your own currency and market.** Al Islam does not hardcode a price anywhere — every figure you see in the app comes from Google Play for your account and region at the moment you look at it. Where the app shows a comparison between the two plans, that figure is calculated from those live prices rather than quoted from a fixed table. If a price has not loaded yet, the app says so and shows a placeholder rather than a stale number. If it cannot load at all, it says that too. You will never be quoted a figure that is not the one you would actually pay. All billing is handled by **Google Play**. Al Islam never sees, processes, or stores payment details — no card numbers, no billing address, no bank details. --- ##### The free plan's ad contract Advertising funds the free tier. Rather than leave that vague, here is exactly how it behaves. ###### At most five interstitials a day The free plan shows **no more than five full-screen interstitial ads per day.** This is not a guideline or an intention — it is a hard ceiling the app enforces. Some specifics that matter: - **The counter persists.** It is stored per calendar day on your device, so force-quitting the app, restarting your phone, or clearing it from the recents list does not reset it. There is no way for the count to be gamed upward, and adjusting your device clock can only ever reduce the ads you see. - **There is a cooldown.** Even well under the daily ceiling, interstitials are spaced by a minimum interval so you never get two in quick succession. - **The start of a session is protected.** The first couple of screens you move through after opening the app are never interrupted, so the app never greets you with an ad. ###### You are always told where you stand After every interstitial you sit through, the app shows you a short panel stating **which ad of the five that was**, with a segment meter — alongside what Premium would change and the live prices of both plans. This is deliberate. An app that shows you an ad and says nothing is asking you to simply absorb it; an app that tells you it was the second of five, and what the alternative costs, is being straight with you about the deal you are in. ###### Banner advertising Banners appear in a small number of places on the free plan and are removed entirely by Premium. ###### What advertising never touches Ad requests carry **none** of your personal content. Not your notes, not your collections, not your reading history, not your prayer data, not your location, not your AI activity. We do not sell personal data to advertisers, and we do not build advertising profiles from what you read or study. Ad personalization is governed by your Android settings, where you can reset your advertising identifier or opt out of personalized ads at any time. Full detail is in the [Privacy Policy](/privacy). --- ##### Intelligence and what it costs This is the part most worth understanding, because it works differently from almost every other app with AI in it. ###### Two separate things | | What it is | Who bills you | | --- | --- | --- | | **Al Islam Premium** | Unlocks the Intelligence *suite* — the interface, routing, library, studio, dictation | Google Play, on your subscription | | **Your AI provider** | Runs the actual models | Your provider, on your own account | We do not resell model access, mark it up, meter it, or take a share. There is no bundle of credits included with the subscription, and none to exhaust. ###### Why it was built this way Reselling model access would have been simpler to build and easier to monetise. It was rejected because every version of it is worse for you: - Your content would pass through our servers on the way to the model. Under BYOK it does not — requests go from your device to your provider **directly**, with no proxy and no relay of ours in between. - Your costs would be hidden inside our margin instead of itemised by your provider. - Your model choice would be limited to whatever we had negotiated, and a model released this morning would wait for an app update. ###### What it can actually cost you Anywhere from nothing upward, and you control it: - **Nothing at all.** Five supported options — Ollama, LM Studio, Jan, llama.cpp and vLLM — run on your own machine. No key, no account, no bill, and nothing leaving your network. - **Very little.** Dedicated translation services and open-model inference platforms are inexpensive, and several have free tiers sufficient for occasional reading. - **More, if you choose.** Major-lab models cost the most and are usually the most capable. Two things reduce it further regardless of provider: **translations are saved**, so the same passage is never paid for twice, and **repeats are served instantly from your device** rather than the network. The **Activity** screen inside Intelligence shows what you have used — by connection, by day, request by request — so your provider's invoice is never a surprise. --- ##### Managing your subscription ###### Subscribing Open Premium from your Profile or from any locked feature. Both plans are shown with live prices for your market. Purchase completes through Google Play. ###### Cancelling Cancel any time through **Google Play → Subscriptions**. Two things to know: - Cancelling stops **future renewals**. It does not end the period you have already paid for — Premium features stay available until that period expires. - **Uninstalling the app does not cancel anything.** A subscription lives with your Google account, not with the installation. You must cancel through Google Play. ###### Refunds Refunds are governed primarily by Google Play's refund policy, and requests are usually best made directly to Google Play. If Premium was not granted despite a completed payment, contact us at support.alislam@lymrah.com and we will resolve it or support your refund request in full. Statutory rights of withdrawal or refund that apply where you live are unaffected. Full terms are in the [Terms and Conditions](/terms). ###### Price changes If the price of an existing subscription changes, you will be notified in advance in accordance with Google Play's requirements, and you will be able to cancel before it takes effect. A change never applies retroactively to a period you have already paid for. --- ##### If your subscription lapses **Your content is never deleted.** Everything you made while subscribed stays yours and stays on your device: saved translations, your own commands, translation lanes, notes, collections, configurations, connections. Premium features become unavailable; your data does not go anywhere. Concretely, when a subscription ends: - Intelligence features stop running, and the surfaces that use them show as locked rather than disappearing. - Your saved translations remain **readable** in your Library. - Your provider connections remain configured, and **removing a connection stays available to you at all times** — you are never locked out of deleting your own keys. - Collection backup stops syncing. Your local Collections are untouched, and anything already backed up stays on the server until you delete your account. - Location profiles above the free limit are preserved, not deleted — you simply cannot add more until you are back over the line. Resubscribing restores everything exactly as it was. --- ##### How entitlement works Worth a short, plain explanation, because it affects what you should expect. Purchases are **verified with Google Play on our servers**, not trusted from the device. Your subscription status is then carried in your signed session, and the app reads it only from there — there is no local "premium" switch anywhere in the app that could be flipped. Practically, this means: - **You must be signed in** for Premium to apply, and it applies on every device you sign in on. - **Expiry is re-checked continuously**, so a lapsed subscription is recognised without needing a restart. - **Cancellation is picked up automatically** from Google Play. - If your entitlement looks stale, the app refreshes it in the background rather than making you do anything. --- ##### Frequently asked questions ###### Is Al Islam still usable without Premium? Entirely. Every core feature — Quran, Hadith, Prayer Times, Qibla, Hijri Calendar, Tasbeeh, Notes, Search, Collections, History, Widgets, Text Customization — is free and complete. Premium adds Intelligence, removes ads, and lifts a few limits. It does not unlock the app. ###### Do I need Premium *and* an AI subscription? To use Intelligence, yes — Premium unlocks the suite, and a provider account runs the models. But a provider account can cost nothing: local models need no key and no billing at all. See [Intelligence and what it costs](#intelligence-and-what-it-costs). ###### Why doesn't Premium just include the AI usage? Because including it would mean routing your content through our servers, hiding your costs inside our margin, and limiting your model choice to what we negotiated. BYOK avoids all three. It is a deliberate trade: slightly more setup, considerably more control and privacy. ###### Does Premium sync my notes and history? Your **notes**, yes — notes live inside Collections, so backup covers them along with everything else in your Collections. Your **reading history**, no; nor tasbeeh records, calendar data, fasting logs or settings. Those remain on your device. See [Collections](/docs/collections) and the [Privacy Policy](/privacy). ###### What is the difference between the monthly and annual plans? Only billing frequency and effective rate. The features are identical. Live prices for both are shown in the app in your own currency. ###### Can I share Premium with family? Premium follows your Al Islam account and applies on every device you sign in on. Google Play's own family sharing rules govern the purchase itself. ###### Will more features move behind Premium later? No free feature has ever been moved behind the subscription, and we do not intend to start. New capabilities may launch as Premium; existing free ones stay free. ###### How do I see what my AI usage is costing? The **Activity** screen inside [Intelligence](/docs/intelligence) shows totals, day-by-day usage, a breakdown per connection, and a log of individual requests. Your provider's own console is the billing source of truth, and every service in the catalogue links to it. --- ##### Related - [Intelligence](/docs/intelligence) — the suite Premium unlocks, in full - [Collections](/docs/collections) — what cloud backup covers - [Prayer Times](/docs/prayer-times) — location profiles - [Text Customization](/docs/text-customization) — fonts and display options - [Privacy Policy](/privacy) — advertising, data, and what leaves your device - [Terms and Conditions](/terms) — subscription, cancellation and refund terms --- **Questions about billing or your subscription?** Email support.alislam@lymrah.com. ### Qibla Finder (https://alislam.lymrah.com/docs/qibla-finder) *Multi-method Qibla guidance with Compass, Map, AR, Sun verification, scientific insights, saved locations, and extensive customization.* #### Qibla Finder The new **Qibla Finder** is a complete direction-finding system built into Al Islam as part of the Tools section. It is not designed as a simple compass screen that only points in one direction. Instead, it has been built as a full Qibla guidance environment that combines live compass sensors, map-based geographic direction, augmented reality, solar and shadow-based verification, astronomy data, geomagnetic diagnostics, calculation model comparison, and deep user customization. The feature is designed for both normal users and advanced users. A normal user can open the Qibla Finder, select their location, hold the phone flat, and immediately see where the Qibla is. At the same time, a more technical user can inspect the bearing model, magnetic declination, field strength, sensor reliability, Great Circle direction, WGS-84 calculation, Rhumb Line comparison, sun alignment times, moon position, and several other diagnostic values. The goal is to make the experience extremely easy on the surface while keeping a powerful scientific layer available underneath. The Qibla Finder is available from the **Tools** section of the app. Once opened, the user is shown a dedicated Qibla interface with a location selector at the top, followed by the main view tabs: **Compass**, **Map**, **AR**, **Sun**, and **Insights**. These views allow the user to find and verify the Qibla through different independent methods instead of relying on only one source of direction. --- #### Location Integration The Qibla Finder is directly connected with the app’s existing location system used for Prayer Times. This means the tool can use the user’s already saved prayer-time location profiles instead of forcing the user to manually configure a separate Qibla location again. For example, if a user has saved **Islamabad, Pakistan** as their Prayer Times location, the Qibla Finder can use that same location profile automatically. The selected location is displayed clearly at the top of the screen, so the user always knows which location is being used for the Qibla calculation. This also makes the feature consistent with the rest of the app because Prayer Times, location profiles, and Qibla direction are all part of the same location-aware Islamic utility system. Users can select from their saved locations, follow the currently active Prayer Times location, or use location detection depending on their configuration. The customization screen also includes settings such as **Auto-locate on open** and **Follow prayer times location**, giving users control over whether the Qibla tool should automatically start location detection or simply follow the location already selected for prayer calculations. This matters because Qibla direction is not universal across all places. The bearing changes depending on where the user is standing on Earth. A user in Islamabad, London, Jakarta, New York, or Cape Town will each have a different Qibla bearing. By connecting the Qibla Finder with saved location profiles, Al Islam avoids repeated setup and keeps the tool practical for daily use. --- #### Multi-Method Qibla Finding The Qibla Finder is built around multiple methods of finding and verifying the Qibla. The user is not locked into a single compass-based method. Instead, they can move between Compass, Map, AR, Sun, and Insights views. These views can be accessed through the tab layout at the top of the screen, and the interface is designed to be swipeable and easy to move through. This is important because Qibla direction can be affected by different practical issues. A phone compass can be affected by magnetic interference. A flat map can visually mislead users because Earth is spherical. AR can be convenient but still depends on sensors. The sun method can verify direction without relying on magnetic sensors. The Insights section can explain the mathematics and sensor environment behind the result. Because of this, the Qibla Finder does not treat Qibla direction as a single number only. It treats it as a complete direction system that can be calculated, displayed, cross-checked, verified, and customized. --- #### Compass Mode The **Compass** mode is the primary and most immediate way to find the Qibla. It shows a large live compass dial with the current heading, Qibla marker, cardinal directions, degree markings, and visual alignment feedback. The user can hold the device flat and rotate until the Qibla marker aligns correctly. The compass screen shows the Qibla bearing in degrees and direction format. In the example shown from Islamabad, the Qibla direction is around **255.9° WSW**, and the live heading updates in real time as the user rotates the phone. When the phone is correctly aligned, the screen displays a confirmation such as **“Facing the Qibla”**, making it clear that the user is facing the correct direction. The compass is not only a plain needle. It contains multiple live visual elements. It can show the Qibla marker, the current heading, the Sun position, the Moon position, the North marker, East, West, South, degree numbers, tick marks, and direction labels such as NE, NW, SE, and SW. This allows the compass to behave like a detailed physical instrument while still looking modern and clean. The Compass mode also includes a sensor accuracy indicator. The user can see whether the sensor quality is high or whether there may be reliability issues. In the screenshots, the screen shows a **Sensor: High** chip, which tells the user that the phone’s sensor reading is currently considered reliable. This is important because many Qibla apps only show a direction without explaining whether the sensor reading is trustworthy. The screen also displays magnetic declination, such as **2.9° E**. Declination is the difference between magnetic north and true north at the user’s location. Since phone compasses often interact with magnetic readings, declination is important for correcting and understanding the final direction. The Qibla Finder exposes this value to the user instead of hiding it. The compass also warns the user when the phone is not positioned correctly. A tilt warning can appear when the phone is not held flat, because an uneven phone angle can reduce compass reliability. A small bubble-level style indicator can also be shown, helping the user hold the phone in a more accurate position. The screen may also show guidance such as holding the phone flat for an accurate reading. Below the main compass, the tool displays supporting information cards. These can include the **distance to the Kaaba**, the user’s own coordinates, and solar verification information such as **Shadow along the Qibla**. For example, the distance card can show that the Kaaba is approximately **3,520 km** away from the selected location, and it can also describe the journey as a Great Circle fraction of Earth, such as around **8.8% of Earth**. The coordinates card shows the user’s latitude and longitude, such as **33.64218° N, 72.97643° E** for Islamabad. The Compass mode therefore works on two layers. The first layer is simple: rotate your phone until you face the Qibla. The second layer is technical: inspect the heading, accuracy, declination, distance, coordinates, solar verification, and live astronomical markers. --- #### Magnetic Environment and Compass Reliability One of the major strengths of this Qibla Finder is that it does not blindly trust the phone compass. Phone magnetometers can be affected by metal objects, electronics, cases with magnets, speakers, vehicles, furniture, reinforced concrete, and other environmental interference. Because of this, the app includes a full geomagnetic diagnostics layer. The system can show the **expected Earth magnetic field strength** according to the Earth model and compare it with the **measured field strength** from the device. If the measured value deviates too much from the expected value, the app can indicate strong magnetic interference. For example, the screenshot shows a field deviation of around **66–68%**, marked as **Strong interference**. This tells the user that the compass direction may not be reliable in that environment. The app also provides information about the World Magnetic Model environment. It can show values such as magnetic **declination**, magnetic **inclination/dip**, expected field strength, measured field strength, and field deviation. The declination value explains the offset between true north and magnetic north, while the inclination value describes the downward or upward angle of Earth’s magnetic field at the user’s location. A visual declination diagram is also included. It can show **True North**, **Magnetic North**, and the Qibla direction together, helping the user understand why magnetic and true north references may differ. In the example, the magnetic north line is slightly offset from true north by about **2.9° E**, while the Qibla marker appears separately on the dial. This diagnostic layer is very important because it makes the Qibla Finder more transparent. Instead of pretending that every compass reading is perfect, the app shows when the device environment may be interfering with the reading and encourages the user to move away from metal objects or magnetic disturbance. --- #### Map Mode The **Map** mode provides a geographic view of the Qibla direction. Instead of showing only a compass dial, it places the user and the Kaaba on a map and draws the path between them. This mode is especially useful because Qibla direction on a globe can be unintuitive when viewed on a flat map. The shortest path on Earth is not always the line that visually looks most obvious on a flat rectangular map projection. Because Earth is curved, the actual shortest path is a **Great Circle** path. The Map mode displays both the **Great Circle shortest path** and the **Rhumb Line fixed-bearing path**. The Great Circle line represents the shortest path across the surface of Earth. The Rhumb Line represents a constant-bearing path, which can look different because it follows a fixed compass bearing rather than the shortest geodesic route. In the map legend, the Great Circle line and Rhumb Line are visually distinguished, allowing users to understand the difference between them. The map also displays the user’s marker and the Kaaba marker. The user can visually see where they are, where the Kaaba is, and how the Qibla direction is projected across the map. In the example from Islamabad, the map draws the direction from Pakistan toward Makkah, showing both the shortest path and the fixed-bearing comparison. Below the map, the app shows the **initial bearing** and distance. The initial bearing can be shown as approximately **255.9° WSW** using the Great Circle model. The distance card shows the Great Circle distance, such as **3,520 km**, and can also compare it with the Rhumb distance, such as around **3,531 km**. This mode helps users who want visual geographical confirmation instead of relying purely on a rotating compass. It also makes the difference between mathematical direction models easier to understand. --- #### AR Mode The **AR** mode gives users an augmented reality way to find the Qibla. Instead of looking only at a compass interface, the user can point the phone camera in the real world and see Qibla guidance overlaid on top of the camera view. The AR interface displays a live bearing readout, such as the current direction and the Qibla target direction. It can show a marker on the screen when the user is aligned with the Qibla, and it can display a confirmation such as **Facing the Qibla** when alignment is achieved. A bearing ruler can appear across the AR horizon. This gives the user a graduated compass scale while looking through the camera, allowing them to understand how far they are from the Qibla direction. The AR marker helps the user visually turn toward the correct direction in the physical environment. This mode is helpful in practical real-life situations. For example, a user may be standing in a room, office, mosque, hotel, airport, or outdoor place and may want to visually identify the wall, corner, or object that aligns with the Qibla. AR mode provides that real-world reference. The AR system also includes customization options. The user can enable or disable the bearing ruler and adjust the AR marker size. The Insights section can also show camera-axis heading diagnostics, including values related to the AR frame, elevation, and heading. Because AR still depends on device sensors, the feature benefits from the same sensor diagnostics and magnetic interference checks used elsewhere in the Qibla Finder. This keeps the AR experience more transparent and reliable. --- #### Sun Mode The **Sun** mode is one of the most advanced parts of the Qibla Finder. It provides a sensor-free way to verify the Qibla using solar position and shadows. This is important because compass readings can be affected by magnetic interference, but the sun and shadow method can provide a physical verification method independent of the phone’s magnetometer. The Sun mode shows what is happening in the sky right now. It displays the current position of the Sun and Moon using azimuth and altitude. For example, it can show the Sun as being below the horizon with a certain azimuth, while also showing the Moon’s direction, illumination percentage, and age. In the screenshot, the Moon is shown in the **Last Quarter** phase with illumination and age information. The screen also includes a sky altitude chart for the day. This chart shows the Sun’s path and the Moon’s path across time, with altitude plotted over the day. It can indicate the current moment, the Sun’s movement, the Moon’s movement, and special Qibla-related solar crossing points. This allows the user to see not just where the Sun is right now, but how it moves throughout the day relative to the Qibla direction. The Sun mode includes **solar Qibla times**. These are exact times when the sun or shadow can be used to verify the Qibla. One type is **Shadow along the Qibla**. At this time, if the user places a vertical stick on flat ground or hangs a weighted string, the shadow will lie along the Qibla line. The app can show a time such as **06:52 AM** and explain that the user can follow the shadow to verify the Qibla direction. Another type is **Sun over the Qibla**. At this time, facing the sun directly means the user is facing the Qibla, and the user’s shadow points directly away from it. In the screenshot, this appears as a time such as **02:19 PM**, with a note explaining that the user can face the sun at that exact time to face the Qibla. The Sun mode also includes **Global Kaaba sun events**. These events refer to moments when the sun is directly over the Kaaba, or aligned in such a way that users around the world can use the sun as a direct Qibla reference, if the sun is above their horizon at that moment. The screen can show upcoming events such as “Sun directly over the Kaaba” in a certain number of days, with exact date and time entries. The tool explains how the shadow method works. The user can plant a stick vertically on flat ground or hang a weighted string. At the listed time, the sun stands exactly on the Qibla azimuth or exactly opposite it, so the stick’s shadow lies precisely along the Qibla line. This gives the user a classical, sensor-free method that is immune to magnetic interference and can be accurate to a very fine degree when performed carefully. This mode makes the Qibla Finder much stronger than a normal compass tool because it provides an independent verification method. Even if the user’s phone sensors are unreliable, the Sun mode can help confirm the direction physically. --- #### Moon and Sky Information The Qibla Finder also includes Moon and sky-related information. The compass can show the Moon marker on the dial, and the Sun mode can show the Moon’s azimuth, altitude, phase, illumination, and age. The sky chart can optionally include the Moon’s arc alongside the Sun’s path. The Moon phase disc is not treated as a simple decorative emoji. It is described as a physically rendered lunar terminator, meaning the visual representation reflects the illuminated and shadowed portions of the Moon more realistically. Users can enable or disable the Moon phase disc in customization. This astronomy layer gives the Qibla Finder a richer scientific context. It helps users understand the sky above them, the relative position of the Sun and Moon, and how these bodies relate to Qibla verification methods. --- #### Insights Mode The **Insights** mode provides a deep technical explanation of the Qibla calculation and the user’s geographic relationship to the Kaaba. This mode is designed for users who want to see the calculations, models, distances, geometry, magnetic environment, and sensor details behind the main Qibla direction. At the top, the Insights view can show a 3D-style Earth globe. This globe visualizes Earth from above the path’s midpoint and shows the Great Circle arc from the user’s location to the Kaaba. It can also display the live day/night terminator, showing which side of Earth is currently in daylight and which side is in night. This makes the Qibla direction feel connected to actual Earth geometry rather than only a flat compass number. The Position section shows the selected user location, the user coordinates, the Kaaba coordinates, and the journey midpoint. For example, it can show the user location as Islamabad, Pakistan, the user coordinates as approximately **33.64218° N, 72.97643° E**, and the Kaaba coordinates as approximately **21.42252° N, 39.82618° E**. It can also show the midpoint between the user and the Kaaba. The bearing calculation section compares different models. The active model can be **Great Circle**, and the app can also show **Ellipsoidal / WGS-84** and **Rhumb Line** bearings. This is important because these models are not mathematically identical. Great Circle gives the shortest path on a spherical model, WGS-84 accounts for Earth’s ellipsoidal shape, and Rhumb Line gives a constant-bearing path. In the screenshot, Great Circle and WGS-84 appear very close, while the Rhumb Line value differs more significantly. The Insights mode can also show an **Adhan library cross-check**, allowing the app’s Qibla result to be compared against another calculation reference. It can show **model spread**, which tells the user how much the different calculation models differ from each other. It can show the selected magnetic bearing as well, especially when Magnetic North is being used. A bearing comparison ruler can visually place the different calculation models on one sub-degree scale. This helps users see how close or far apart the Great Circle, WGS-84, Rhumb Line, and other references are. Instead of showing isolated numbers only, the app visually explains the spread. The Journey section explains the path from the user to the Kaaba. It can show the **initial bearing** and **final bearing**, such as a transition from around **256.0°** to **240.3°**, because a Great Circle path does not maintain the same compass bearing throughout the entire journey. It can show the **bearing drift along the path**, such as around **15.8°**. It can show distances according to different models: Great Circle distance, WGS-84 ellipsoidal distance, and Rhumb Line distance. It can also show the distance as a fraction of Earth’s girth, such as around **8.79%**. The Journey section also includes educational comparisons. It can estimate how long a non-stop flight would take at a sample speed, such as **900 km/h**. It can estimate how long walking would take at a sample pace, such as **5 km/h for 8 hours per day**. It can even show how long light would take to travel the distance, such as around **11.8 ms**. These values are not needed for basic Qibla finding, but they make the feature informative and distinctive. The Insights mode also includes the user’s **antipode**, which is the point on the opposite side of Earth from the user. It also explains the special case of the Kaaba’s own antipode. From the Kaaba’s exact antipode in the South Pacific, every direction on Earth is mathematically a Qibla direction, making the bearing undefined. This is a subtle but important mathematical detail, and including it shows that the system handles edge cases conceptually rather than only basic use cases. --- #### Sensor Fusion and Device Heading The Qibla Finder can use sensor fusion to improve the heading experience. The sensor section can show the fusion source, such as a fused rotation vector using **gyroscope + accelerometer + magnetometer**. This means the app is not only reading a raw compass value; it can combine multiple device sensors to produce smoother and more useful orientation data. The sensor section can show the reported accuracy, live heading relative to True North, and camera-axis heading for AR mode. For example, the Insights screen can display a live heading value and a camera-axis heading value with elevation. These values help explain what the device is currently reporting internally. This is especially useful for debugging or advanced use. If the compass seems wrong, the user can inspect whether the sensor accuracy is high, whether there is magnetic interference, whether the field strength is abnormal, and whether the heading source is being fused from the expected sensors. --- #### Qibla Customization The Qibla Finder includes a dedicated **Qibla Customization** screen. This screen is a major part of the feature because it allows the user to control calculation behavior, compass behavior, visual design, AR display, scientific visuals, and default content. The customization system makes the Qibla Finder flexible for different kinds of users. A simple user may want a clean compass with minimal extra information. A technical user may want every scientific overlay enabled. Another user may prefer magnetic north instead of true north, miles instead of kilometers, or a specific dial style. The customization screen allows the same tool to serve all of those preferences. --- #### Calculation Customization The Calculation section controls how the Qibla direction is computed and displayed. The **Bearing method** setting allows users to choose between **Great Circle**, **Ellipsoidal / WGS-84**, and **Rhumb Line**. Great Circle is the shortest path over Earth’s surface. Ellipsoidal / WGS-84 uses a more geodetically precise Earth model. Rhumb Line keeps a constant compass bearing, which is useful for comparison but may differ from the shortest route. Giving users access to these models makes the feature transparent and technically strong. The **North reference** setting allows users to choose between **True North** and **Magnetic North**. True North refers to geographic north, while Magnetic North refers to the direction indicated by Earth’s magnetic field at the user’s location. Since the difference between them varies by location, the app also calculates and displays declination. The **Manual declination override** lets the user replace the World Magnetic Model declination value. This is useful for advanced cases where a user wants to manually correct or test a declination value. The app normally uses the Earth model, but the override gives the user manual control. The **Heading offset / sun-check** setting allows calibration of the heading using a slider. This can be used when the user has verified the Qibla through the sun or another reliable method and wants to apply a small offset correction to the live heading. The **Coordinate format** setting allows users to choose how latitude and longitude are displayed. Supported formats include decimal degrees, degrees-minutes-seconds, and degrees with decimal minutes. This is helpful because different users, maps, and GPS tools use different coordinate formats. The **Distance unit** setting allows the user to display distances in kilometers, miles, or nautical miles. This affects distance cards and journey-related values. The **Bearing decimal places** setting controls how precise bearing values appear. Users can display fewer decimals for a cleaner interface or more decimals for a more technical presentation. --- #### Compass Behaviour Customization The Compass Behaviour section controls how the compass moves, feels, and responds. The **Needle smoothing** setting controls how quickly or smoothly the needle reacts to sensor changes. Options include instant, fast, balanced, and smooth. Instant movement gives the fastest response but may feel jumpy. Smooth movement reduces jitter but may react more slowly. Balanced provides a middle ground. The **Alignment window** setting controls how close the user must be to the Qibla direction before the app considers them aligned. For example, a setting such as **±5°** means the user can be within five degrees of the target direction and still receive alignment confirmation. The **Haptic feedback** setting allows the user to choose feedback strength, including off, light, medium, and strong. This gives physical feedback while aligning with the Qibla. The **Haptic detents** option adds a tactile tick on every 30 degrees, like a machined compass bezel. This makes rotation feel more physical and instrument-like. The **Keep screen on** option keeps the display awake while the Qibla screen is open. This is useful because users may spend time adjusting direction, checking the map, using AR, or waiting for a solar alignment moment. The **Tilt warning** option warns the user when the phone is not flat. This helps prevent inaccurate readings caused by poor device posture. The **Bubble level** option shows a miniature spirit-level style indicator near the compass. This helps the user physically hold the phone in a better position for compass accuracy. --- #### Appearance Customization The Appearance section controls the visual style of the Qibla compass. The **Dial skin** setting lets the user choose between styles such as **Classic**, **Minimal**, **Ornate**, and **Night**. This changes the look of the compass dial and allows the user to choose between a detailed traditional feel, a cleaner minimal interface, a more decorative style, or a darker night-focused design. The **Dial motion** setting controls how the compass behaves visually. The dial can rotate like a physical compass where the world turns around the user, or the dial can stay fixed while the needle moves. This is important because users have different expectations from compass apps; some prefer a rotating dial, while others prefer a fixed dial with a moving pointer. The **Needle style** setting controls the visual representation of the Qibla needle or marker. In the screenshot, the selected style is a Kaaba marker, which makes the Qibla direction visually distinct and thematically appropriate. The **Tick density** setting controls how many tick marks appear on the compass dial. Low density makes the dial cleaner, medium gives a balanced amount of detail, and high density makes it more instrument-like. The **Cardinal letters** toggle controls whether direction labels such as N, NE, E, S, W, and related labels appear on the dial. The **Degree numbers** toggle controls whether numeric degree markings appear on the dial. The **Sun & moon on the dial** toggle controls whether live ephemeris markers for the Sun and Moon appear on the compass rim. The **Dial size** slider allows the user to change the compass size, such as making it larger or smaller depending on their screen preference. The **Needle color** setting allows the user to choose the visual color of the needle or marker. The screenshot shows multiple color choices, including teal, yellow, green, red, blue, white, and an automatic/default style. --- #### AR Mode Customization The AR mode has its own customization controls. The **Bearing ruler** toggle enables or disables the graduated compass scale along the AR horizon. When enabled, the user can see a horizontal bearing scale in the camera view, making it easier to line up with the Qibla direction. The **AR marker size** slider controls the size of the Qibla marker shown in AR mode. This allows users to make the marker more visible or less intrusive depending on their camera view and preference. These settings are important because AR can feel crowded if too much information appears on screen. The user can decide how much guidance they want. --- #### Scientific Visual Customization The Scientific Visuals section controls the advanced educational and diagnostic visuals. The **Earth globe** toggle controls the 3D-style globe visualization that shows the Great Circle arc and live day/night terminator. The **Sky path chart** toggle controls the Sun and Moon altitude chart shown in Sun mode. The **Moon arc on sky chart** toggle controls whether the lunar path is drawn alongside the solar path. The **Moon phase disc** toggle controls the physically rendered lunar phase display. The **Field strength gauge** toggle controls the magnetometer field-strength visual, comparing measured field strength against the Earth model band. The **Bearing comparison ruler** toggle controls the visual ruler that places calculation models such as Great Circle, WGS-84, and Rhumb Line on a shared scale. The **Declination rose** toggle controls the true north versus magnetic north visualization with the declination correction wedge. These visual toggles are valuable because not every user wants advanced scientific overlays visible all the time. The customization system allows them to keep the interface clean or enable deeper diagnostics as needed. --- #### Screen and Content Customization The Screen & Content section controls what the Qibla Finder shows when opened and which cards or chips appear in the interface. The **Default view on open** setting allows the user to choose whether the Qibla Finder should open directly to Compass, Map, AR, Sun, or Insights. This is useful because different users may prefer different workflows. A normal user may want Compass by default. A traveler may prefer Map. A technical user may prefer Insights. A user who trusts solar verification may prefer Sun. The **Auto-locate on open** toggle controls whether the app should start a GPS/location fix automatically when the Qibla screen opens. The **Follow prayer times location** toggle controls whether the Qibla Finder should track the location selected for Prayer Times. This keeps Qibla and Prayer Times connected through the same location profile. The **Distance card** toggle controls whether the distance-to-Kaaba card appears. The **Coordinates card** toggle controls whether the user coordinate card appears. The **Declination chip** toggle controls whether magnetic declination is shown near the compass. The **Sensor accuracy chip** toggle controls whether the sensor reliability chip appears. The **Solar alignment card** toggle controls whether solar verification information, such as shadow alignment time, appears in the main compass interface. Finally, the **Reset all to defaults** button allows the user to restore the full Qibla Finder configuration back to the default state. --- #### Overall Design Philosophy The Qibla Finder has been designed as a complete system rather than a single screen. It combines religious utility with geographic calculation, sensor transparency, astronomy, and careful UI customization. The feature is intentionally layered. The first layer is simple and user-friendly: open the tool, select location, follow the compass or AR marker, and face the Qibla. The second layer provides verification: map paths, sun and shadow times, sensor accuracy, and magnetic environment checks. The third layer provides scientific insight: Great Circle geometry, WGS-84 comparison, Rhumb Line drift, Earth globe visualization, Moon and Sun ephemeris, field strength diagnostics, and calculation-model comparison. This makes the Qibla Finder suitable for daily use, travel, education, verification, and advanced inspection. It respects the fact that Qibla direction should be easy to find, but it also acknowledges that compass readings can be affected by real-world limitations. By combining multiple methods, the feature gives users several ways to confirm the direction with greater confidence. ### Hijri Calender (https://alislam.lymrah.com/docs/calendar) *Complete Hijri calendar with moon phases, Islamic occasions, fasting logs, personal events, reminders, and date conversion.* The new **Hijri Calendar** in Al Islam is a complete Islamic calendar system designed to make Hijri dates, Islamic occasions, fasting days, moon phases, personal events, date conversion, and calendar customization available in one deeply integrated place. It is not a simple month grid that only shows dates. It is built as a full calendar environment where the user can understand the current Islamic date, see what is coming next, browse months and years, inspect individual days, log fasts, create personal Hijri or Gregorian events, convert dates, find Hijri birthdays, and customize how the entire calendar behaves. The feature is designed with the same philosophy as the rest of Al Islam: it keeps the surface experience clean, visual, and convenient, while still providing advanced controls and detailed information for users who want more precision. A normal user can open the Hijri Calendar and immediately see today’s Hijri date, the current month, the moon phase, and upcoming Islamic occasions. A more advanced user can change the calendar calculation method, adjust sighting offsets, change week layout, control companion dates, enable or disable fasting lenses, export fasting history, or use the date converter for exact Hijri-Gregorian conversion. The Hijri Calendar is available inside the app as a dedicated Islamic time and calendar feature. It can also be surfaced from the Home section, making the current Hijri date and upcoming Islamic occasions accessible without forcing the user to manually search for them. This makes it useful both as a daily reference and as a deeper planning tool. --- #### Current Hijri Day Overview When the user opens the Hijri Calendar, the first thing they see is a rich current-day view. This top card presents the current Hijri date in a way that is easy to read and visually meaningful. Instead of only showing a number, the app shows the day, Hijri month, Hijri year, Arabic month name, corresponding Gregorian date, weekday, and contextual labels. For example, the screen can show **Muharram 1448 AH**, with the Arabic name of the month underneath and the Gregorian range beside it, such as **Jun – Jul 2026**. The selected day card can show that the user is on **Thursday, 24 Muharram 1448 AH**, corresponding to **9 July 2026**. The date is shown prominently, while the Hijri month and Arabic name are displayed alongside it so the user can recognize both the numeric date and the Islamic month identity. The current-day card also includes contextual Islamic information. If the current month is one of the sacred months, the card can show a **sacred month** label. This gives the calendar religious context instead of treating all months as visually identical. The card can also show the current progress through the month, such as **day 24 of 29**, using a progress bar and a day counter. This helps the user understand how far the current Hijri month has advanced and how close the next month is. The card also includes a live moon phase display. The moon phase is shown visually as a moon disc, along with the phase name and illumination percentage. For example, it can show a **Waning crescent** with **33% lit**. This makes the calendar feel connected to the lunar nature of the Hijri system. The user does not only see dates; they also see the actual lunar phase associated with the date. The same overview area can also show the next important Islamic occasion. For example, it may show that **Mawlid an-Nabi ﷺ** is coming in **47 days**, or that the **White Days** are coming in a certain number of days. This gives users immediate awareness of upcoming religious dates without needing to manually inspect each month. --- #### Upcoming Occasion Strip Below the main current-day card, the Hijri Calendar includes an upcoming occasion strip. This strip presents important upcoming days as cards that the user can horizontally browse. The cards can show occasions such as **White Days**, **Mawlid an-Nabi ﷺ**, and other Islamic dates, each with its remaining countdown and date. These cards are designed to be fast to read. They show the occasion name, its Hijri date, its Gregorian date, and how many days remain. For example, a card may show **White Days** with **13 Safar · 27 Jul 2026**, and a countdown such as **in 18 days**. Another card may show **Mawlid an-Nabi ﷺ**, its date, and a countdown such as **in 47 days**. This makes the calendar much more useful than a static grid. The user does not need to scan multiple months to know what is coming. The app surfaces upcoming occasions directly under the header, keeping the next important dates visible and convenient. --- #### Main Month Calendar Grid The main calendar grid is the core month view of the Hijri Calendar. It displays the selected Hijri month as a full calendar layout, with weekday headers and date cells. The grid supports normal calendar interaction, but each date cell is enriched with Islamic, Gregorian, fasting, event, and moon-related information. Each date cell can show the main date number and a smaller companion date. Depending on the user’s settings, the main date can be Hijri-first or Gregorian-first. For example, when the grid follows the Hijri calendar, the main number represents the Hijri day, while the smaller number can show the corresponding Gregorian day. This is important because users often need both systems together. A Hijri date may be religiously meaningful, while the Gregorian date may be needed for daily planning. The calendar grid also visually distinguishes special days. Fridays can be highlighted so that Jumu’ah is easier to notice across the month. Today can be marked with a distinct outline or breathing highlight. Selected dates can be shown with a clear selection state. Days outside the current month can be dimmed so that previous-month and next-month spillover dates do not visually compete with the active month. The grid also supports small indicators and dots inside date cells. These dots are used to show different categories of information, such as Islamic occasions, fasting-related days, personal events, moon phases, or logged fasts. Different colors and markers help users understand that a date contains something meaningful without opening it first. A day can contain a sacred or important occasion, a fasting recommendation, a logged fast, a moon phase marker, or a personal event. This turns the calendar grid into an information map rather than a plain date table. The user can swipe between months naturally. This makes month-to-month browsing fast and convenient. They can move through Muharram, Safar, Rabi’ al-Awwal, Ramadan, Dhul-Hijjah, and other months with normal gesture navigation, while the header, cards, and event indicators update accordingly. --- #### Selected Day Details When the user selects a date, the calendar can show detailed information about that day. The selected day panel displays the weekday, Hijri date, Gregorian date, moon phase, occasion information, and available actions. For example, selecting **12 Rabi’ al-Awwal 1448 AH** can show the Gregorian date **25 August 2026**, a moon phase disc with illumination percentage, a countdown such as **in 47 days**, the Arabic month name, and the occasion **Mawlid an-Nabi ﷺ** with a short description. The selected-day panel can explain that the date is traditionally associated with the birth date of the Prophet ﷺ. The selected-day panel also includes action buttons. A user can add or open an event, log a fast, share the date or occasion, or copy the information. This makes each date practical. The calendar is not only for viewing information; it allows the user to interact with the day and preserve or share it. The **Log fast** action is especially important. When the user logs a fast for a date, the calendar can visually mark that date with a checkmark or indicator. This makes fasting history visible directly on the calendar. Users can track which days they fasted, see patterns, and maintain a record of voluntary or obligatory fasts depending on the date. The selected-day system is also connected with moon information. When the user changes the selected date, the moon phase and illumination can update accordingly. This means the day panel becomes a small lunar and Islamic date dashboard for that specific day. --- #### Year Overview The Hijri Calendar includes a year overview mode. Instead of only viewing one month at a time, the user can see the full Hijri year as a set of month cards. Each month appears as its own compact visual grid. For example, the year overview can show **1448 AH** with all twelve Hijri months: **Muharram**, **Safar**, **Rabi’ al-Awwal**, **Rabi’ al-Thani**, **Jumada al-Awwal**, **Jumada al-Thani**, **Rajab**, **Sha’ban**, **Ramadan**, **Shawwal**, **Dhul-Qa’dah**, and **Dhul-Hijjah**. Each card can show whether the month has 29 or 30 days, how many events it contains, and a compact dot-map of the month. This is a powerful planning view. The user can see at a glance which months contain more occasions. Ramadan and Dhul-Hijjah, for example, can visually show more event markers than quieter months. A month card can show event counts such as **29 days · 6 events**, **30 days · 3 events**, or **30 days · 15 events** depending on the month. The year overview also supports quick navigation. Tapping a month can take the user directly into that month’s calendar. The user can also move between years using navigation controls. This gives the calendar both a close-up daily mode and a broad annual planning mode. --- #### Jump to Month and Year The Hijri Calendar includes a dedicated **Jump to** system for fast navigation. This is useful when the user does not want to swipe month by month through many years. The Jump dialog allows the user to select a Hijri year and month directly. The year can be changed through a swipeable or typeable year selector, and the month can be selected from month chips. For example, the dialog can show **Rabi’ al-Awwal 1448 AH · Aug – Sep 2026**, with the year selector focused on **1448** and month chips such as **Safar**, **Rabi’ al-Awwal**, and **Rabi’ al-Thani**. The user can also use a **Today** button inside the dialog. If they have moved far away from the current date while browsing, the Today action immediately returns them to the current Hijri date. This is a small but very important convenience feature because calendar browsing can easily take users far away from the present month. The Jump system makes the calendar suitable for both casual daily use and long-range planning. Users can quickly move to Ramadan, Dhul-Hijjah, a future Hijri year, or a specific month without friction. --- #### Events and Occasions The Hijri Calendar includes a dedicated **Events & Occasions** section. This section collects Islamic occasions, personal events, fasting logs, reminders, and upcoming dates into one organized place. At the top, the section can show fasting statistics. For example, it can show how many fasts were logged **this month**, in the **last 30 days**, and **all time**. This gives users an immediate summary of their fasting activity. Depending on the app’s tracking model, this area can also support long-term fasting history and progress-style insights. The Events & Occasions section includes filters such as **All**, **Occasions**, and **Personal**. This allows users to separate built-in Islamic occasions from their own custom events. The search field allows users to search events, occasions, and notes. This is important because once a user has many personal events and Islamic dates, browsing manually becomes inefficient. Events are grouped by time, such as **This Month**, **Next Few Months**, and **Later This Year**. This makes the list readable and planning-focused. The user can immediately see nearby occasions first, then future dates later. Each event row can show an icon, event name, Hijri date, Gregorian date, and countdown badge. Built-in occasions can include important Islamic dates such as White Days, Ramadan-related dates, Eid-related dates, Arafah, Ashura, Rajab begins, and other significant calendar moments. The exact set can be controlled through the Islamic occasions lens in customization. --- #### Personal Events Users can create their own personal events inside the Hijri Calendar. This turns the feature into a personal Islamic calendar, not just a static list of built-in dates. When creating a new event, the user can enter an event title. The title field is flexible and can be used for Hijri birthdays, anniversaries, personal reminders, vows, family dates, study milestones, religious goals, or any other date-based note. The placeholder itself suggests use cases such as **a Hijri birthday, a nadhr, an anniversary**, and similar personal occasions. The event can be visually customized. Users can select an emoji or icon for the event. The interface can show common choices such as a star, cake, ring, mosque, tasbih, hands, money bag, airplane, and other icons. The app also supports any emoji from the user’s keyboard, so the event style is not limited to the built-in choices. The user can also choose a color. The screen includes quick color choices such as yellow, teal, green, orange, blue, purple, white, and other options, as well as a full color wheel/palette. This allows personal events to be visually distinct on the calendar grid and event list. Personal events can be based on either a **Hijri date** or a **Gregorian date**. This is essential because some personal events are Islamic-date based, while others are Gregorian-date based. For example, a Hijri birthday should recur on the Hijri date and move through the Gregorian seasons, while a civil anniversary may be tied to the Gregorian calendar. The event editor allows the user to choose the date system and keep the conversion synced. The event date can be selected with a beautiful integrated picker. The user can open the calendar picker, use wheels, or type the date manually. The selected date displays its corresponding date in the other calendar system, so the user can immediately see how the Hijri and Gregorian dates relate. Events can repeat every year. For Hijri-based events, repeating every year means the event recurs on the same Hijri date, moving through the Gregorian seasons the way Ramadan does. This explanation is shown directly in the UI so the user understands the behavior. Users can also make events one-time events when repetition is not needed. Personal events can include reminders. Reminder options can include off, on the day, one day before, three days before, or one week before. These reminders are designed to be surfaced through the daily digest system, so important personal dates are not forgotten. The event editor also includes Markdown notes. Users can write optional notes with Markdown support, including bold text, lists, links, and other formatting. A write/preview toggle allows users to compose the note and preview it. This is useful for storing context, duas, intentions, family details, or personal meaning attached to an event. Personal events can be managed over time. They can be edited, shared, copied, archived, or deleted depending on the event workflow. This gives users control over their personal calendar data rather than treating events as fixed entries. --- #### Fasting Logs Fasting support is built directly into the Hijri Calendar. Users can log fasts on specific dates, and those logs become visible throughout the calendar and events system. When a fast is logged, the date can show a checkmark or marker on the calendar grid. The Events & Occasions section can count fasts for this month, the last 30 days, and all time. This allows the user to maintain a practical fasting history without needing a separate tracker. The fasting lens also helps interpret dates. It can highlight Sunnah fasting days, obligatory days, forbidden days, and logged days. For example, White Days can appear as upcoming fasting opportunities. Monday and Thursday fasting nudges can also be supported when enabled. The app can show a fasting nudge such as **“Tomorrow is Monday — sunnah fast?”** so the calendar becomes proactive rather than passive. This makes the Hijri Calendar useful for worship planning. It does not merely show that a date exists; it helps the user recognize meaningful fasting opportunities and keep a personal record. --- #### Date Converter The Hijri Calendar system includes a dedicated **Date Converter**. This converter allows users to convert between Hijri and Gregorian dates using large, smooth, visual date wheels. The Date Converter shows the Hijri date on one side and the Gregorian date on the other side. When the user changes the Hijri date, the Gregorian date updates immediately. When the user changes the Gregorian date, the Hijri date updates immediately. This real-time synchronization makes conversion feel natural and interactive. For example, the converter can show **24 Muharram 1448 AH ⇄ 9 July 2026**. The Hijri side can show day, month, and year wheels, while the Gregorian side shows day, month, and year wheels. A swap button allows the user to reverse or focus the conversion direction. The result card below the wheels shows the converted date clearly, including weekday, Hijri date, Gregorian date, Arabic month name, and moon phase disc. It can also show whether the date is today, how many days ago it was, or how many days remain. For example, a past date can show **12331 days ago**, while a future date can show a remaining countdown. The result card also includes actions such as **Today**, **Open in calendar**, **Copy**, and **Share**. This makes the converter practical. The user can convert a date, jump directly to it in the calendar, copy it, or share it without extra steps. --- #### Hijri Birthday Finder The Date Converter also includes a **Hijri Birthday Finder**. This is a highly useful feature because many people know their Gregorian birth date but do not know the Hijri date of birth or when their next Hijri birthday will occur. The user sets the Gregorian side to their date of birth. The app then calculates the corresponding Hijri date of birth and shows age information in both Hijri and Gregorian terms. For example, it can show the Hijri date of birth, age in Hijri years, age in Gregorian years, and the next Hijri birthday date with a countdown. This is valuable because Hijri years are shorter than Gregorian years, so a person’s Hijri age can differ from their Gregorian age. The app makes that difference visible and understandable. The birthday finder can show information such as the Hijri date of birth, **Age in Hijri years**, **Age in Gregorian years**, and **Next Hijri birthday** with the Gregorian date and countdown. This turns the Date Converter into a personal Islamic date utility, not only a generic conversion tool. --- #### Integrated Hijri/Gregorian Date Picker The Hijri Calendar includes an integrated date picker that can be reused across the app. This picker supports both Hijri and Gregorian dates and is designed to be more flexible than a simple Android date picker. The picker can open in calendar mode, wheels mode, or type mode. In **Calendar** mode, the user can tap a date visually from a month grid. In **Wheels** mode, the user can scroll day, month, and year wheels. In **Type** mode, the user can directly enter numeric day, month, and year values. The picker can switch between Hijri and Gregorian mode using a toggle button. This means the same dialog can be used when the user wants to select a Hijri date or a Gregorian date. The selected date shows both systems, so the user remains aware of the conversion. This picker is not limited to the calendar screen. It can be integrated throughout Al Islam wherever date selection is needed. For example, it can be used in Prayer Times date switching and other date-based tools. This keeps the app consistent: users learn one powerful date picker and can use it everywhere. The picker also includes a Today button, month navigation, clear selection feedback, and confirmation/cancel actions. This makes it fast, modern, and convenient while still being precise. --- #### Calendar Customization The Hijri Calendar includes a full **Calendar Customization** screen. This is one of the most important parts of the feature because Hijri date handling can vary by calculation method, sighting adjustment, regional expectation, and user preference. The customization system gives users control without making the main calendar screen complicated. The settings are grouped into logical sections, including calculation, layout, lenses, cards and surfaces, behavior, daily digest, data management, and reset controls. This keeps the customization screen comprehensive but still understandable. --- #### Calendar Calculation Settings The Calculation settings control how Hijri dates are determined. The **reckoning method** setting allows the user to choose the Hijri calendar calculation model. Supported methods can include Islamic Civil, Umm al-Qura, Islamic tabular/TBLA-style calculation, and astronomical-cycle based methods. This is important because different regions and use cases may rely on different Hijri calendar conventions. Some users may prefer a civil calculated calendar, while others may prefer Umm al-Qura or another supported reckoning method. The calendar also supports **sighting adjustment** or date offset. This allows the user to adjust the Hijri date when local moon sighting differs from the calculated date. The current date can update in real time as the user changes the adjustment, making it clear how the offset affects the calendar. This matters because Hijri calendars are lunar and may differ by region or sighting authority. The app’s customization allows users to align the calendar with their local context instead of being locked into a single global assumption. --- #### Calendar Layout Settings The layout settings control how the calendar grid is presented. The **grid follows** setting allows the user to choose whether the calendar grid is Hijri-first or Gregorian-first. In Hijri-first mode, Hijri dates are the primary calendar dates and Gregorian dates appear as companion dates. In Gregorian-first mode, Gregorian dates can be primary while Hijri dates appear as companions. This flexibility is important because some users may use the Hijri calendar as their main religious calendar, while others may want Gregorian planning with Hijri context. The **week starts at** setting allows the user to choose the first day of the week. All seven days can be supported. This is important because different regions and users expect calendars to start on Saturday, Sunday, Monday, or another day. The **Hijri numerals** setting allows users to choose between Western numerals and Eastern Arabic numerals. This gives users control over how dates are displayed linguistically and visually. The **density** setting allows users to choose between layouts such as cozy, compact, and spacious. Compact layouts fit more information on screen, while spacious layouts improve readability. Cozy provides a balanced experience. The **grid size** slider allows the user to adjust how large the date cells appear. This is useful across different phone sizes and user preferences. The **companion dates** toggle controls whether the other calendar’s date appears inside each cell. For example, in Hijri-first mode, the Gregorian date can appear smaller inside each Hijri date cell. The **dim outside days** toggle controls whether previous-month and next-month spillover dates are faded. This makes the active month easier to read. The **Highlight Jumu’ah** toggle controls whether Fridays are visually emphasized. This makes weekly Islamic rhythm visible directly in the calendar. --- #### Calendar Lenses The Hijri Calendar includes “lenses,” which are visual information layers that can be enabled or disabled. This is a strong design choice because it lets users decide which types of information matter to them. The **Islamic occasions** lens controls whether built-in Islamic occasions appear on the calendar. This includes dates such as Ramadan, the Eids, Arafah, Ashura, the White Days, and other significant occasions. The **Personal events** lens controls whether the user’s own events appear on the calendar. Users who want a clean religious calendar can hide personal events, while users who want a full personal calendar can keep them visible. The **Fasting lens** controls fasting-related visual information. It can show Sunnah and obligatory days, flag forbidden days, and include the user’s own fast logs. This makes fasting opportunities and fasting history visible directly in the calendar grid. The **Moon phases** lens controls whether moon phase badges appear on the grid and in the day panel. This keeps the lunar nature of the Hijri calendar visible. --- #### Cards and Surfaces The Cards & Surfaces settings control the major visual sections around the calendar. The **Today card** toggle controls whether the main current-day card is shown. This card includes both Hijri and Gregorian dates, the live moon phase, and the next occasion. The **Upcoming strip** toggle controls whether countdown cards appear under the header. This strip shows upcoming Islamic occasions and fasting days. The **Occasions to look ahead** setting controls how many upcoming occasions are displayed. This is handled with a slider, such as showing 8 upcoming items. Users who want a compact calendar can reduce this number, while users who plan further ahead can increase it. The **Fasting nudge** toggle controls whether the app can show helpful fasting prompts, such as a reminder that tomorrow is Monday and may be a Sunnah fasting opportunity. These controls keep the calendar adaptable. The user can make it simple and minimal or more proactive and information-rich. --- #### Behaviour Settings The Behavior section controls how the calendar feels during use. The **Pulse on today** setting shows a soft breathing ring on the current day. This makes today easier to notice without using harsh visual styling. The **Haptic month ticks** setting provides a tactile tick as each month page settles. This gives month navigation a polished physical feel and makes swiping between months more satisfying. These small interaction details matter because they make the calendar feel modern and carefully built rather than static. --- #### Daily Digest The Hijri Calendar includes a **Morning digest** option. This is designed as a single notification that can summarize today’s occasions, due reminders, and fasting nudges. The morning digest is disabled by default, which is important because notifications should not be forced on the user. When enabled, it can help users stay aware of Islamic dates, personal event reminders, and fasting opportunities without needing to manually open the calendar every morning. This makes the feature proactive while still respecting user control. --- #### Data Export and Import The Hijri Calendar includes data management for personal calendar information. Users can export and import their **events and fast log** as a JSON file. Exporting allows users to back up personal events and fasting history. Importing allows users to restore or move that data. The import system is designed carefully: imports land as new entries, and existing entries are not overwritten. This reduces the risk of accidental data loss. This is important because personal events and fasting logs can become meaningful long-term records. A user may build years of fasting history or personal Hijri events, so the app provides backup support rather than keeping that information trapped without recovery. The customization screen also includes a **Reset all to defaults** option, allowing the user to restore calendar settings back to their default state. --- #### Overall Design Philosophy The Hijri Calendar is built as a complete Islamic time system. It brings together the daily Hijri date, Gregorian correspondence, moon phase, Islamic occasions, fasting days, personal events, date conversion, Hijri birthday calculation, reusable date picking, and deep customization. The strongest part of the feature is that it remains convenient despite its depth. The user is not forced to understand calculation methods, event lenses, moon phases, or date offsets just to use it. They can simply open the calendar and see today’s Islamic date. But when they need more, the system is already there: year overview, jump dialog, events, personal reminders, fasting logs, date conversion, birthday finder, picker modes, data backup, and extensive customization. This makes the Hijri Calendar useful for daily religious awareness, Ramadan and Dhul-Hijjah planning, Sunnah fasting, family event tracking, Hijri birthdays, Islamic occasion reminders, and long-term personal record keeping. It is modern, visual, highly configurable, and deeply integrated into the app rather than being a separate lightweight add-on. ### Tasbeeh Counter (https://alislam.lymrah.com/docs/tasbeeh) *Powerful dhikr tracker with custom adhkar, routines, goals, streaks, statistics, focus mode, and personalization.* The new **Tasbeeh Counter** is a complete dhikr counting system built into Al Islam as part of the Tools section. It is designed for users who want a beautiful, focused, reliable, and deeply customizable way to perform dhikr, track progress, maintain streaks, review statistics, build personal adhkar, and preserve their dhikr history over time. This feature is not only a simple tap counter. It is a full Tasbeeh environment with a live counter, pinned adhkar, swipeable dhikr switching, progress rings, session tracking, undo and redo, quick-add controls, goals, streaks, statistics, a searchable dhikr library, custom dhikr creation, routines support, templates, reminders, haptics, sound feedback, gesture controls, accessibility-friendly layout options, data import/export, and extensive personalization. The goal of the Tasbeeh feature is to make dhikr feel easy and natural while still giving users serious control. A user can open the tool and immediately start tapping. At the same time, they can also build their own dhikr library, configure every counter behavior, track long-term history, compare daily progress, and customize how the screen looks and feels. --- #### Main Tasbeeh Screen The main Tasbeeh screen is the primary counting interface. At the top, the user sees a horizontal quick switcher containing pinned or recent adhkar. Each dhikr chip shows an emoji or icon, the dhikr name, and the current count for that dhikr. For example, the screen can show **SubhanAllah**, **Alhamdulillah**, and **Allahu Akbar** as quick-access items. The selected dhikr is highlighted so the user always knows which dhikr they are currently counting. When the user switches to another dhikr, the whole counter updates accordingly. The Arabic text, transliteration, translation, virtue text, target count, current progress, streak, daily count, seven-day count, and session values all change based on the selected dhikr. This makes the counter feel like a structured dhikr workspace rather than a single generic counter. The selected dhikr is shown prominently in the center area. For example, **سُبْحَانَ ٱللَّٰه**, **SubhanAllah**, and its meaning **Glory be to Allah** can be displayed together. Under that, the screen can show the virtue or reward text associated with the dhikr, such as the narration about glorifying Allah after every prayer. This allows the user to remember not only the phrase, but also its meaning and spiritual context. Below the dhikr text, the screen can show meter chips such as the current streak, today’s count, and seven-day total. For example, it can show a **1 day streak**, **Today 5**, and **7d 607** for the active dhikr. These small meters help the user stay aware of consistency without making the screen feel complicated. The central counter uses a large progress ring. The current count is shown in the middle, with the target shown underneath. For example, the screen can show **5 of 33** while the circular progress ring fills around the counter. This gives the user an immediate visual sense of how close they are to completing the current lap or target. The whole counter face can be tapped to count, depending on the user’s settings. This makes the experience convenient because the user does not need to tap a tiny button. The counter can behave like a digital tasbeeh bead: every tap increases the count, updates the ring, triggers optional feedback, and records the session. --- #### Counting Controls The Tasbeeh screen includes direct counting controls for both careful counting and fast progress entry. The user can count one by one through normal tapping, but the interface also provides quick-add chips such as **+10**, **+33**, and **+100**. These are useful when a user wants to add a known amount quickly, correct a missed session, or continue after counting physically outside the app. The screen also includes **Undo**, **Redo**, and **Reset** actions. Undo allows the user to reverse an accidental tap or quick-add operation. Redo restores a previously undone action. Reset clears the current live count when the user wants to restart the active lap or session. The reset action can also be protected through customization with a confirmation setting, preventing accidental loss of the current count. The counter can show live session information under the controls. This can include the current session duration, the number of counts in the session, and pacing information. For example, the screen can show a session running for a few seconds with a certain number of counts. This makes the tool useful not only for total counting, but also for understanding the current dhikr session. A daily goal bar can appear near the bottom of the screen. For example, it can show progress such as **56 / 300 today**. This lets the user see how much of the daily target has been completed across the day. The goal bar gives a broader daily context beyond the current lap target. --- #### Swipeable Dhikr Switching The Tasbeeh interface is designed for quick movement between adhkar. Users can switch dhikr through the top quick switcher, and the feature also supports swipe-based switching when enabled. A horizontal swipe on the counter face can move through the dhikr library, allowing the user to go from one dhikr to another without leaving the counting screen. This is especially useful for post-prayer adhkar or repeated routines where the user may move through **SubhanAllah**, **Alhamdulillah**, **Allahu Akbar**, and other phrases in sequence. Instead of returning to a list every time, the user can stay inside the counting flow and move naturally between items. The interface keeps this convenient while still remaining clear. The selected dhikr is always displayed with its own title, text, target, progress, and statistics, so the user does not lose context while swiping. --- #### Focus Mode The Tasbeeh screen includes a focus option, represented by the eye icon. When the user activates this mode, distracting or secondary interface elements can be hidden so the counting experience becomes cleaner and more intentional. This is useful when the user wants to avoid accidentally tapping library, statistics, or settings controls while doing dhikr. It also helps when the user wants a more meditative screen with only the counter and essential dhikr information visible. The feature respects both types of usage: a full information-rich mode for setup and review, and a cleaner focus mode for actual counting. --- #### Built-in Adhkar The Tasbeeh system includes a set of default adhkar so the user can begin immediately without creating anything manually. The default library can include common phrases such as **SubhanAllah**, **Alhamdulillah**, **Allahu Akbar**, **La ilaha illallah**, **Astaghfirullah**, **SubhanAllahi wa bihamdihi**, **SubhanAllahi wa bihamdihi, SubhanAllahil-Azim**, and longer adhkar such as **La ilaha illallahu wahdahu la sharika lah...** and **Raditu billahi rabban...**. Each dhikr can have its own category, target count, lifetime count, display icon, transliteration, translation, and virtue text. For example, some adhkar may belong to **Post-prayer**, some to **Morning & Evening**, some to **Tahlil**, some to **Istighfar**, and some to general dhikr. This makes the feature usable immediately, while still allowing advanced users to modify, pin, favorite, archive, or create their own entries. --- #### Dhikr Library The **Dhikr Library** is the management center for all adhkar. It gives users a searchable list of dhikr entries and separates content into areas such as **Adhkar** and **Routines**. The library can be opened from the main Tasbeeh toolbar. Inside the library, each dhikr appears as a card. A card can show the emoji or icon, dhikr name, category, target count, and lifetime count. For example, a card may show **SubhanAllah**, marked as **Post-prayer · target 33**, with a lifetime total such as **607**. Another card may show **Alhamdulillah**, also with its category and target. Longer adhkar names can be truncated cleanly while still remaining identifiable. Each dhikr card includes management actions. Users can mark an item as a favorite, pin or unpin it from the quick switcher, edit it, or archive it. Pinning controls which adhkar appear prominently above the counter. Favoriting gives the user another way to mark important adhkar. Archiving removes clutter without necessarily destroying the user’s history. The library also includes search. Users can search adhkar or categories, making it easier to find a specific phrase when the library grows. This is important because a serious dhikr library can contain many entries, especially if the user creates custom adhkar or imports a larger library. The library also includes a **+ New** action for creating a new dhikr. This turns the Tasbeeh system into a personal dhikr manager, not just a fixed counter. --- #### Creating Custom Dhikr Users can create their own dhikr entries. The custom dhikr editor is comprehensive and allows the user to define the text, meaning, goal, behavior, icon, and visual identity of the dhikr. The editor supports starting from a template. A template option can provide a ready-made set of adhkar, such as **24 adhkar**, allowing users to build quickly from predefined content rather than typing everything manually. For custom entries, users can enter the **Arabic text**, **transliteration**, **translation**, and **virtue / reward / fadl**. The transliteration field is important because many users may be able to recite through transliteration even if they are still learning Arabic. The translation field helps the user understand the meaning. The virtue field lets the user store the benefit, narration, reminder, or spiritual context attached to that dhikr. The editor also includes a **Category** field. This allows the dhikr to be organized under sections such as General, Post-prayer, Morning & Evening, Tahlil, Istighfar, or other categories depending on the user’s setup. The user can set the **target per lap**. For example, a dhikr may have a target of 33, 34, 100, or any custom number. The user can also set the **step per tap**, allowing one tap to count as more than one unit when needed. A **daily goal** can also be configured for the dhikr, so the app can track daily progress separately from the current lap target. Custom dhikr also supports visual personalization. The user can choose an emoji or icon, such as a tasbeeh, leaf, hands, star, pointing finger, water drop, sunrise, scales, key, heart, shield, bird, mosque, Kaaba/mosque icon, moon, sun, or another symbol. The app also supports user-selected emoji, so the user is not limited to the built-in options. An accent color can also be selected for the dhikr. The editor provides quick color choices and an automatic/default option. This color can be used in the dhikr card, counter, highlights, or progress visuals, helping the user visually distinguish one dhikr from another. --- #### Routines The library includes a **Routines** area, indicating that the Tasbeeh system is designed not only for individual adhkar but also for grouped dhikr workflows. This is useful for structured sequences, such as post-prayer adhkar, morning adhkar, evening adhkar, or personal routines. A routine-based system allows the user to move through a set of adhkar in order. This works naturally with the counter’s target behavior settings, especially options such as advancing to the next dhikr after completing a target. Even when a user is counting multiple adhkar in sequence, the interface can remain simple and focused. --- #### Tasbeeh Statistics The **Tasbeeh Statistics** screen gives the user a detailed view of their dhikr activity. It is designed to show both overall totals and meaningful trends, rather than only a single lifetime number. The statistics screen can show lifetime total counts, today’s total, last seven days, last thirty days, current streak, best streak, best day, and goal days. For example, the screen can show values such as **Lifetime 965**, **Today 56**, **Last 7 days 1,076**, **Last 30 days 1,076**, **Current streak 1 day**, and a best day such as **1,011** counts on a specific date. It can also show how many days in the last 30 days reached the configured daily goal. A daily activity grid shows recent dhikr consistency across multiple weeks. Each day is represented visually, making it easy to recognize active days, quiet days, streak patterns, and long-term consistency, where each day is represented as a small square and stronger activity can be visually highlighted. This makes consistency visible over time. Instead of only seeing totals, the user can see patterns: active days, quiet days, recent activity, and whether dhikr is becoming a habit. The statistics screen also includes a chart for the **last 14 days vs goal**. This bar chart compares daily dhikr counts against the daily target. A goal line can show the target level, while daily bars show actual counts. This makes it immediately clear which days exceeded the goal and which days were below it. The **By dhikr** section breaks down counts per dhikr. For example, it can show **SubhanAllah** with 607 counts, **La ilaha illallah** with 136, **Raditu billahi rabban...** with 80, **La ilaha illallahu wahdahu la sharika lah...** with 55, **SubhanAllahi wa bihamdihi** with 51, **SubhanAllahi wa bihamdihi, SubhanAllahil-Azim** with 20, **Alhamdulillah** with 10, and **Allahu Akbar** with 4. Each item can include a progress-style bar, making the distribution readable at a glance. The **Personal records** section records achievements such as the longest session and fastest pace. For example, it can show a longest session of **80** counts and a fastest pace such as **235/min** over a given number of counts. This gives users extra insight into how they use the counter. The **Recent sessions** section lists individual counting sessions. Each row can show the date and time, the number of counts, duration, and pace. For example, a recent session may show **5 counts**, **0:13**, and **22/min**, while another may show **51 counts**, **0:58**, and **53/min**. This session history allows users to review when they counted and how much they completed. Together, these statistics turn the Tasbeeh feature into a long-term dhikr tracker, not only a live counter. --- #### Feedback Customization The **Tasbeeh Customization** screen includes a Feedback section that controls how the counter responds while the user counts. The **Haptic strength** setting allows users to choose the strength of vibration feedback. Options can include off, light, medium, and strong. This is useful because some users want a strong physical response with every tap, while others prefer subtle feedback or no vibration. The **Milestone pulses** option can trigger special vibration patterns when the user reaches milestones. The interface describes this as a double pulse at milestones and a triple pulse at the target. This gives the user a physical signal when they reach important counts without needing to look at the screen. The **Milestone every** slider lets the user control how often milestone feedback occurs. For example, it can be set to every 33 counts, which fits common dhikr patterns. The user can adjust this depending on their own routine. The **Sound** setting controls audible feedback. Options can include silent or no sound, haptic-only behavior, click, bead, and soft tone style feedback. This allows the app to feel like a digital tasbeeh bead, a silent tracker, or a soft audio-assisted counter depending on preference. The **Visual flash** toggle enables a brief accent wash at milestones. This gives a visual signal when the user reaches important points in their count. --- #### Input and Gesture Customization The Input & Gestures section controls how the user interacts with the counter. The **Tap anywhere** option allows the whole counter face to act as the button. This makes counting easier and reduces the need for precise tapping. It is especially useful when the user wants to count without looking carefully at the screen. The **Quick-add chips** option controls whether shortcuts such as **+10**, **+33**, and **+100** appear under the counter. Users who want fast manual entry can keep them enabled, while users who want a cleaner interface can turn them off. The **Swipe to switch dhikr** option allows horizontal swiping on the counter face to move through the dhikr library. This makes it easy to switch between adhkar during a routine. The **Double-tap to undo** option allows undo through a double tap. This is disabled by default in the screenshots. The setting notes that it adds a small single-tap delay while enabled, because the app must wait briefly to know whether the user is single-tapping to count or double-tapping to undo. The **Volume-button counting** option allows the device volume buttons to be used for counting. Volume up can count upward, and volume down can undo. This is useful when the phone is held in a way where screen tapping is less convenient, or when the user wants more tactile physical controls. The **Left-handed layout** option mirrors the control row. This improves comfort for left-handed users and shows attention to practical usability. --- #### Behavior Customization The Behavior section controls how the counter behaves over time and what happens at targets. The **At the target** setting controls what the app does when the current dhikr reaches its target count. The behavior can be configured to repeat laps, stop at the target, or advance to the next dhikr. Repeat is useful when the user wants to keep doing the same dhikr beyond one lap. Stop is useful when the user wants a hard target. Advance to next is useful for routines, such as moving from SubhanAllah to Alhamdulillah to Allahu Akbar after each target is completed. The **Confirm before reset** toggle protects the user from accidental resets. Since losing a current count can be frustrating, this setting adds safety. The **Session idle timeout** controls when a session should be considered ended after inactivity. For example, the screenshot shows a value such as **3 min**. This helps the app separate distinct sessions automatically. The **Daily goal** slider controls the daily count target, such as **300**. This value can be used for the daily goal bar, statistics, goal days, and nudges. The **Weekly goal** setting allows a weekly target to be configured or turned off. This gives users a longer-term planning layer beyond daily counting. The **Fresh start each day** option resets every live count at the first open of a new day while keeping lifetime totals intact. This means the user can start daily counting cleanly without losing historical totals. The **Smart suggestions** option enables contextual nudges, such as suggestions for Salawat on Friday or other situation-aware dhikr prompts. This makes the feature gently proactive while remaining under user control. The **Keep screen on** option keeps the device awake while the counter is open. This prevents the screen from sleeping during longer sessions. The **Daily dhikr reminder** option gives the user a gentle reminder at a chosen time. This is separate from the live counter and supports consistent practice over time. --- #### Appearance Customization The Appearance section controls what the Tasbeeh screen looks like and which information is visible. The **Counter style** setting allows users to choose the visual form of the counter. The screenshots show **Progress ring** as one option, and the feature can also support styles such as bead, ring, and minimal. This allows the user to choose between a large circular progress experience, a more bead-like style, or a cleaner minimal counter. The **Count text size** slider changes the size of the main count number. This is useful for readability and accessibility. A user who wants a large, glanceable counter can increase the text size, while a user who wants more surrounding information can keep it smaller. The **Arabic text** toggle controls whether the Arabic dhikr text appears. The **Transliteration** toggle controls whether romanized pronunciation appears. The **Translation** toggle controls whether the meaning appears. These separate controls are important because users have different needs: some may want Arabic only, some may rely on transliteration, and some may want the meaning visible. The **Virtue text** toggle controls whether the reward or fadl text appears under the translation. This keeps the spiritual context available but optional. The **Meters row** toggle controls the row that shows values such as streak, today, and seven-day count for the active dhikr. The **Quick switcher** toggle controls whether pinned and recent adhkar appear above the counter. The **Session bar** toggle controls whether live duration, counts, and pace are shown during the session. The **Daily goal bar** toggle controls whether the daily progress bar appears near the bottom. The **Accent color** setting allows users to change the visual accent color of the Tasbeeh screen. The screenshots show several color choices, including an automatic/default style and multiple bright accent options. This gives the counter a more personal and polished feel. --- #### Data Export and Import The Tasbeeh feature includes data management controls for preserving the user’s dhikr library and history. Users can **export the library** as a JSON file. This backup can carry the user’s adhkar, lifetime counts, and routines. Exporting is important because the Tasbeeh library can become deeply personal over time, especially when users create custom adhkar and accumulate long-term counts. Users can also **import the library** from JSON. Imports are handled safely: imported entries land as new custom entries, and existing content is not overwritten. This helps prevent accidental data loss. A **Reset all to defaults** option is also available. This restores the Tasbeeh configuration back to its default state when the user wants to start fresh with settings. --- #### Overall Design Philosophy The Tasbeeh Counter is designed as a serious dhikr companion, not a lightweight tap counter. It gives users a calm and beautiful counting screen for daily use, but also includes the deeper systems needed for long-term tracking, personalization, and structured worship routines. The feature is highly practical. Users can tap anywhere, use quick-add buttons, undo and redo mistakes, reset safely, switch dhikr by swiping, count with volume buttons, use haptics and sounds, keep the screen awake, and simplify the screen through focus mode. It is built to reduce friction during dhikr instead of forcing the user to manage the tool constantly. The feature is also deeply personal. Users can create their own adhkar, write Arabic text, transliteration, translation, and virtue notes, set targets and goals, choose emojis and colors, organize items in the library, pin favorites, archive unused entries, and build routines. The tracking layer makes it long-term. Lifetime totals, today’s counts, seven-day and thirty-day totals, streaks, best days, goal days, activity heatmaps, goal charts, per-dhikr breakdowns, personal records, and recent sessions all help the user understand consistency and progress. ### Home Widgets (https://alislam.lymrah.com/docs/home-widgets) *Android widgets for Prayer Times, Hijri date, upcoming occasions, and Hijri month calendar.* Al Islam now includes dedicated **Android home screen widgets** for Prayer Times, Hijri dates, upcoming Islamic occasions, and Hijri calendar viewing. These widgets bring the most important daily Islamic information directly to the user’s phone home screen, so they do not need to open the app every time they want to check the next prayer, today’s Hijri date, or upcoming Islamic events. The widgets are designed to feel like a natural extension of the app itself. They use the same modern emerald visual language, soft rounded surfaces, subtle glass-like depth, yellow accent highlights, and clean typography that appear across the main Al Islam interface. The goal is not only to display information, but to make that information readable, beautiful, and immediately useful at a glance. This update makes Al Islam more present in the user’s daily routine. Prayer times, Hijri dates, Islamic occasions, and monthly calendar context can now live directly on the home screen, turning the app from something the user opens manually into something that quietly supports them throughout the day. --- #### Prayer Times Widget The **Prayer Times widget** gives users a quick home-screen view of the current and upcoming prayer schedule. It shows the selected location, the current Hijri date, the next prayer, the countdown until that prayer, the highlighted active prayer time, and the daily prayer timeline. For example, the widget can show the location as **Islamabad, Pakistan**, the Hijri date as **24 Muharram 1448**, and the next prayer as **Dhuhr** with a countdown such as **in 7 h 26 min**. The Dhuhr time can be shown prominently in a bright pill, such as **12:13 PM**, making the next important time immediately visible. The widget also displays the main prayer times in a compact row. It can show **Fajr**, **Dhuhr**, **Asr**, **Maghrib**, and **Isha**, each with its time underneath. The current or next prayer is visually emphasized, while the others remain visible for context. This lets the user understand the whole prayer day without opening the app. The design is intentionally glanceable. The user can quickly answer: *What is the next prayer? How much time is left? What are the remaining prayers today?* At the same time, the widget remains visually calm and does not overload the home screen. There is also a more compact Prayer Times widget layout. This smaller version keeps the most important information: the next prayer, countdown, highlighted time, and the row of daily prayers. It is useful for users who want prayer information on their home screen but prefer a smaller widget footprint. --- #### Hijri Date Widget The **Hijri Date widget** shows the current Islamic date in a focused, elegant card. It is designed for users who want to keep the Hijri calendar visible every day without opening the full calendar screen. The widget can show the Hijri day number prominently, such as **24**, alongside the Hijri month and year, such as **Muharram 1448 AH**. It also includes the Arabic month name, such as **مُحَرَّم**, and the corresponding Gregorian date, such as **9 Jul 2026**. This makes the widget useful for daily Islamic awareness. Many users live primarily by the Gregorian calendar in work, school, and public life, so Hijri dates can easily be forgotten. Placing the Hijri date directly on the home screen helps users stay aware of the Islamic month and day every time they unlock their phone. The widget is compact but complete. It does not only show a number; it shows the Hijri month, Hijri year, Arabic naming, and Gregorian correspondence together. That makes it suitable for both quick reference and religious date awareness. --- #### Upcoming Islamic Occasions Widget The **Upcoming widget** displays upcoming Islamic occasions and important dates directly on the home screen. It works like a compact Islamic agenda, showing what is coming next and how many days remain. The widget can show a header such as **UPCOMING**, along with the current Hijri date, such as **24 Muharram 1448 AH**. Below that, it lists upcoming dates in a clean vertical layout. Each row includes an icon, event name, Hijri date, Gregorian date, and countdown badge. For example, it can show **White Days** with **13 Safar · 27 Jul** and a countdown such as **18 d**. It can show **Mawlid an-Nabi ﷺ** with **12 Rabi’ al-Awwal · 25 Aug** and a countdown such as **47 d**. It can continue showing later dates such as White Days in following months, **Rajab begins**, and other future Islamic occasions. This widget is especially useful for planning. Users can see upcoming fasting days, sacred dates, and important Islamic occasions without manually browsing the calendar. It helps users prepare earlier instead of remembering only on the day itself. The list layout is also efficient. It can show several upcoming items at once while keeping each row readable. Countdown badges make timing obvious, and icons make the list visually scannable. --- #### Hijri Month Calendar Widget The **Hijri Month Calendar widget** brings a full monthly Hijri calendar grid to the home screen. This is one of the most useful additions because it gives users a live month overview without requiring them to open the app. The widget can show the active Hijri month, such as **Muharram 1448 AH**, along with its Gregorian range, such as **Jun – Jul 2026**. Below the header, it displays the weekday row and the full month grid. Each date cell can show the primary Hijri day and the smaller companion Gregorian date. For example, a Hijri day such as **24** can show the corresponding Gregorian date **9** beneath it. This keeps both calendar systems visible together, which is important because users often need to understand Hijri dates in relation to daily Gregorian planning. The current day is highlighted with a clear gold outline. Fridays are visually emphasized, making Jumu’ah easy to recognize across the month. Previous or next month spillover dates can appear dimmed so the active month remains visually clear. The calendar widget can also show small event markers and dots on dates. These markers reflect meaningful calendar information, such as Islamic occasions, fasting-related days, or other important calendar events depending on the app’s calendar data. This turns the widget into more than a static month grid; it becomes a compact Islamic calendar surface on the home screen. This widget is particularly valuable for users who want to keep track of the Hijri month visually. They can see how far the month has progressed, which dates are approaching, which Fridays are coming, and where important marked days appear in the month. --- #### Integration With Prayer Times and Hijri Calendar The widgets are not separate disconnected features. They are connected to the app’s existing Prayer Times, Hijri Calendar, and Islamic occasions systems. The Prayer Times widget uses the selected prayer-time location profile, so the displayed times match the user’s configured location and calculation settings. If the user is using Islamabad, Pakistan inside Prayer Times, the widget reflects that same location context. The Hijri Date, Upcoming, and Calendar widgets are connected with the Hijri Calendar system. This means the widgets can show Hijri dates, Gregorian correspondence, upcoming Islamic dates, event markers, and month structure using the same calendar logic available inside the app. This consistency is important. The home screen should not show one version of the date while the app shows another. The widgets are designed to extend the app’s internal systems outward onto the phone home screen. --- #### Practical Daily Use The widgets make Al Islam more useful throughout the day. A user can glance at the Prayer Times widget in the morning and immediately see when Fajr, Dhuhr, Asr, Maghrib, and Isha occur. During the day, the highlighted next prayer and countdown help the user stay aware of the prayer schedule. The Hijri Date widget keeps the Islamic date visible. This is useful for remembering the current Hijri month, noticing sacred months, and staying connected to Islamic time. The Upcoming widget helps with planning. A user can see White Days, Ramadan-related dates, Rajab, Dhul-Hijjah, Mawlid an-Nabi ﷺ, or other important Islamic occasions before they arrive. The Hijri Month Calendar widget gives the user a larger monthly context. It helps the user understand the current Hijri month as a full calendar, not only as a single date. Together, these widgets create a strong daily Islamic dashboard directly on the Android home screen. --- #### Overall Design Philosophy The Home Widgets feature is designed around convenience, visibility, and consistency. It gives users immediate access to the Islamic information they check most often: prayer times, the Hijri date, upcoming occasions, and the current Hijri month. The widgets are intentionally modern and polished. They are not plain text boxes or basic system cards. They follow the app’s visual identity and present information in a calm, readable, premium-feeling layout. ## Changelog ### v4.5 — Bayt al-Hikmah (2026-07-25) ##### Al Islam v4.5 - Bayt al-Hikmah **📅 Release Date:** July 25, 2026 **Release Type:** Major Intelligence, Reading, Hadith & Widgets Update Version **4.5** answers the request that has followed Al Islam the longest: *I can open the hadith, but not in my language.* Translations are files. Files have to be written, checked and published — and most of the world's languages have never had most of the classical collections rendered into them at all. A reader in Hausa, Malay, Somali, Turkish, Bosnian or Tamil can hold the whole of Sahih al-Bukhari in their hand and still not read a word of it. Version 4.5 introduces **Intelligence** — a complete AI system built into Al Islam, running on models you connect yourself. Every reading in the app gains the same three abilities: **Translate**, **Listen**, and **Ask**. Beside it, the hadith reader now holds several translations at once and lets you arrange them; the Quran reader gains the same abilities across every interpretation on screen; the random hadith on the home screen has been rebuilt into a full daily-reading engine; the notes editor learns to take dictation; and the home screen widgets have been sharpened for modern Android. > Intelligence is in its first major public phase. It is already deep and fully usable across the whole app, but future updates will keep widening the provider catalogue, the places it reaches, and the control you have over it. --- ##### 🧠 Intelligence — Your Own Models, Throughout the App **Intelligence** is a new system, reachable from the Tools grid and from your Profile. It is not a chat window bolted onto the side of the app. It is a layer sitting underneath every reading surface, so the app's own content — the ayah, the narration, a scholar's translation, your own notes — is what the models actually work on. Intelligence is part of **Al Islam Premium**. The subscription unlocks the suite itself; the models run on **your own provider account and its billing**, under your own keys. Al Islam never resells model access, and your keys never leave your device. ###### Setting it up Three steps, once: 1. **Connect an account.** Pick your provider from the catalogue and paste your key. It is verified on the spot. 2. **Choose what serves what.** Pick a model for translation, for explanations, for speech. One choice is enough to begin — everything else falls back to it. 3. **Open any hadith or ayah.** The actions are already there, underneath the text. Nothing else needs configuring. Everything beyond this point is refinement. ###### Bring your own key — 35 services Connect the accounts you already have. Al Islam speaks ten different provider protocols, covering thirty-five services between them: | Group | Services | | --- | --- | | **Major AI labs** | OpenAI · Anthropic · Google AI (Gemini) · Azure OpenAI · Mistral · xAI · DeepSeek · Moonshot · Qwen · Z.ai · Perplexity | | **Arabic-first** | Fanar — built for Arabic and for Islamic material | | **Inference platforms** | Groq · OpenRouter · Together · Cerebras · Fireworks · DeepInfra · Nebius · SambaNova · Novita · Hyperbolic · GitHub Models | | **On your own machine** | Ollama · LM Studio · Jan · llama.cpp · vLLM — keyless, private, running locally | | **Translation services** | DeepL · Google Cloud Translation · Azure Translator · LibreTranslate | | **Voice** | ElevenLabs (speech and transcription) · Deepgram (transcription) | | **Anything else** | A general connection for any OpenAI-compatible gateway, proxy or service not named above | ###### What your models can do | Capability | What it gives you | | --- | --- | | **Translation** | Any passage rendered into any language you ask for | | **Text generation** | Explanations, summaries, key lessons, and instructions of your own | | **Speech** | Content read aloud in a natural voice | | **Transcription** | Your own speech turned into text inside the notes editor | ###### Connecting an account Every service has its own idea of what a connection looks like — a key; a key and a region; a key and an endpoint; a project id; a deployment name; nothing at all. Al Islam builds the right form for whichever service you choose, so each asks for exactly what it needs and nothing more. - **Instant verification.** Saving a connection tests it straight away against the lightest call the service offers, so a mistyped key is caught the moment you paste it rather than the first time you try to read something. - **Custom headers on every connection**, passed through exactly as written — enough to reach a company proxy, a gateway, or a service that arrived after this release did. - **As many accounts as you like.** A personal key and a work key; a fast inexpensive model and a careful expensive one; a cloud service and a local one. Each is enabled or disabled on its own. - **Masked once saved.** A key is shown only as a hint (`••••3kfa`) and never displayed again. - **A neutral catalogue.** Every service is presented plainly, with links to its own console and documentation when you need to fetch a key or check what you are paying. ###### Deciding what serves what A **Routing** screen decides which connection, model and voice serves each kind of work — and lets you override it for individual areas of the app. - Read hadith with one model, the Quran with another, your notes with a third. - Anything you have not set falls back to a single global default, so no request is ever left unanswered. - **Model and voice lists are read from your own account** wherever the service supports it, so you see exactly what you are entitled to use. - **Any model id can be typed in directly.** A model released this morning is usable this morning, without waiting for an app update. - **Per-capability tuning** — creativity, response length, formality, and the other settings each service genuinely accepts — shown where it applies and hidden where it does not. ###### The Intelligence screens | Screen | What it holds | | --- | --- | | **Hub** | Your connections at a glance, their health, and a lane for each capability showing what is ready and what still needs a model | | **Provider catalogue** | Every supported service, what it can do, and links to its console and documentation | | **Connection editor** | The form for a single account, validated as you type, with a combined save-and-test | | **Connection detail** | Health, the full model catalogue for that account, which routes it currently serves, its usage history, and removal | | **Routing** | Capability by area — the whole table of what serves what, with connection, model and voice pickers | | **Playground** | Live benches for all four capabilities: translate a phrase, generate a reply, hear a voice, transcribe a file — without touching your own content | | **Activity** | Totals, day-by-day bars, a breakdown per connection, and a log of individual requests with how long each took | | **Engine settings** | Streaming, caching, time limits, retries and privacy | | **Actions studio** | Your own instruction templates and translation lanes | | **Library** | Every translation the app has produced for you — searchable, pinnable, prunable | ###### Engine settings | Area | What you control | | --- | --- | | **Responses** | Whether answers stream in as they are written, or arrive complete | | **Speed** | Whether repeat translations are served instantly from the device | | **Patience** | How long a single request may take, from five seconds to ten minutes | | **Reliability** | How many times a failed request is tried again before it gives up | | **Privacy** | Whether usage is recorded at all, and whether a short excerpt of what you read is kept beside it | --- ##### 📖 Translate, Listen and Ask — On Every Reading The screens above are the smaller half of Intelligence. The larger half appears underneath the content itself. Every reading surface in the app — a hadith, an ayah, a scholar's translation, a tafsir, a translation your own model produced, and the random hadith on the home screen — now carries the same row of three actions. ###### Translate One tap renders the passage into the language you choose. - The result is presented as a **scholar-style card, laid out exactly like a published translation** — the same typography, the same per-language fonts you have already set, the same reading experience. A translation reads as a translation regardless of what produced it. - **Translations are kept.** Every one is saved to your Library, attached to the ayah or narration it came from, so you never pay twice for the same passage and never lose one you wanted back. - **Duplicates are recognised**, so asking again for the same passage with the same model returns what you already have. - **Repeat translations are instant and free**, served from the device rather than the network. - **Changed sources are noticed.** If the underlying text is later updated, the saved translation is marked out of date, with one tap to produce a fresh one. - **Pin the ones that matter** so they stay at the top of your Library. - **Copy or insert.** Take the text out, or drop it straight into a note. **Translation lanes** turn a good combination into a single tap. Save one as *Urdu via DeepL* or *English via Gemini* — a target language, and optionally a specific account and model — then choose it from the reading itself, without ever opening the routing table. Your last choice is remembered, so the common case is one tap from then on. ###### Listen Content is read aloud in a natural voice, and listening reaches everything in the app with words in it — not only the app's own text. - **Readings** — the Arabic, or any translation shown beneath it. - **Answers** — anything a model has written for you, spoken once it is finished rather than half-written. - **Your notes** — where a Qalam document is read as continuous prose, so headings, formatting marks, table borders and drawings never reach the voice. - **Voice and speed are yours**, adjustable from the player and remembered between visits. - **A specific account and model can serve speech** regardless of what serves everything else — useful when one provider has the voice you like and another has the translations you trust. - **One voice at a time**, and it keeps reading when you leave the screen, with the player following you. ###### Ask A conversation about the passage in front of you, appearing **inside the screen you are already reading** — nothing to copy out, nothing to navigate away to. - Threads stream in as they are written. - **Follow-up questions keep their memory**, so a conversation builds instead of restarting. - Answers can be read aloud, copied, or inserted into a note. - Each reading keeps its own thread, so moving between ayat does not mix them up. The instructions behind Ask are written specifically for Islamic source material: stay faithful to the text, invent no rulings and no attributions, preserve honorifics, and say plainly when something is uncertain rather than smoothing it over. ###### The workspace For longer work, the same three abilities open into a fuller surface with **Translate**, **Ask** and **Listen** side by side as independent sections — translate a passage, question it, and hear it without any one of them interrupting another. Where a reading has several versions on screen — the Arabic and its translations, or a narration and its renderings — **each section chooses its own source**. Ask about the Arabic while listening to the Urdu, or translate a scholar's English into a fourth language while the original stays in view. --- ##### 🧩 Standing Translations Beyond one-off actions, a language can be **pinned to stay**. Set a standing translation to Urdu, and every hadith you open arrives with Urdu already beneath it — filled in as you go, laid out as an ordinary part of the page rather than something you had to ask for. - **More than one at a time.** Urdu and English together, or three languages one below another. - **Chainable.** Take a scholar's English rendering and produce Turkish from it, or build a second language out of the first rather than out of the original. - **They report themselves.** If a connection is removed or a model stops answering, the card says so plainly instead of quietly disappearing. - **They know where they belong.** A standing translation built from one book's published translation appears only in that book. One built from the narration itself works everywhere — including the home screen, where the hadith belongs to no particular book at all. - **Reorder, rename and remove** them at any time from the reading itself. - **They work in the Quran too**, filling in as you move from ayah to ayah. --- ##### ⌨️ Your Own Commands Translation and asking cover most of it. For everything else, you can write **your own instructions** and run them over any passage in the app. A command is a short template with placeholders for the passage, its reference, and a target language. *Extract the fiqh points as a numbered list.* *Explain this to a ten-year-old.* *Give me three lessons and one action for today.* *Rewrite this translation in plainer English.* Write it once and it appears wherever readings appear. Five are included to begin with — **Summarize**, **Key lessons**, **Explain simply**, **Deep explanation** and **Remaster** — and every one of them is yours to rewrite or delete. Commands and translation lanes are both managed in the **Actions studio**, where you can see what each will do before you run it. --- ##### 🎙️ Dictation — Speaking Into Your Notes The Qalam notes editor gains a microphone. Tapping it opens a recorder **inside the editor** — nothing opens over your note, nothing navigates away from it. - **Record, pause, resume**, and stop **when you say so**. It never decides on its own that you have finished speaking. - **A live waveform** driven by your actual microphone level, so you can see that you are being heard. - **A running timer** and an unmistakable state at every stage. - **Import instead of recording** — hand it an audio or video file you already have and transcribe that. - **Transcribe is a deliberate step.** When you take it, the words land **exactly at your cursor**, inside the note you were already writing. - **Language can be stated or left open** for the model to work out. - **Record as many times as you like** into the same note, each take landing where you put it. Dictate a lecture as you listen to it, capture a thought on the move, or write a long note without typing a word of it. The editor also gains **Ask Intelligence** on a selection or on the whole note — question what you have written, or have a passage explained, with the answer available to insert straight back into the page. --- ##### 📚 The Hadith Reader — A Reading Stack The hadith reader was rebuilt around how people actually read: rarely with one rendering, and rarely in a fixed order. - **Several translations on screen at once**, stacked one beneath another. - **Arrange them by dragging.** Arabic first with Urdu below it, or your own standing translation at the top and the published ones underneath. - **Choose which one is authoritative.** Reference information — chapter, narrator, grading, numbering — is taken from a resource you nominate, independently of reading order. Read in Urdu while the reference details still come from the Arabic edition. - **The header states the book and number once**, above everything, instead of repeating itself for every translation. - **Show none at all, if that is what you want.** For a reader who reads only their own standing translations, an empty stack is a real choice — and the reader tells you how to fill it again if you would rather. - **Removing and reinstalling a translation restores your arrangement exactly**, rather than resetting it. - **Chapter names, narrator names and sub-chapter titles now render their formatting properly**, so honorifics and emphasis appear as they were written. - **Language flags** throughout the resource pickers, in place of text abbreviations. - **Choose several resources at once** when picking what to show. --- ##### 🕌 The Quran Reader The ayah preview gains the same reach. Every translation and every tafsir currently on screen is **individually actionable** — translate the Arabic, or translate a translation; listen to the ayah, or to a scholar's rendering of it; ask about the verse, or about one particular commentary on it. Standing translations work here as well, filling themselves in as you move from ayah to ayah, and your typography settings carry through to every one of them. --- ##### 🔀 The Random Hadith, Rebuilt The hadith card on the home screen has been rebuilt into a proper daily-reading engine. ###### Say exactly what may be drawn A **Draw settings** screen defines what the card may reach for. Every filter is independent, and they combine — *the Urdu renderings of Bukhari and Muslim, sahih only, short, that I have not read before* is a single, ordinary thing to ask for. | Filter | What it selects | | --- | --- | | **Books** | Any collections you choose, or all of them | | **Rendering** | Specific published translations, down to the individual edition | | **Language** | Any language, across the whole shelf at once | | **Gradings** | Sahih, Hasan, Da'if and the rest | | **Only the six collections** | Restrict the draw to the Sihah Sittah | | **Length** | A shortest and a longest, or an exact length | | **Only ones I have not read** | Skips anything already in your reading history | | **Avoid repeats** | Never the one before, or never the last several | Every list leads with its way out — *All books*, *Any language*, *Any grading* — so a filter is never something you can enter and not leave. Each setting states its own answer in plain words on a single line, and an empty selection reads "All books" rather than "none". Counts appear as sentences beneath the setting they belong to — *1,203 hadith available* — and when a combination reaches nothing, the screen says so before you leave it rather than after. ###### More than one set of settings Save as many as you like. A long, contemplative set for the evening; a short sahih one for the commute; a Ramadan set built around fasting and patience. The set you are editing is the first thing on the screen — named, switchable with one tap, renameable, and deletable when you have finished with it. The screen keeps your changes as you make them; there is no Save button to remember and nothing lost by leaving. **Changing your settings does not take the hadith away.** It stays on screen as long as your new settings still allow it, and only the rendering changes if the rendering is all that changed. ###### Decide when it changes | Cadence | Behaviour | | --- | --- | | **Daily** | One hadith for the whole day | | **Weekly** | One for the week | | **Every time you open the app** | A fresh one each session | | **Only when you ask** | It stays until you draw again | A hadith of the day now genuinely lasts the day. Rotating the phone, scrolling away, opening another screen and coming back all leave it exactly where it was. ###### It tells you what it did When your settings are narrow enough that nothing matches — a translation was removed, everything short has been read, "not read before" has run its course — the card widens the search one careful step at a time, and **says which step it took**. It gives ground in the order that costs you least: first how recently you saw something, then unread-only, then length, then gradings, then the six collections, then specific renderings, then languages, and last of all the books themselves. *Short sahih hadith from Bukhari* surrenders shortness long before it surrenders Bukhari. ###### Read it in A picker on the card answers one question only: **what do I read this in?** Languages lead, because a language decides whether a narration is readable at all. Those already on the device sit at the top; those still to be downloaded sit beneath them, one tap from the same answer. The full translation library is one level further down, for anyone who wants to choose an exact edition. Beneath them sits **AI translation** — a standing instruction that renders whatever is drawn into a language nothing on the shelf was ever published in, and keeps doing so as the draw moves from book to book. Choosing a language **keeps the hadith you are looking at** and re-renders it, drawing a new one only if this narration genuinely does not exist that way. ###### And it remembers Every hadith the card draws is written into your **History** like any other reading, so what you were given last Tuesday is still there to find. The card carries the same **Translate · Listen · Ask** row and the same standing translations as every other reading surface in the app, and the actions you reach for most — a fresh draw, a bookmark, the language picker — sit in the open along its title. --- ##### 🔒 Your Keys, Your Content A system holding your provider credentials owes you a plain account of how it treats them. - **Keys are encrypted on your device** with a hardware-backed key that cannot be taken off it, held separately from everything else the app stores. - **They are never shown again** after you save them — only a masked hint. - **They never appear in logs, usage records, backups or exports.** - **Traffic goes only where you sent it.** Al Islam's AI connection has no default destination; requests reach the providers you configured and nowhere else. - **Removing a connection removes its keys first**, so a connection can never be left behind without a way to clear it — and removal stays available to you at all times. - **Provider messages are cleaned before you see them.** Some services quote your own credential back inside their error text; anything of that shape is stripped before it reaches the screen. - **Usage records hold facts, not content** — which service, which model, how long it took, how much was used. An excerpt of what you read is stored only if you switch that on yourself. - **Caching and usage recording can both be switched off** entirely. - **Nothing is sent anywhere until you ask for it**, and when you do, it goes to the provider you chose. --- ##### 📱 Widgets — Sharper on the Home Screen The home screen widgets have been tuned for modern Android. - **They arrive at the right size.** Dropping a widget on the home screen now gives you the full layout immediately, instead of a cramped one you have to stretch open by hand — while shrinking it stays entirely free. - **Upcoming Occasions** gains a coloured stripe down the edge of each entry, so a glance tells you what kind of date is coming without reading a word of it. - **The Hijri month calendar** gains a small legend for its markers — today, fasting days, and Islamic occasions. - **Consistent icons** across every widget. - **Steadier refreshing**, with clearer behaviour while data is still loading and a retry that genuinely retries. The full set: **Prayer Times**, **Daily Companion**, **Hijri Date**, **Hijri Month Calendar**, **Upcoming Occasions**, and **Fasting Planner**. --- ##### ✨ Across the App - **A language picker covering seventy languages**, each with its own native name and correct writing direction — and a free entry field for anything not on the list, so nothing is out of reach. - **AI translations respect your typography settings.** A translation into Urdu uses the Urdu face you chose; Arabic renders in the Quranic face, right to left. - **Rich answers render properly** — headings, lists, emphasis and Arabic passages appear as intended rather than as raw markings. - **Resource pickers show language flags**, and let you pick several at once. - **Searching, filtering and selecting** share one consistent set of controls across the new screens. - **Settings read as sentences.** Every setting states its current answer beside its name, in your terms rather than the data's. - Interface polish across the reading surfaces, the hadith preview, the tools grid and the profile. --- ##### 🌟 Overall Version **4.5 — Bayt al-Hikmah** is the release in which Al Islam stops being bounded by which translations happen to exist. ###### Major additions in this release - **Intelligence** — a complete AI system running on models you connect yourself, across 35 services - **Translate · Listen · Ask** on every reading in the app - **Standing translations** that fill themselves in on every passage, chainable and reorderable - **A translation library** — everything kept, searchable, pinnable, and refreshed when its source changes - **Translation lanes** and **your own instruction commands** - **A workspace** where translating, asking and listening run side by side on different sources - **Listening** across readings, answers and your own notes - **Dictation** inside the Qalam notes editor, with file import and a live level - **Routing, Playground, Activity and Engine settings** for full control of your own models - **A hadith reading stack** — several translations at once, arranged by you, with a separately chosen authoritative source - **The Quran reader**, with every translation and tafsir individually actionable - **The random hadith rebuilt** — filters, saved sets, cadences, and an engine that explains itself - **Sharper home screen widgets** for modern Android - **Hardware-backed key storage**, with your content sent only where you send it Reading, understanding, listening and writing — in your language, with the models you choose, on the books you came for. --- 📱 Application: Al Islam 🏷️ Version: **4.5 — Bayt al-Hikmah** 🗓️ Release Date: **July 25, 2026** ### v4.4 — Miqat (2026-07-13) #### Al Islam — Version 4.4 ##### Miqat *Miqat (ميقات) — the appointed times and places. A fitting name for a release built around the rhythm of the Islamic day: prayer, direction, the lunar calendar, dhikr, and the pen.* **📅 Release Date:** July 13, 2026 **Release Type:** Major Tools, Notes, Calendar, Prayer Times, Widgets & Content Update Version **4.4** is the largest daily-utility expansion Al Islam has received. It introduces a complete Qibla Finder, a full Hijri calendar system, a Tasbeeh counter with long-term dhikr tracking, an all-new rich notes system, a major astronomy expansion for Prayer Times, Android home screen widgets, and new reference collections — alongside deep refinement work across the app. The theme of this release is simple: Al Islam should be useful at every point of your day. Finding the Qibla in an unfamiliar place, checking prayer times against the sun, following the Hijri month, logging a fast, counting dhikr after salah, writing down what you learned in a lecture, and keeping the essentials visible on your home screen — all of it now lives in one connected app. > Several of the systems in this release are in their first major public phase. They are already deep and fully usable, but future updates will keep improving their layouts, flexibility, widgets, and overall experience. --- ##### 🧭 Complete Qibla Finder A new **Qibla Finder** arrives in the Tools section — not a single compass screen, but a complete direction system with five ways to find, verify, inspect, and personalize the Qibla. It connects directly to your existing **Prayer Times location profiles**: follow your active prayer location, pick any saved profile, or use live location detection where available. No separate Qibla setup required. ###### Five ways to find the Qibla | View | What it does | | --- | --- | | **Compass** | Live Qibla compass with heading, bearing, sensor accuracy, declination, Sun/Moon markers, and alignment feedback | | **Map** | Geographic view with the Kaaba, your position, the Great Circle path, and a Rhumb Line comparison | | **AR** | Camera overlay that places the Qibla direction in your real surroundings | | **Sun** | Sensor-free verification using the sun's position and shadows | | **Insights** | The scientific layer: bearings, distances, Earth geometry, and your magnetic environment | The **Compass** view shows live heading, Qibla bearing, degree markings, the Qibla marker, and clear alignment confirmation. It can place the Sun and Moon on the dial, show the current moon phase, your coordinates, your distance to the Kaaba, and solar verification data. Because phone compasses are easily disturbed, it also includes sensor accuracy indicators, magnetic declination handling, tilt warnings, a bubble level, and interference awareness — so you know when nearby metal, electronics, vehicles, or magnetic cases may be affecting the reading. The **Map** view draws both the **Great Circle** (the true shortest path over the Earth's surface) and the **Rhumb Line** (the constant-bearing path), which makes visible why the Qibla can look "wrong" on a flat map while being exactly right on a round Earth. The **AR** view overlays the direction on your live camera feed — point the phone around a hotel room, office, airport, or open field and see the Qibla in the actual environment. The **Sun** view offers a physical cross-check that needs no sensors at all: solar Qibla moments such as shadow-along-Qibla and sun-over-Qibla alignments let you verify the direction with nothing but sunlight. The **Insights** view opens the technical layer for those who want it: Great Circle, Ellipsoidal (WGS-84), and Rhumb Line bearings side by side; your coordinates and the Kaaba's; the journey midpoint; distance comparisons and bearing drift; an Earth globe visualization with the day/night terminator; and the magnetic picture — declination, inclination, expected versus measured field strength, and interference warnings. ###### Qibla customization A dedicated customization screen puts the whole system under your control: - Bearing method: **Great Circle**, **Ellipsoidal / WGS-84**, or **Rhumb Line** - North reference: **True North** or **Magnetic North**, with manual declination override - Heading offset and calibration - Coordinate format, distance unit, and bearing decimal precision - Needle smoothing and alignment tolerance - Haptic feedback and haptic detents - Tilt warning and bubble level - Dial skin, dial motion, tick density, dial size, and needle color - Cardinal letters, degree numbers, and Sun/Moon dial markers - AR bearing ruler and AR marker size - Earth globe, sky path chart, moon arc, and moon phase disc - Field strength gauge, bearing comparison ruler, and declination rose - Default opening view, location behavior, and which cards, chips, and scientific overlays are visible --- ##### 🌙 Full Hijri Calendar System Version 4.4 adds a complete **Hijri Calendar** — not just a date grid, but a full Islamic calendar environment: Hijri dates with Gregorian correspondence, moon phases, Islamic occasions, fasting logs, personal events, date conversion, Hijri birthday calculation, reminders, and deep customization. The calendar is useful the moment it opens: today's Hijri date, the Arabic month name, the Gregorian date, the weekday, sacred-month status where it applies, the current moon phase, month progress, and the next important Islamic date are all in view. ###### Today, moon phase & upcoming dates A rich current-day card leads the screen — Hijri date, Arabic month name, Gregorian date, weekday, moon phase with illumination percentage, and progress through the Hijri month. Beneath it, a dedicated strip surfaces what's coming next, so important dates never require browsing: - The White Days - Ramadan-related dates - Rajab and Dhul-Hijjah dates - Ashura and Arafah - The two Eids - Mawlid an-Nabi ﷺ - Other significant Islamic occasions ###### Interactive Hijri month grid Every cell carries the Hijri date with its Gregorian companion. The grid highlights today, your selection, Jumu'ah, days outside the month, Islamic occasions, recommended fasting days, your logged fasts, personal events, and moon phase markers. Selecting any day opens a detail panel with the full picture: both dates, weekday and Arabic month name, moon phase and illumination, occasion details, countdowns, fasting context, personal events — plus direct actions to log a fast, add an event, copy, or share. ###### Year overview & fast navigation A year overview presents all twelve Hijri months as compact cards showing each month's length and event count — planning around Ramadan, Dhul-Hijjah, Muharram, or Rajab becomes a glance. A new jump system moves you anywhere instantly: month chips, year selection, typed input, or the Today shortcut. ###### Events, reminders & fasting logs A dedicated **Events & Occasions** area gathers built-in Islamic occasions, personal events, reminders, and fasting logs in one place. Personal events support a custom title, an emoji or icon, a custom color, a Hijri or Gregorian date, yearly repetition or one-time behavior, reminder timing, rich notes, and archive/delete management. That makes them right for Hijri birthdays, family dates, anniversaries, vows, study milestones, and private calendar notes. Fasting is a first-class citizen: log fasts directly, see them on the grid, follow the month's activity, review the last thirty days, and keep all-time records. A fasting lens can highlight Sunnah fasting days, obligatory fasts, days on which fasting is forbidden, your own logged fasts, and gentle nudges such as Monday/Thursday reminders. ###### Date converter & Hijri birthday finder The new **Date Converter** translates between Hijri and Gregorian with smooth date wheels — change one side and the other follows instantly. The result card shows the converted date, weekday, Arabic month name, moon phase, and how many days away (or ago) it falls, with actions to open it in the calendar, copy, or share. The **Hijri Birthday Finder** answers a question surprisingly hard to answer elsewhere: from a Gregorian birth date it derives the Hijri birth date, your age in both calendars, your next Hijri birthday, and the countdown to it. ###### Calendar customization Deep control, without complicating the everyday experience: | Area | Options | | --- | --- | | **Calculation** | Reckoning method, sighting adjustment / Hijri offset | | **Layout** | Hijri-first or Gregorian-first grid, week start day, numeral style | | **Grid** | Density, grid size, companion dates, outside-day dimming | | **Highlights** | Jumu'ah, today pulse, moon phases, Islamic occasions | | **Lenses** | Personal events, fasting lens, built-in occasions | | **Cards** | Today card, upcoming strip, look-ahead count | | **Behavior** | Fasting nudges, haptic month ticks, morning digest | | **Data** | Export/import and reset to defaults | --- ##### 📿 Tasbeeh Counter & Dhikr Tracker Tools gains a complete **Tasbeeh Counter** — a focused dhikr companion built around live counting, custom adhkar, routines, goals, streaks, and long-term statistics. The core stays simple: choose a dhikr, tap to count. Around that simplicity sits a full system — progress tracking, session data, undo and redo, quick-add controls, custom dhikr creation, templates, a managed library, and a statistics history that turns counting into a habit. ###### The counter Pinned and recent adhkar sit at the top for instant switching — SubhanAllah, Alhamdulillah, Allahu Akbar, La ilaha illallah, Astaghfirullah, and anything you create. Each dhikr can display its Arabic text, transliteration, translation, and virtue, with a large progress ring showing the current count against its target. While counting you can: - Tap anywhere to count - Quick-add `+10`, `+33`, or `+100` - Undo mistakes and redo - Reset the current lap - Watch session duration, count, and pace - Track daily goal progress, streaks, today's total, and the seven-day total A **focus mode** strips the screen down to the dhikr and the counter for distraction-free sessions. ###### Dhikr library & custom adhkar The **Dhikr Library** manages everything — built-in and custom. Search across adhkar and categories; favorite, pin, edit, and archive entries; create your own from scratch or from templates. A custom dhikr can carry Arabic text, transliteration, translation, virtue text, a category, a per-lap target, a step-per-tap value, a daily goal, an icon, and an accent color. ###### Routines Structured sequences move you through multiple adhkar in order — post-prayer adhkar, morning and evening adhkar, or any personal sequence — hands-off, with target behavior deciding when to advance. ###### Statistics The statistics screen turns history into insight: lifetime counts, today, the last seven and thirty days, current and best streaks, best day, goal days, personal records, and per-dhikr breakdowns — visualized through a daily activity heatmap, a recent-weeks grid, a fourteen-day goal chart, per-dhikr progress bars, and a session history including your longest session, fastest pace, and counts per minute. ###### Tasbeeh customization | Area | Options | | --- | --- | | **Feedback** | Haptic strength, milestone pulses, milestone interval, sound, visual flash | | **Input** | Tap anywhere, quick-add chips, swipe to switch, double-tap undo, volume-button counting | | **Behavior** | Repeat, stop at target, advance to next, reset confirmation, session idle timeout | | **Goals** | Daily goal, weekly goal, fresh start each day | | **Reminders** | Smart suggestions, keep screen on, daily dhikr reminder | | **Appearance** | Counter style, count text size, Arabic/transliteration/translation/virtue visibility, meters row, accent color | | **Data** | Export library, import library, reset to defaults | --- ##### ✒️ Qalam — The All-New Notes System *Qalam (القلم) — "the pen", after Surah Al-Qalam: "Nun. By the pen and what they inscribe."* Version 4.4 replaces the app's simple note box with **Qalam**, a complete rich-writing system designed for Islamic study — and built on a principle worth stating plainly: **everything you write is stored as readable plain text.** Headings, highlights, tables, Quran references, even drawings are recorded in a light, open notation. Your notes can be copied out whole, survive every backup and update, and are never locked into a private format. ###### A real editor - **Live formatting as you type.** Bold turns bold, headings grow, highlights glow, and references become colored chips — while the underlying notation stays visible in a faded tone so your note never hides anything from you. - **Two faces.** *Writing mode* for composing; *Reading mode* for the finished page, where notation disappears, tables become real grids, and everything turns interactive. - **A full toolbar** — history, text styles, structure, inserts, Islamic tools, and drawing — where every button is a true toggle that lights up when the cursor sits inside its formatting. - **An insert menu.** Type `/` on an empty line and every block type is a keystroke away, filtered as you type. - **Lists that think.** Return continues a list with the next bullet, number, or empty checkbox; return on an empty item exits the list; numbered lists renumber themselves when you insert in the middle. - **Two hundred steps of undo**, with typing grouped into sensible chunks. - **Find & replace** with match counting and one-at-a-time or replace-all. - **Outline & statistics** — every heading becomes a tappable table of contents, alongside word count, reading time, and task progress. - **Format document** — one command that rewrites the whole note into perfectly tidy notation without changing a word. - **Hardware keyboard shortcuts** for bold, italic, underline, undo, redo, and find. - **Editor settings** — text size and line height on smooth sliders, an optional monospace body, control over how formatting symbols appear, and your preferred opening mode. ###### Everything you'd expect to write with Bold, italic, underline, strikethrough, highlight, inline code, superscript and subscript; **text in any color** and **highlights in any color** through a full color wheel; six heading levels; bullet, numbered, and task lists with live, tappable checkboxes; quotes; real tables with per-column alignment and sideways scrolling; code blocks with language coloring and one-tap copy; dividers; labeled links, bare links, and images; and `#tags` — including Arabic tags like `#رمضان` — that search the note when tapped. ###### Built for Islamic writing This is where Qalam is unlike any general-purpose editor: - **Quran references.** A searchable directory of all 114 surahs — Arabic names, transliterations, meanings, and ayah counts — with live validation (it knows Al-Fatihah has no ayah 8) and support for ranges. References appear as elegant chips; **tapping a chip opens that exact ayah in the Quran reader.** - **Hadith references** across the classical collections — Sahih al-Bukhari, Sahih Muslim, the four Sunan, Muwatta Malik, Musnad Ahmad, Sunan ad-Darimi, Riyad as-Salihin, and the Forty Hadith collections — with chips that open the narration in the hadith reader. - **Du'a chips** that make supplications stand out from surrounding commentary. - **A one-tap honorifics library**: ﷽, ﷺ, ﷻ, عليه السلام, رضي الله عنه, رحمه الله, and everyday phrases with full diacritics — inserted as proper text, searchable and copyable. - **Arabic runs** rendered in the Quranic typeface, enlarged and right-to-left, even mid-sentence — and full support for entirely Arabic notes. ###### Drawings Insert a canvas and sketch freehand — narrator trees, tajweed marks, diagrams — with a row of inks plus a full color wheel, a smooth stroke-width slider, undo, and clear. Drawings live inside the note like any other block, reopen for further editing with a tap, and — true to the Qalam rule — are stored as text, so they travel intact through every copy and backup. ###### Callouts, collapsibles & smart tags Five styles of accented callout panels (info, note, tip, warning, danger) make key paragraphs impossible to miss; collapsible sections fold long detail away behind a titled row. Both belong to Qalam's open **smart tag** system — one consistent notation behind every special ability — which carries two promises: content from future versions is *displayed and preserved*, never destroyed, and the notation itself will never change meaning under your notes. ###### Notes, now woven through Collections Qalam is fully integrated where your notes actually live: - **Every saved item** — an ayah, a hadith, a folder — carries its own Qalam note, opened from the item's **Notes** action. Saving is automatic: while you type, and again the moment you leave. - **Standalone notes** are now real collection items. The new **New → Note** action (and the *Write a note* option in empty folders) creates a note page that lives in your folder tree — renamed, moved, copied, and organized like anything else, and included wherever your collection library is backed up or synced. - **Note items open properly.** Tapping a note now opens it in the editor — a gap in previous versions where these items had no destination. - **Accurate previews.** Item cards summarize note content through the real note engine, so headings, references, and formatting are reflected faithfully in the preview line. - **References connect.** Tap a Quran or hadith chip inside any collection note and the app takes you to the actual ayah or narration. - The notes step of the **save-to-collection** flow uses the full Qalam editor as well. A complete user guide to Qalam — every tool, every notation, and the full format reference — is published separately in the documentation. --- ##### ☀️ Prayer Times: Sun, Sky & Hijri Expansion Prayer Times was already a deep system — location profiles, precise and manual locations, time zone control, eleven calculation methods, Asr standards, high-latitude rules, rounding, twilight definitions, Hijri offset, and full offline calculation. Version 4.4 expands it with three new views — **Sun**, **Sky**, and **Hijri** — turning it into a visual, educational Islamic time system. ###### Sun view The prayer day, explained through the sun. A solar altitude curve traces the sun's path with Fajr, sunrise, Dhuhr, Asr, Maghrib, and Isha placed directly on it — making visible *why* each time falls where it does: Fajr and Isha inside the twilight zones, sunrise and Maghrib at the horizon, Dhuhr at solar noon, Asr on the descending arc according to your chosen standard. A live **Twilight Ladder** visualizes the depression angles behind the calculations — the apparent horizon, civil, nautical, and astronomical twilight, and the sun's current position — so angles like 18°, 17°, 15°, or 19.5° stop being abstract numbers. The **Solar Almanac** covers the rest: | Solar data | Meaning | | --- | --- | | Solar noon | When the sun reaches its highest point | | Equation of time | The difference between sundial time and clock time | | Day / night length | Duration of daylight and darkness | | Solar declination | The sun's celestial latitude | | Apparent sunrise / sunset | Refraction-aware rise and set times | | Duha begins | Duha time derived from solar altitude | | Solar midnight | The sun's lower culmination | | Sun altitude now | The sun's current height above or below the horizon | | Hour angle | The sun's angle from the local meridian | | Shadow ratio | The current shadow-length relationship | | Right ascension, Julian day, sidereal time | Advanced astronomical reference values | ###### Sky view The Sky tab connects prayer times to the visible heavens: a sky chart plots the sun's and moon's altitude curves across the day with a current-time marker, and a Moon card reports the current phase, illumination percentage, moon age, moonrise and moonset, distance, direction and altitude, and the next new and full moons. ###### Hijri view The Hijri tab brings the Islamic date into Prayer Times: the current Hijri date, month progress, upcoming occasions with short descriptions — the White Days, Mawlid an-Nabi ﷺ, the beginning of Rajab, Ramadan dates, and more. It also includes a **crescent visibility forecast** for the next month, built on the Yallop visibility test: conjunction time, first- and second-evening visibility, the Yallop grade, best viewing time, moon age, lag, ARCV, ARCL, crescent width, and the q value — with a clear note that official month starts follow your local sighting authority. ###### Date picker & almanac controls Date switching now uses the new dual Hijri/Gregorian picker — calendar, wheel, or typed input, from either calendar — which makes checking prayer times for a Ramadan day, Ashura, the White Days, or any specific date effortless. And since Prayer Times now carries far more almanac data, every optional card can be shown or hidden from the options menu: as simple or as deep as you want it. --- ##### 📱 Android Home Screen Widgets Version 4.4 brings Al Islam to the home screen. Five widgets keep the essentials visible without opening the app: | Widget | What it shows | | --- | --- | | **Prayer Times** | Location, current Hijri date, the next prayer with countdown, and the full daily prayer row | | **Compact Prayer** | A smaller prayer layout for tight home-screen spaces | | **Hijri Date** | The current Hijri day, month, and year with the Arabic month name and Gregorian date | | **Upcoming Occasions** | The next Islamic dates with icons, both calendars, and countdowns | | **Hijri Month Calendar** | A full Hijri month grid with companion Gregorian dates and event markers | Fajr through Isha at a glance, the Islamic date always in view, and upcoming occasions — the White Days, Rajab, Ramadan dates, Mawlid an-Nabi ﷺ — visible days in advance. Widgets are in their first release phase; more types, layouts, and controls are planned. --- ##### 📚 New Islamic Collections The reference library grows with five additions: | Collection | Notes | | --- | --- | | **Vision** | Newly added collection | | **Fatah al-Rabbani** | Newly added Islamic reference collection | | **Sahih Ibn Khuzaymah** | Newly added hadith collection | | **Kanzul Ummal** | Newly added hadith compilation | | **Hisnul Muslim** | Newly added du'a and adhkar collection | Together with the new tools, these continue Al Islam's growth into a complete platform for reading, study, reference, and daily practice. --- ##### 🛠️ Refinements, Edge Cases & Stability Integrating this many new systems surfaced — and resolved — a long list of edge cases. Improvements in this release include: - Qibla calculation, sensor handling, and magnetic interference behavior - Compass and AR reliability - Hijri date synchronization and Hijri/Gregorian conversion accuracy - Prayer Times date picker integration - Crescent visibility calculations - Calendar event and fasting log handling - Tasbeeh session tracking and dhikr statistics - Notes editing, previews, and collection integration - Widget rendering, updates, and home-screen data consistency - Tool customization screens - Cross-feature date handling - General UI consistency, performance, and stability Just as importantly, 4.4 deepens the connections *between* features: Prayer Times, the Hijri Calendar, the Qibla Finder, the Tasbeeh Counter, the Date Converter, the date picker, home widgets, fasting logs, personal events, notes, and upcoming occasions now share their data and behave as one system. --- ##### 🌟 Overall Version **4.4 — Miqat** is a defining step toward Al Islam as a complete daily Islamic companion. ###### Major additions in this release - Complete Qibla Finder with Compass, Map, AR, Sun, and Insights views - Full Hijri Calendar with occasions, moon phases, and year overview - Personal events, reminders, and fasting logs - Date Converter and Hijri Birthday Finder - Dual Hijri/Gregorian date picker - Tasbeeh Counter with library, routines, and statistics - Qalam — the all-new rich notes system, woven through Collections - Prayer Times Sun, Sky, and Hijri views - Solar Almanac and Twilight Ladder - Crescent visibility forecast - Five Android home screen widgets - Five new Islamic reference collections - Deeper customization across every new tool - Extensive edge-case and stability work Prayer, direction, calendar, moon, sun, fasting, dhikr, notes, widgets, and reference content — one connected experience, kept modern, convenient, and yours to customize. --- 📱 Application: Al Islam 🏷️ Version: **4.4 — Miqat** 🗓️ Release Date: **July 13, 2026** ### v4.3 — Discovery (2026-06-28) #### Al Islam — Version 4.3 ##### Discovery 🔍 📅 Release Date: June 27, 2026 Version 4.3 is one of the most comprehensive and content-rich releases in Al Islam's history — introducing a completely reimagined search experience, the largest single content expansion to date, and sweeping UI redesigns across nearly every major section of the app. --- #### All-New Search Section ##### 🔍 Reimagined Search Experience A completely rebuilt search section has been introduced alongside the original, accessible via swipeable tabs. Both sections remain active simultaneously — users who prefer the classic hierarchical reference workflow can continue using the original at any time. ###### Original Search vs New Search The original search section was built around structured reference navigation: users stepped through dropdown menus to select a book, a chapter, and a reference number — with additional scope options for global ID, Ruku, Para, and language. Effective for targeted lookup, but limited to structured navigation. The new search section is fundamentally different. Built for discovery first — with references as a natural extension rather than the starting point. --- ##### ✍️ Unified Smart Search Bar A single, intelligent search bar powers the entire experience. Users type once and receive results across all indexed content simultaneously. Input is analyzed automatically: - Free-form text triggers full-text search across the entire corpus - Reference-style input (e.g., 2:35) automatically surfaces matching reference results alongside text results - Hybrid and ambiguous inputs are handled gracefully, delivering the most relevant results from all sources --- ##### 🧠 Lucene-Inspired Search Engine The text search engine has been built from the ground up, heavily inspired by Apache Lucene with domain-specific extensions for Islamic content: - Diacritic-insensitive matching — Arabic tashkeel is fully ignored during search - Token-level text splitting and analysis - Fuzzy matching for approximate and near-match results - Relevance scoring and intelligent result ranking - Multi-field pattern analysis across related content - Connection-aware indexing across structured Islamic data Results are delivered in nanoseconds to milliseconds across millions of records. --- ##### 📂 Results Organized by Source Results are automatically grouped into dedicated, swipeable tabs: - Hadith — across all downloaded and installed books - Quran — translations and Ayahs - Tafsir — commentary content where resource packs are installed - Collections — user-created folders, saved items, notes, and item descriptions --- ##### 🎛️ Granular Search Filters An advanced filter panel provides complete control, with defaults carefully chosen to deliver an excellent out-of-the-box experience: - Search method — Text matching (default) or Reference mode - Sources — Selectable checkable chips for Hadith, Quran, Tafsir, and Collections - Scopes — Filter by Surah, Juz/Para, Ruku, or any structural element - Resource by — Narrow to specific languages or individual resource packs - Hadith books — Scope search to specific books, or keep all selected - Reset — One-tap to restore all filters to their defaults --- ##### 🔗 Reference Search Mode Selecting Reference mode adjusts all sources and chips to optimize the reference-based workflow. Scope options include: - Universal book order - Hadith chapter-based references - Quran by Surah, Para/Juz, or Ruku - Multi-scope combined selections Matched references are clearly labeled, grouped, and highlighted throughout results. --- ##### 🗂️ Searchable Collections & Notes User-generated content is fully indexed and searchable: - Personal collections and folder names - Notes attached to saved Hadith, Ayahs, and other items - Item descriptions and metadata Matched keywords are highlighted directly within results at the exact location they appear. --- ##### ⚡ Automatic & Transactional Indexing Indexing runs automatically whenever a new resource pack is installed or a collection is modified. The engine is RAM-aware, ANR-proof, and designed to have no noticeable foreground impact. All indexing is fully transactional — a force-close or crash during indexing leaves no corrupted or half-indexed state. The app detects and recovers incomplete operations automatically on the next launch. A manual reindex option is also available. --- ##### 📄 Full Pagination Every result set is completely paginated. No memory exhaustion regardless of corpus size or result count. --- #### Content Expansion ##### 📚 7 New Hadith Collections Seven new Hadith collections have been added, each available in Arabic and Urdu, with additional languages planned for future updates: 1. Al-Adab Al-Mufrad 2. Al-Lulu wal-Marjan 3. Musnad Abdul Rahman Ibn Awf 4. Musannad Abdullah Ibn al-Mubarak 5. Musnad Abdullah Ibn Umar 6. Musnad Ishaq Ibn Rahwayah 7. Al-Mu'jam al-Saghir --- ##### 🕋 38 New Quran Translations 38 additional translations have been added across a wide range of languages and scholarly traditions: 1. Tatarstan Religious Board — Russian 2. Ignaty Krachkovsky — Russian 3. Elmir Kuliev — Russian 4. Valeriya Porokhova — Russian 5. Gordy Sablukov — Russian 6. Knut Bernström — Swedish 7. Ali Al Barwani — Swahili 8. Abdol Mohammad Ayati — Tajik 9. Muhammad Saleh — Uyghur 10. Sodik Muhammad Yusuf — Uzbek 11. Ivan Hrbek — Czech 12. Abdul-Hamid Haidar & Kanhi Muhammad — Malayalam 13. Ahl Al-Hadith Central Society of Nepal — Nepali 14. Bashir Missouri — Kannada 15. Bayanul Furqan (Koshur Quran) — Kashmiri 16. Dar Al-Salam Center — Hebrew 17. Dar Al-Salam Center — Serbian 18. Mikhailo Yaqubovic — Ukrainian 19. Ghali Apapur Apaghuna — Oromo 20. Hasan Abdul-Karim — Vietnamese 21. Hussein Taji — Dari 22. Khalifa Altay — Kazakh 23. King Fahad Quran Complex — Thai 24. Abder-Rahim ibn Muhammad — Telugu 25. Muhammad Anwar Badkhashani — Dari 26. Muhammad Azeez ur Rahman — Telugu 27. Muhammad Karakunnu & Vanidas Elayavoor — Malayalam 28. Muhammad Shafi'i Ansari — Marathi 29. Othman al-Sharif — Italian 30. Rabila Al-Umry — Gujarati 31. Rowwad Translation Center — Sinhala 32. Rowwad Translation Center — Vietnamese 33. Ryoichi Mita — Japanese 34. Saeed Sato — Japanese 35. Mikael Aykyuni — Yoruba 36. Society of Institutes and Universities — Thai 37. Taj Mehmood Amroti — Sindhi 38. Rwanda Muslims Association — Kinyarwanda --- ##### 📖 87 New Tafsir Resources The Tafsir library has received its largest single expansion in the app's history. 87 new Tafsir resources have been added spanning classical Arabic scholarship, multilingual editions of foundational works, and language-specific series reaching dozens of global languages. This brings total Tafsir coverage from 8 resources to 95, dramatically deepening the Quranic commentary experience available within the app. --- ##### 🌍 30 New Languages Now Supported 30 additional languages are now supported across Quran and Tafsir resources, bringing the total to 62 supported languages: Swedish, Swahili, Tajik, Uyghur, Uzbek, Malayalam, Nepali, Kannada, Kashmiri, Hebrew, Serbian, Ukrainian, Oromo, Vietnamese, Dari/Persian, Kazakh, Thai, Telugu, Marathi, Gujarati, Sinhala, Japanese, Yoruba, Sindhi, Kinyarwanda, Arabic, Indonesian, Assamese, Kyrgyz, Tagalog --- ##### 📊 Content Summary - Total Quran Resources: 92 → 217 - Quran Language Support: 32 → 62 languages - Tafsir Resources: 8 → 95 - Quran Translations: 84 → 122 - Hadith Collections: 22 → 29 --- #### UI Redesigns ##### 📖 Quran Section Significant interface improvements across the Quran reading experience: - Go To Ayah Dialog — A comprehensive navigation tool for jumping directly to any verse by Surah, Juz, or inline reference, with smooth control sliders and a frictionless selector - Improved ayah listing — Smoother scrolling, easier navigation, seamless resource switching, and a toggle to disable translations - Redesigned Ayah Preview — Completely reimagined with Go To Verse shortcuts, richer references, and smooth multi-resource selection and switching --- ##### 🕌 Hadith Section All Hadith screens have been refreshed for improved readability and navigation: - Hadith Books — Refreshed layout and visual organization - Hadith Chapters — Now includes convenient inline search - Hadith Listing — Improved layout and navigation flow - Hadith Preview — Richer references, improved context, and adaptive layout for all screen sizes --- ##### 🎨 Text Customization The Text Customization screen is now centralized and significantly more convenient: - Switch between sections and languages within a single screen - View all section configurations in parallel - Fully frictionless and intuitive throughout --- ##### 📁 Collection Screen The Collection screen has been substantially improved: - Each component now displays richer visual details and engagement metrics - Cloud backup and sync has been fully stabilized — all edge cases addressed, with significantly improved performance, concurrent operations, and full awareness of device capabilities and network state --- ##### 🔗 Additional Redesigns - History Section — Refreshed interface and improved usability - Home Screen — Visual refresh and improved layout - Profile Section — Cleaner design with better information hierarchy - Authorization — The most seamless sign-in experience yet, with full password manager support --- 📱 Application: Al Islam 🏷️ Version: **4.3 — Discovery** 🗓️ Release Date: **June 27, 2026** ### v4.2 — Expansive Horizons (2026-05-19) #### Al Islam — Version 4.2 ##### Expansive Horizons 🌍 📅 Release Date: May 17, 2026 Version 4.2 continues the evolution of Al Islam with major expansions to Hadith collections, advanced reading analytics, comprehensive sorting systems, improved resource management, and broader usability refinements throughout the app. This update focuses heavily on organization, discoverability, reading insights, and giving users more powerful yet seamless control over their Islamic library experience. --- #### Hadith Collection Expansion ##### 📚 New Hadith Collections Added Two additional Hadith collections have now been introduced into the app, continuing our ongoing effort to expand authentic Islamic resources with structured multilingual support. ###### Newly Added Collections ###### 📖 Riyad as-Salihin Supported Languages: - Arabic - English ###### 📖 Bulugh al-Maram (Labeled Edition) Supported Languages: - Arabic - Urdu These additions further strengthen the growing Hadith ecosystem within Al Islam while maintaining organized references, multilingual accessibility, and structured navigation throughout the experience. --- ##### 🔖 Expanded Hadith Labeling (Gradings) Explicit Hadith grading support has been significantly expanded in this release. While many narrations already included grading information within their content, users requested clearer and more structured visible labels such as: - Sahih - Da‘if In response, dedicated labeling support has now been expanded across additional collections. ###### Newly Labeled Collections - Mishkat al-Masabih - Sunan al-Kubra al-Bayhaqi Nearly **30,000 Hadith narrations** have now been explicitly labeled, with continued expansion planned for future updates. Our long-term goal remains to provide comprehensive Hadith coverage, broader multilingual support, and richer scholarly classification across all supported collections. --- #### History & Insights Expansion ##### 📊 Advanced Reading Analytics The History & Insights system has been significantly expanded with deeper reading statistics, additional metrics, and new visual analytics. ###### New Unique Read Metrics In addition to total read tracking, the app now separately tracks and visualizes unique reading activity. New metrics include: - Total Quran Unique Reads - Total Hadith Unique Reads - Average Unique Reads Per Day - Unique Read Distribution Analytics A new dedicated Unique Read Share visualization has also been added alongside existing total read analytics. These additions provide a more accurate understanding of engagement patterns and study consistency over time. --- ##### 📈 Activity Graphs Two new activity visualization graphs have been introduced to provide broader insight into reading behavior and engagement trends. ###### 📅 Activity Over Time This adaptive graph visualizes reading activity across dynamic time ranges, including: - Daily activity - Monthly activity - Yearly activity The graph intelligently adjusts based on the selected time range, helping users quickly identify periods of highest engagement and long-term reading patterns. --- ###### 🕓 Reading by Hour of Day A second activity graph now displays reading engagement distributed throughout the day. This allows users to better understand: - Peak reading hours - Daily study habits - Time-based engagement patterns These additions further evolve the Insights Dashboard into a more complete activity and productivity tracking system. --- #### Date Range Filtering ##### 📆 Global Dashboard Time Ranges History and Insights now fully support reactive date-range filtering across the entire dashboard experience. Users can instantly filter: - History listings - Metrics - Charts - Activity graphs - Reading statistics using predefined or custom date ranges. ###### Included Quick Ranges - All Time - Today - Yesterday - 3 Days - 7 Days - 30 Days - 3 Months - 1 Year - 2 Years - 3 Years Custom date-range selection is also fully supported. All analytics and listings update instantly based on the selected range, creating a more flexible and research-friendly experience. --- ##### ⚡ Optimized History Performance The History system has also received major backend and performance refinements. Enhancements include: - Improved pagination - Smoother scrolling - Reduced memory usage - Better responsiveness with large datasets - Faster filtering and searching - More efficient data handling These improvements ensure smooth performance even with extensive reading histories and analytics data. --- #### Unified Sorting System ##### 🔃 Comprehensive Sorting Infrastructure A fully unified and consistent sorting system has now been implemented across all sections of the app. This redesign introduces: - Standardized sorting behavior - Consistent UI patterns - Ascending and descending ordering support - Context-aware sorting options based on content type The goal is to provide maximum flexibility while maintaining a modern, intuitive, and user-friendly experience. --- ##### 📚 Example — Hadith Book Sorting Supported sorting options now include: - Default — Original curated order of Hadith books - Book name — Alphabetical order by English book title - Arabic name — Alphabetical order by Arabic book title - Chapter count — Number of chapters contained in the book - Total Hadith — Total number of Hadith narrations in the book - Compiled date — Historical order by when the book was compiled - Translations — Number of available language translations - Read progress — Percentage of Hadith you have read in the book - Read count — Total number of Hadith you have read across all sessions - Last read — Most recently opened books appear first --- ##### 🕋 Example — Quran Surah Sorting Surah listings now support sorting by: - Traditional Sequential Quranic Ordering Based on Surah Number - Alphabetical Ordering Using Romanized (English Transliteration) Surah Names - Alphabetical Ordering Using Native Arabic Surah Names - Chronological Ordering Based on Historical Revelation Sequence of the Surahs - Numerical Sorting Based on Total Number of Verses (Ayahs) Within Each Surah - Numerical Sorting Based on Total Number of Rukus Contained in Each Surah - Alphabetical Ordering Using English Translation or Meaning of Surah Names - Classification-Based Grouping by Revelation Type (Makki or Madani Surahs) --- ##### 📂 Supported Sections Sorting support has now been integrated across all sections, including: - Collections - History - Hadith Books - Hadith Chapters - Quran Surahs - Quran Juz / Parah - Resource Packs - Almost all list-based sections throughout the app Further expansion is planned as more datasets and systems evolve. --- #### Resource Pack Management ##### 📦 Improved Resource Pack Controls Users now have greater control over downloaded resource packs. A redesigned unified resource management dialog now allows users to: - Delete downloaded resource packs - Redownload resources at any time - Manage storage more efficiently - Maintain cleaner local content organization Resource removal and restoration have also been optimized to ensure data integrity and faster processing. --- #### UI, Stability & Performance ##### ✨ UI Consistency Improvements Version 4.2 introduces additional refinements focused on visual consistency and interface polish throughout the app. Enhancements include: - More consistent iconography - Improved spacing and layout standards - Better theming consistency - Refined component styling - Cleaner visual hierarchy across screens These refinements contribute to a more cohesive and modern user experience. --- ##### ⚡ Performance Improvements & Bug Fixes This release also includes continued infrastructure improvements and system optimizations. Enhancements include: - Improved overall responsiveness - Better compatibility across devices - SDK and dependency upgrades - Stability improvements across multiple sections - General bug fixes and reliability refinements --- 📱 Application: Al Islam 🏷️ Version: **4.2 — Expansive Horizons** 🗓️ Release Date: **May 19, 2026** ### v4.1 — Chronicled (2026-05-09) #### Al Islam — Version 4.1 ##### Chronicled 📚 📅 Release Date: May 09, 2026 Version 4.1 focuses on restoring and expanding some of the app’s most requested productivity and tracking capabilities. This release introduces a fully redesigned History system, deeper reading insights, enriched Hadith collection details, and continued infrastructure modernization across the platform. --- #### History System — Rebuilt ##### 🕘 History Section Remastered The History Section, temporarily removed during the major architectural transition in Version 4.0, has now returned with a completely rebuilt foundation. Reading activity is once again automatically tracked across supported sections, allowing users to revisit previously accessed content with greater speed and organization. Core features include: - Automatic reading history tracking - Section-based filtering - Direct navigation back to previously viewed content - Improved history organization and responsiveness - Enhanced reliability and data handling The redesigned system also lays the groundwork for future analytics, tracking, and personalized insights features planned for upcoming releases. --- ##### 📊 Insights Dashboard A brand-new Insights Dashboard has been introduced to provide a deeper understanding of reading activity and engagement patterns throughout the app. Users can now access detailed reading statistics and progress metrics, including: - Total Reads and Unique Reads - Per-section activity breakdowns - Average Reads Per Day - Active Reading Days - Current Reading Streak - Highest Recorded Streak - Section-based engagement distribution The dashboard also includes visual analytics such as section share charts and progress indicators to make activity tracking clearer and more engaging. This release establishes the initial foundation for a much broader insights and productivity ecosystem planned for future updates. --- #### Hadith Collections Enhancements ##### 📚 Enriched Hadith Book Profiles The Hadith Books section has been significantly expanded with richer metadata, progress tracking, and improved discoverability. Each collection now includes more detailed information, such as: - Book title - Compiler information - Collection category and labels - Total Hadith count - Total chapter count - Supported language count - Compilation dates in both Hijri and Gregorian calendars - Scholarly descriptions and contextual information These additions provide a more informative and research-friendly browsing experience. --- ##### 📖 Reading Progress Tracking Detailed reading progress metrics have now been integrated directly into Hadith collection profiles. Users can now view: - Total Hadiths read - Completion percentages - Total reads and unique reads - Visual progress indicators - Last read timestamps These additions make it easier to monitor study progress and continue reading seamlessly across collections. --- ##### 🔍 Improved Book Search Search functionality within the Hadith Books section has also been enhanced. Users can now search collections using multiple metadata points, including: - Book name - Compiler - Collection category - Labels and classifications - Additional indexed reference data This provides faster and more flexible navigation across large collections. --- #### Platform Improvements ##### ⚙️ SDK & Library Updates Core frameworks, libraries, and system components have been updated across the app to improve compatibility, performance, and long-term maintainability. Enhancements include: - Improved support for modern Android devices - Compatibility updates for newer Android versions - Better optimization based on device and Play Console insights - Stability improvements across multiple environments These updates help ensure a smoother and more reliable experience across a broader range of hardware and operating system versions. --- ##### ⚡ Performance & Stability Improvements This release also includes continued optimizations focused on responsiveness and reliability throughout the app. Improvements include: - Faster screen rendering - Improved responsiveness during large data operations - Better memory management - Reduced interface lag - General bug fixes and stability enhancements --- 📱 Application: Al Islam 🏷️ Version: **4.1 — Chronicled** 🗓️ Release Date: **May 09, 2026** ### v4.0 — Elevated (2026-04-30) #### Al Islam — Version 4.0 ##### Elevated ✨ 📅 Release Date: April 30, 2026 Version 4.0 represents the most ambitious and transformative release in the history of Al Islam — a complete evolution of the platform designed to deliver a faster, smarter, and more scalable Islamic experience for years to come. This update introduces a fully modernized foundation, major improvements to collections and prayer systems, optional cloud capabilities, enhanced customization, and extensive usability refinements throughout the app. --- #### A Completely Reimagined Foundation ##### ⚙️ Fully Rebuilt Architecture Al Islam has been completely rebuilt from the ground up using a modern, modular, and scalable architecture. Every major layer of the application — including the interface, data handling systems, and content infrastructure — has been redesigned to improve: - Reliability - Performance - Scalability - Long-term maintainability - Future feature expansion The underlying data architecture has also been elevated to support improved integrity, compatibility, synchronization readiness, and future cloud-connected capabilities. This new foundation enables significantly faster feature delivery, smoother updates, and a more refined experience moving forward. --- #### Resource & Content System Updates ##### 📦 Resource Packs Rebuilt All downloadable content packs and backend resources have been fully updated to support the new infrastructure introduced in Version 4.0. This includes improvements to: - Content organization - Data compatibility - Resource handling efficiency - Future scalability ###### Important Compatibility Note To ensure compatibility with the new system: - Existing downloadable resource packs must be redownloaded - Collections and personal user data will migrate automatically - No manual migration steps are required - Existing collection data remains safe and preserved Support for Version 3.0 resources remains temporarily available, though updating to Version 4.0 is strongly recommended for the best experience. --- #### Cloud Features & Authentication ##### ☁️ Cloud Backup & Sync Collections now support optional cloud backup and synchronization across devices. Users can: - Enable cloud backup - Trigger manual synchronization - Use automatic syncing for continuous backup protection - Restore collections across supported devices Al Islam remains a fully offline-first application, and all cloud functionality is completely optional. Offline functionality continues to work independently without requiring an account or internet connection. ###### Premium Feature Availability Cloud backup and synchronization are available as part of the Premium Plan. --- ##### 🔐 Optional Authentication Authentication support has been introduced to power cloud-based features and future account-connected experiences. Key principles include: - Sign-in remains entirely optional - Core app functionality works fully offline without an account - Future account-based features will always remain permission-based and transparent This infrastructure lays the groundwork for more personalized experiences in future updates. --- #### Collections System Improvements ##### 📁 Advanced Collection Enhancements The Collections system has received major usability, reliability, and workflow improvements. Enhancements include: - Improved multi-item selection - New copy functionality - Collection search support - Better organization workflows - Improved handling of edge cases and error scenarios - Enhanced overall responsiveness and stability These refinements create a smoother and more reliable content management experience across large and complex collections. --- #### Prayer Times & Location Profiles ##### 📍 Location Profiles Prayer Times now supports fully independent Location Profiles. Each profile can maintain its own: - Timezone - Prayer calculation method - Madhab preferences - Date adjustments - Time formatting preferences - Display title and metadata - Additional prayer-related configurations The system has also been redesigned to intelligently configure many settings automatically based on the selected location. --- ##### 🌐 Advanced Geolocation & Timezone Detection Location handling has been significantly improved with enhanced geocoding and timezone intelligence. Enhancements include: - Improved location detection - Accurate timezone resolution - Automatic country recognition - Local and cloud-assisted geocoding support - Manual customization controls when needed All location-related data remains locally managed unless cloud-connected features are explicitly enabled. Users can also: - Create custom titles for profiles - Override timezones manually - Adjust prayer calculation settings independently per profile --- ##### 🕌 Expanded Prayer Calculation Controls Each Location Profile now supports extensive calculation customization options, including: - Selection from 11 prayer calculation methods - Asr standard override support (Hanafi / Shafi) - High altitude rule configuration - Prayer time rounding preferences - Twilight definition adjustments - Hijri date offset customization These controls provide greater flexibility for users across different regions, schools of thought, and personal preferences. --- ##### 🕓 High Altitude Rule Support Supported High Altitude Rule options now include: - None - Middle of the Night - Seventh of the Night - Twilight This improves prayer time accuracy in regions with complex sunrise and sunset conditions. --- ##### ⏱️ Time Rounding Options Prayer time rounding preferences can now be configured with support for: - None - Nearest - Up This allows users to tailor displayed timings according to personal preference. --- ##### 🌅 Twilight Definition Controls Users can now customize Twilight Definitions with support for: - General - Ahmar - Abyad These options provide additional flexibility for advanced prayer time calculation preferences. --- ##### 🌍 Redesigned Timezone Selector The timezone selector has been completely redesigned for faster and clearer navigation. Users can now search timezones using: - GMT offset - Country - Timezone name - Timezone identifier - Current local time This significantly simplifies timezone selection and verification. --- #### User Experience Improvements ##### ✨ General UX & Handiness Improvements Numerous refinements have been made throughout the app to improve usability, consistency, and responsiveness. Enhancements include: - More intuitive controls and selectors - Improved navigation consistency - Better handling of large datasets - Smarter search experiences - Cleaner interaction flows - Improved responsiveness across complex interfaces These updates contribute to a more polished and fluid overall experience. --- #### Premium Plan ##### 💎 Premium Features Version 4.0 introduces the new Premium Plan, linked securely to user accounts. Premium benefits currently include: - Cloud backup & synchronization across devices - Unlimited saved Location Profiles - Early access to upcoming features and improvements Additional premium capabilities may be introduced in future releases. --- #### Temporary Changes ##### 🕘 History Section Temporarily Disabled The History Section has been temporarily disabled while a redesigned and more capable replacement system is being developed. A significantly improved version of the feature is planned for an upcoming release. --- #### Stability & Performance ##### ⚡ Performance Improvements & Bug Fixes This release also includes extensive optimizations and reliability improvements throughout the app. Enhancements include: - Improved performance across modern devices - Better overall responsiveness - Reduced interface lag - Stability improvements across multiple sections - Bug fixes and infrastructure refinements --- 📱 Application: Al Islam 🏷️ Version: **4.0 — Elevated** 🗓️ Release Date: **April 30, 2026** ### v3.0 — Reloaded (2025-07-03) #### Al Islam — Version 3.0 ##### Reloaded 🚀 📅 Release Date: July 03, 2025 Version 3.0 marks a foundational shift for the app — not just in terms of features, but also architecture, flexibility, and how content is structured, delivered, and interacted with. This changelog provides a full breakdown of what’s new, what’s changed, and what’s coming soon. --- ##### 🕋 Quran Section ###### 🗣️ **Multi-Translation Support (with Scholar Metadata)** Previously, translations were limited to one per language (23 languages total). In this update: - Translations have been expanded to **37 languages** - Many languages now offer **multiple translations**, categorized by scholar - Each translation includes **metadata**: scholar name, language, and other relevant info - The data model has been restructured to allow easier access and future expansion This makes the Quran section richer, more diverse, and easier to navigate based on user preference. **Translations** 1. Maulana Fateh Muhammad Jhalandari - Urdu 2. Maulana Sayed Abu Ala Maududi - Urdu 3. Mufti Muhammad Taqi Usmani - Urdu 4. Sahh International - English 5. Maulana Muhammad Junagari - Urdu 6. Dr. Israr Ahmad - Urdu 7. Imam Ahmad Raza Khan - Urdu 8. Maulana Amin Ahsan Islahi - Urdu 9. Dr. Tahirul Qadri - Urdu 10. Maulana Abdus Salam - Urdu 11. Dr. Muhammad Aslam Siddiqui - Urdu 12. Allama Jawadi - Urdu 13. Muhammad Hussain Najafi - Urdu 14. Mrs. Riffat Ijaz - Urdu 15. Abdullah Yousaf Ali - English 16. Mufti Muhammad Taqi Usmani - English 17. Maulana Sayed Abu Ala Maududi - English 18. Safiur Rahman Mubarakpuri - English 19. Muhammad Marmaduke Pickthall - English 20. Muhammad Sarwar - English 21. Muhammad Habib Shakir - English 22. Suleyman Ates - Turkish 23. Alİ Bulaç - Turkish 24. Diyanet Isleri - Turkish 25. Abdulbaki Golpinarli - Turkish 26. Yasar Nuri Ozturk - Turkish 27. Diyanet Vakfi - Turkish 28. Elmalili Hamdi Yazir - Turkish 29. Suat Yildirim - Turkish 30. Edip Yüksel - Turkish 31. Hussain Ansarian - Persian 32. Abolfazl Bahrampour - Persian 33. Mohammad Mahdi Fooladvand - Persian 34. Mohsen Gharaati - Persian 35. Mahdi Elahi Ghomshei - Persian 36. Baha'oddin Khorramshahi - Persian 37. Mostafa Khorramdel - Persian 38. Naser Makarem Shirazi - Persian 39. Mohammad Kazem Moezzi - Persian 40. Sayyed Jalaloddin Mojtabavi - Persian 41. Mohammad Sadeqi Tehrani - Persian 42. Sayyed Mohammad Reza Safavi - Persian 43. Muhiuddin Khan - Bengali 44. Zohurul Hoque - Bengali 45. Abu Rida Muhammad ibn Ahmad ibn Rassoul - German 46. A. S. F. Bubenheim and N. Elyas - German 47. Adel Theodor Khoury - German 48. Amir Zaidan - German 49. Raúl González Bórnez - Spanish 50. Julio Cortes - Spanish 51. Muhammad Isa García - Spanish 52. Muhammad Hamidullah - French 53. Muhammad Farooq Khan and Muhammad Ahmed - Hindi 54. Suhel Farooq Khan and Saifur Rahman Nadwi - Hindi 55. Indonesian Ministry of Religious Affairs - Indonesian 56. Muhammad Quraish Shihab et al - Indonesian 57. Hamza Roberto Piccardo - Italian 58. Abdullah Muhammad Basmeih - Malay 59. Salomo Keyzer - Dutch 60. Fred Leemhuis - Dutch 61. Sofian S. Siregar - Dutch 62. Einar Berg - Norwegian 63. Józefa Bielawskiego - Polish 64. Abdulwali Khan - Pashto 65. George Grigore - Romanian 66. Mahmud Muhammad Abduh - Somali 67. Sherif Ahmeti - Albanian 68. Hasan Efendi Nahi - Albanian 69. Jan Turst Foundation - Tamil 70. Ma Jian - Chinese 71. Ma Jian (Traditional) - Chinese 72. Muhammed Sadiq and Muhammed Sani Habib - Amharic 73. Vasim Mammadaliyev and Ziya Bunyadov - Azerbaijani 74. Alikhan Musayev - Azerbaijani 75. Ramdane At Mansour - Amazigh 76. Tzvetan Theophanov - Bulgarian 77. Besim Korkut - Bosnian 78. Mustafa Mlivo - Bosnian 79. A. R. Nykl - Czech 80. Office of the President of Maldives - Divehi 81. Abubakar Mahmoud Gumi - Hausa 82. Burhan Muhammad-Amin - Kurdish 83. Samir El-Hayek - Portuguese 84. Abu Adel - Russian 85. Muslim Religious Board of the Republiс of Tatarstan - Russian 86. Ignaty Yulianovich Krachkovsky - Russian 87. Elmir Kuliev - Russian 88. V. Porokhova - Russian 89. Gordy Semyonovich Sablukov - Russian 90. Knut Bernström - Swedish 91. Ali Muhsin Al-Barwani - Swahili 92. AbdolMohammad Ayati - Tajik 93. Muhammad Saleh - Uyghur 94. Muhammad Sodik Muhammad Yusuf - Uzbek 95. Preklad I. Hrbek - Czech ###### 📚 **Tafsir Support (Verse Explanations)** Tafsir (exegesis or commentary) helps provide deep context for Quranic verses. This update introduces: - Dedicated Tafsir support - Available in **multiple languages**, with **multiple Tafsir entries per language** where available - Seamless switching between translation and Tafsir modes - **10 Tafsir packs** added (currently in Urdu and English) This builds the groundwork for deeper engagement with the Quran. **Tafsir** 1. Tafsir Ibn Kathir - Urdu 2. Tafheem-ul-Quran - Urdu 3. Bayān al-Qur’ān - Urdu 4. Aasaan Qur’an - Urdu 5. Ahsan-ul-Bayan - Urdu 6. Tafsir Ibn Kathir - English 7. Ma’ariful Qur’an - Urdu 8. Ma’ariful Qur’an - English 9. Tafheem-ul-Quran - English 10. Tayseer-ul-Qur’an - Urdu ###### 📖 Multi-Translation & Tafsir Preview Experience The ayah preview now allows users to select and view multiple translations and Tafsirs simultaneously within a clean, modern, and user-friendly layout. The interface supports instant drag-and-drop reordering, making it incredibly simple to prioritize your preferred texts by sliding them up or down. Users can also fluidly swipe between dedicated Translation and Tafsir modes, enjoying a seamless, handy navigation experience that includes frictionless jumping directly between verses. ###### 📖 Enhanced Reference Tracking The app now features an advanced referencing engine that provides unparalleled clarity when exploring Hadith and Quranic citations. References have become richer and more informative while maintaining a highly readable layout, allowing users to instantly track their reading journey through sleek visual progress bars that show exactly how far they have come and what remains. For instance, when looking at a Hadith, a single, intuitive metric block elegantly displays the exact Hadith number within its specific chapter, the current chapter number relative to the total chapters in the book, and its precise sequential position. These dense yet incredibly clear visual statistics bring a new level of context and convenience to every verse and narration you study. --- ##### 🕰️ Prayer Times Section Completely rewritten with a focus on flexibility, privacy, and accuracy. ###### 📍 **Flexible Location Setup** Users now have multiple ways to configure their prayer location: - Use precise GPS (as before) - Search by address (geocoding) - Enter coordinates manually This is especially helpful for privacy-conscious users or those in less-mapped regions. ###### 🌐 **Manage & Switch Between Multiple Locations** Users can now: - Save multiple locations - Rename, edit, or delete any saved location - Easily switch between saved profiles Ideal for users who travel or want to track times for family in different regions. ###### 🕓 **Time Zone Handling** - Time zone is automatically detected based on coordinates - Can be manually overridden for custom use cases - Resets easily back to default detection with one tap - Time zone is saved per-location and applied across the app Timezone management is now a fully integrated core configuration of the app, ensuring absolute consistency across every single feature. Any changes instantly reflect everywhere—from calendar dates to precise prayer times and general time stamps. Users can easily update this setting via an intuitive selection dialog that simplifies the choice by clearly presenting their current device system timezone, the geographical location timezone, and the active timezone currently applied to the app. ###### 📅 **Date-Based Timing View with Hijri Sync** - View prayer timings for **any day**, past or future - Built-in calendar picker makes date selection easy - Islamic calendar (Hijri) updates alongside Gregorian selection - Reset to today with one tap This makes planning, reviewing, and learning easier. Introduced a significantly enhanced prayer times experience ✨ Users can now view the current prayer status, remaining time for the active prayer, and countdowns to upcoming prayers with live clock counters, dynamic progress bars, and real-time prayer status indicators. --- ##### 📁 Collections Section — Now a True File Manager The bookmarks/collections section has been **fully redesigned**, transforming it into a file manager-like experience for your saved Islamic content. ###### 🏠 **Root-Based, No Default Folder** - No mandatory "Bookmarks" folder anymore - Users start from a clean root space - Items (Hadith, Ayahs, etc.) can be saved directly in the root or inside folders ###### 🗂️ **Unlimited Nesting & Hierarchies** - Create folders inside folders without limits - Design your collection structure however you like - Example: `/Hadith/Sahih Bukhari/Charity/Reminders` ###### 🗃️ **Save in Multiple Locations** - One item (e.g., a Hadith) can exist in **multiple folders** — just like copying a file - Ideal for organizing the same reference under different topics. with your very own titles and metadata. ###### 🔧 **File Manager-Like Controls** - Select multiple items - Bulk move, copy, delete, rename - Reorganize layout as you grow your content This redesign unlocks complete control over how users store, revisit, and study Islamic material. --- ##### 📝 A Note on Infrastructure & Requests ###### 📊 **App Infrastructure Rewritten** - App rebuilt using modern architecture (Android Industry standard Compose, MVVM, scalable schema, etc.) - Improved modularity, future-proofing, and maintainability - A completely live and reactive experience. ###### 🔖 **Hadith Labels (Grading)** - Labels like *Sahih*, *Da'if* are being added **gradually** - Some books already have them, others will follow as verified data becomes available ###### 🌍 **In-App Language Selection (UI)** - Currently under consideration - Would allow changing app UI language (not just content language) - We're exploring proper localization for future updates --- ##### 🚧 Temporarily Disabled or Sunset Features ###### 🔍 **Search Functionality** In older versions: - Users could search by text, regex, or reference In v3.0: - **Only reference-based search remains active** (for both Quran and Hadith) - Text & regex search are disabled **temporarily** as we rebuild the system They will return with a more refined, accurate engine soon. ###### 📦 **Data Packs / Expansion Downloads** Due to schema restructuring: - Existing data packs (books, translations, Tafsir) are **no longer compatible** - Users must **redownload** them from within the app - First-time access will prompt for redownload --- 📱 Application: Al Islam 🏷️ Version: **3.0 — Reloaded** 🗓️ Release Date: **July 03, 2025** ### v2.5 — Ramadan Special (2024-03-26) #### Al Islam — Version 2.5 ##### Ramadan Special 🌙 📅 Release Date: March 27, 2024 The Ramadan Special update introduces major enhancements to note formatting, content organization, and history management, alongside continued improvements to performance, compatibility, and overall app stability. This release focuses on providing a richer and more flexible reading and study experience throughout the app. --- #### New Features & Enhancements ##### ✍️ Advanced Formatting Support Rich Markdown and HTML formatting support has now been introduced for Notes and supported content views. Users can now create more structured, expressive, and organized content using a wide range of formatting options, including: - Images - Tables - Checklists - Ordered and unordered lists - Bullet points and numbering - Multiple heading styles - Inline and reference links - Blockquotes - Code blocks - Horizontal dividers - Bold, italic, underline, and strikethrough formatting - Superscript and subscript text - HTML entities and extended formatting support These enhancements provide greater flexibility for personal notes, study references, structured content organization, and detailed Islamic research workflows. The formatting system has been designed to maintain readability while offering advanced customization capabilities within the app experience. --- ##### 🕘 Enhanced History Section The History Section has been further improved with enhanced filtering and tracking capabilities. Users can now navigate and analyze previously viewed content more efficiently through improved history management tools and refined organization. Enhancements include: - Improved activity filtering - Better history organization - Faster access to previously viewed content - Enhanced tracking and navigation controls - Improved readability of historical activity records These refinements make it easier to revisit content, continue previous reading sessions, and manage activity history more effectively. --- #### Performance & Stability ##### ⚡ Performance Improvements & Bug Fixes This release also includes multiple optimizations focused on improving app responsiveness, reliability, and compatibility across modern devices. Improvements include: - General bug fixes and stability enhancements - Improved app responsiveness - Better performance across large content sections - Enhanced compatibility with newer Android devices and operating system versions - Refinements to overall interface smoothness and usability Additional polishing and usability improvements have also been applied throughout the app experience. --- 📱 Application: Al Islam 🏷️ Version: **2.5 — Ramadan Special** 🗓️ Release Date: **March 27, 2024** ### v2.4 — Prayer+ (2024-02-11) #### Al Islam — Version 2.4 ##### Prayer+ 🕌 📅 Release Date: February 11, 2024 The Prayer+ update introduces one of the most requested additions to the app with the launch of a fully offline Prayer Times system, alongside enhanced search capabilities, advanced color customization tools, and broader interface improvements. This release focuses on accuracy, flexibility, and a more personalized daily Islamic experience. --- #### New Features & Enhancements ##### 🕰️ Offline Prayer Times Prayer Times support has now been fully integrated into the app with offline accessibility and high-precision astronomical calculations. After granting location access, users can view accurate prayer schedules without requiring an active internet connection. Key features include: - Fully offline prayer time support - Accurate location-based calculations - Automatic timezone and regional adjustments - Prayer start and end times - Sunnah and night-based timings - 12-hour (AM/PM) and 24-hour time format support The app also intelligently recommends suitable calculation methods and jurisprudence preferences based on the user’s region while still allowing complete manual customization. --- ##### 🌍 Supported Prayer Calculation Methods Al Islam now supports multiple internationally recognized prayer calculation methods, including: 1. Muslim World League 2. Egyptian General Authority of Survey 3. University of Islamic Sciences, Karachi 4. Umm al-Qura University, Makkah 5. General Authority of Islamic Affairs and Endowments (UAE) 6. Moonsighting Committee Worldwide (MCW) 7. Islamic Society of North America (ISNA) 8. Ministry of Awqaf and Islamic Affairs, Kuwait 9. Ministry of Endowments and Islamic Affairs, Qatar 10. Majlis Ugama Islam Singapura (MUIS) 11. Diyanet İşleri Başkanlığı, Turkey Support for different schools of thought, including Hanafi and Shafi methodologies, has also been included for more personalized calculations. --- ##### 🌙 Included Prayer & Islamic Time Indicators The Prayer+ section includes detailed timings for: - Fajr - Sunrise - Dhuhr - Asr - Maghrib - Isha - Islamic Midnight - Last Third of the Night These additions provide a more comprehensive daily prayer and worship experience. --- ##### 🔍 Search by Regular Expression (Regex) A new advanced search method, “Search by Regex,” has been introduced for more precise and flexible content discovery. This feature allows users to: - Search using pattern-based expressions - Perform advanced Hadith and Quran searches - Find content beyond exact keyword matching - Improve search precision across large collections This enhancement is especially useful for advanced research and detailed content exploration. --- ##### 🎨 Advanced Color Adjustment The Text Adjustment section has been expanded with advanced color customization controls. Users can now personalize text appearance using: - Hue controls - Saturation controls - Brightness adjustment - Alpha (transparency) support - Custom color code input These additions provide more flexibility for creating comfortable and personalized reading environments across the app. --- #### User Experience Improvements ##### 🖥️ Refined User Interface The user interface has been further refined to improve readability, accessibility, and overall navigation throughout the app. Enhancements include: - Improved navigation flow - Cleaner visual presentation - Better interaction consistency - More responsive layouts - Enhanced reading comfort across sections These refinements contribute to a smoother and more polished overall experience. --- ##### ⚡ Performance Improvements & Stability This update also includes extensive performance optimizations and stability improvements across multiple areas of the app. Improvements include: - Faster loading times - Improved scrolling performance - Better responsiveness during heavy usage - Reduced interface lag - General bug fixes and reliability enhancements --- 📱 Application: Al Islam 🏷️ Version: **2.4 — Prayer+** 🗓️ Release Date: **February 11, 2024** ### v2.3 — 2024 Edition (2024-01-04) #### Al Islam — Version 2.3 ##### 2024 Edition ✨ 📅 Release Date: January 04, 2024 The 2024 Edition introduces major personalization enhancements, expanded typography support, improved search capabilities, and continued refinements to the reading experience across the app. This update focuses on delivering greater flexibility, deeper customization, and a smoother overall user experience. --- #### New Features & Enhancements ##### 🎨 Advanced Text Customization A dedicated Text Adjustment section has now been introduced, providing extensive control over text appearance and reading preferences across the app. Users can now customize text settings independently for different sections and languages, allowing for a more personalized and accessible reading experience. Customization options include: - Adjustable font size - Line spacing and letter spacing controls - Multiple built-in font selections - Bold, italic, underline, and text case formatting - Real-time preview while adjusting settings These controls are supported across multiple reading interfaces, including: - Hadith previews - Hadith listings - Chapter views - Quran sections - Random hadith screens - Additional content views Language-specific enhancements have also been added, including Arabic diacritic (A‘rab) visibility controls for more flexible Arabic reading preferences. The Text Adjustment system has been designed to provide advanced customization while maintaining a clean, intuitive, and easy-to-use interface. --- ##### 🔤 Custom Font Support Support for importing custom fonts has now been added. Users can now: - Import third-party TrueType fonts (.ttf) - Assign custom font names - Organize fonts by preferred language - Rename or remove imported fonts - Persist custom font selections across the app The app also continues to include a collection of built-in fonts optimized for commonly used languages and scripts. This enhancement provides significantly greater flexibility for users who prefer personalized typography and reading styles. --- ##### 📚 Mustadrak Al-Hakim Added The collection library has been further expanded with the addition of **Al-Mustadrak Al-Hakim**. Currently available languages include: - Arabic - Urdu > Additional language support and expanded resources are planned for future updates as the collection continues to grow. --- ##### 🔍 Search by Text (Exact) A new “Search by Text (Exact)” method has been introduced to provide more precise and refined content discovery. This feature allows users to: - Search using exact keywords or phrases - Search across Hadith collections and Quran content - Filter searches by specific books - Select preferred languages and scripts - Narrow down results for more accurate matching This enhancement significantly improves content accessibility and makes finding specific hadiths or verses faster and more efficient. --- #### User Experience Improvements ##### 🖥️ Enhanced Interface & Navigation The user interface has been further refined to improve usability, readability, and navigation consistency across the app. Enhancements include: - Cleaner visual presentation - Improved navigation flow - Better responsiveness across screens - More polished reading layouts - Enhanced interaction consistency These refinements contribute to a smoother and more modern overall experience. --- ##### ⚡ Performance Improvements & Stability This release also includes multiple optimizations focused on improving performance and reliability throughout the app. Improvements include: - Faster content loading - Improved scrolling responsiveness - Better memory and resource handling - Reduced interface lag - General bug fixes and stability enhancements --- 📱 Application: Al Islam 🏷️ Version: **2.3 — 2024 Edition** 🗓️ Release Date: **January 04, 2024** ### v2.2 — Quranic Edition (2023-11-25) #### Al Islam — Version 2.2 ##### Quranic Edition 📖 📅 Release Date: November 25, 2023 This release marks a major milestone for the app with the introduction of a fully integrated Quran section, transforming the experience beyond hadith collections into a more comprehensive Islamic learning platform. The update also includes multilingual Quran support, enhanced navigation, improved note formatting, and overall performance refinements. --- #### Major New Addition ##### 📖 Quran with Multilingual Support The app now includes a dedicated Quran section with support for translations in **23 languages**, providing a more accessible and inclusive reading experience for users around the world. The Quran section has been carefully structured for ease of navigation and comfortable reading, featuring: - Organized Surah and Juz/Parah browsing - Dedicated bookmarks and favorites section - Smooth scroll-based reading experience - Verse preview with detailed references - Swipe-based verse navigation - Rapid reference navigation controls - Direct verse and Surah jump functionality The experience has been designed to balance advanced functionality with a clean, modern, and intuitive interface, ensuring accessibility without compromising usability. --- ##### 🌍 Supported Quran Translation Languages The Quran section currently supports the following translation languages: 1. Albanian 2. Bangla 3. Chinese 4. Dutch 5. French 6. German 7. Hindi 8. Indonesian 9. Italian 10. Malay 11. Malayalam 12. Norwegian 13. Pashto 14. Persian 15. Polish 16. Romanian 17. Russian 18. Sindhi 19. Somali 20. Spanish 21. Tamil 22. Turkish 23. Urdu This multilingual expansion enables users to explore Quranic teachings in their preferred language while maintaining a structured and consistent reading experience throughout the app. --- #### Enhanced Reading Experience ##### ✍️ Formatted Notes The Notes experience has been enhanced with support for rich text formatting and improved organization tools. Users can now create more structured and readable notes using formatting options such as: - Bold text - Italic text - Strikethrough formatting - Symbol-based organization - Improved content structuring These enhancements make personal reflections, study notes, and research references easier to organize and revisit. > Additional note formatting improvements and advanced editing capabilities are planned for future updates. --- #### Performance & Reliability ##### ⚡ Improved Performance This release also includes a wide range of optimizations aimed at improving overall app responsiveness and stability. Enhancements include: - Faster navigation and loading times - Improved scrolling performance - Better responsiveness across content-heavy sections - General stability improvements - Bug fixes and reliability enhancements These refinements contribute to a smoother and more seamless reading experience throughout the app. --- 📱 Application: Al Islam 🏷️ Version: **2.2 — Quranic Edition** 🗓️ Release Date: **November 25, 2023** ### v2.1 — Supreme Update (2023-10-12) #### Al Islam — Version 2.1 ##### Supreme Update ✨ 📅 Release Date: October 12, 2023 This update delivers one of the largest content expansions in the app’s history, alongside major improvements to references, bookmarking, multilingual accessibility, and overall performance. --- #### Major Content Expansion ##### 📚 Expanded Hadith Library The hadith collection has been significantly expanded with the addition of **13 new Hadith collections**, complementing the existing major hadith books (Sihah Sitta). This expansion introduces a broader and more comprehensive Islamic library experience with improved organization, multilingual accessibility, structured references, and enhanced navigation throughout the app. ###### Newly Added Collections 1. **Mishkat Al-Masabih** Supported Languages: Arabic, English, Urdu, Hindi 2. **Al-Silsila Al-Sahiha** Supported Languages: Arabic, Urdu 3. **Muwatta Imam Malik** Supported Languages: Arabic, English, Urdu 4. **Muwatta Imam Muhammad** Supported Languages: Arabic, Urdu 5. **Ma'arif-ul-Hadith** Supported Languages: Arabic, Urdu 6. **Shamail Tirmidhi** Supported Languages: Arabic, English, Urdu 7. **Sahifa Hammam ibn Munabbih** Supported Languages: Arabic, Urdu 8. **Sunan Al-Darimi** Supported Languages: Arabic, Urdu 9. **Sunan Al-Daraqutni** Supported Languages: Arabic, Urdu 10. **Musannaf Ibn Abi Shaybah** Supported Languages: Arabic, Urdu 11. **Sharh Ma‘ani al-Athar (Al-Tahawi)** Supported Languages: Arabic, Urdu 12. **Musnad Ahmad** Supported Languages: Arabic, Urdu 13. **Sunan Al-Kubra** Supported Languages: Arabic, Urdu --- ##### ⬇️ Flexible Book Downloads To improve storage management and accessibility, books can now be downloaded individually based on your preferences. Key improvements include: - Selective book downloads - On-demand content access - Improved download management - Reduced initial app size Sahih al-Bukhari remains available by default during initial installation, while additional collections can be downloaded anytime within the app. --- #### Enhanced Reading & Collection Experience ##### 🔗 Responsive Hadith References The Notes section within Collections has been enhanced with support for interactive hadith references. You can now reference other hadiths directly within your notes, allowing linked references to become interactive and accessible with a single tap. This enhancement enables: - Faster cross-referencing between hadiths - Improved contextual study - Easier navigation across collections and books - A more connected reading and research experience --- ##### ❤️ Fav-in-Fav Collections A new “Fav-in-Fav” feature has been introduced for quicker access to your most important saved hadiths. This functionality allows you to: - Highlight selected bookmarks within collections - Create a focused layer of favorite saved items - Access priority bookmarks without reorganizing collections This provides a faster and more convenient way to revisit frequently referenced hadiths while preserving your existing collection structure. --- ##### 🌍 Enhanced Language Experience Language setup and multilingual handling within Collections and bookmarked content have been refined for a smoother and more intuitive experience. Enhancements include: - Improved language synchronization - Better multilingual content handling - More consistent section-based language preferences - Enhanced readability across supported languages --- #### Performance & Stability ##### ⚡ Performance Improvements This release also includes multiple under-the-hood optimizations focused on improving overall reliability and responsiveness. Improvements include: - Faster content loading - Improved navigation responsiveness - Enhanced download handling - Better memory and resource management - Stability improvements across multiple sections of the app --- 📱 Application: Al Islam 🏷️ Version: **2.1 — Supreme Update** 🗓️ Release Date: **October 12, 2023** ### v2.0 — Mega Update (2023-09-22) #### Al Islam — Version 2.0 ##### Mega Update 🚀 📅 Release Date: September 21, 2023 Version 2.0 introduces one of the largest upgrades to the app experience so far, focused on organization, personalization, multilingual accessibility, and overall usability improvements. This update significantly expands the reading experience while maintaining a clean, modern, and user-friendly interface. --- #### New Features & Enhancements ##### 📚 Collection Management A fully redesigned Collection system has been introduced, providing a more organized and flexible way to manage bookmarked hadiths. With Collections, you can now: - Create custom folders and collections - Save bookmarks into specific collections - Move bookmarks between collections - Add and manage personal notes for bookmarked hadiths - Edit collection notes independently - View bookmark and note modification timestamps - Remove individual bookmarks or entire collections with ease The Collection system also includes backup and restore support, allowing you to: - Export collections as backup files - Import previously saved backups - Share collection backups across devices This enhancement provides a more structured and reliable way to organize and preserve your saved content. --- ##### 🔀 Random Hadith Experience The Random Hadith section has been enhanced to provide a more dynamic and personalized reading experience. Users can now customize various aspects of the reading interface, including: - Text size - Line spacing - Letter spacing - Text formatting preferences The feature also adapts to your selected language preferences and dynamically displays supported resources accordingly, creating a smoother and more personalized experience while exploring Islamic teachings. --- ##### 🌍 Multilingual Support The app now provides improved multilingual support across multiple sections and content views. Supported languages include: - Arabic - English - Urdu - Hindi - Bangla Language preferences can now be configured independently for different sections of the app, allowing greater flexibility and personalization. For example: - Arabic for hadith previews - English for random hadiths - Urdu for selected reading sections This enhancement helps create a more customizable and accessible reading environment while maintaining a polished and intuitive user experience. --- ##### 📖 Expanded Hadith References Hadith references have been significantly expanded to provide richer context and easier navigation. Additional reference details now include: - Book references - Chapter references - Narrator information - Kitab and Baab details - Hadith gradings - Related classifications These improvements provide deeper context for study, research, and content exploration. --- ##### 🕘 Reading History A new History section has been introduced to help users keep track of recently viewed and read content. Features include: - Automatic local history tracking - Timestamp-based activity records - Quick navigation back to previously viewed content - Section-specific activity history Users can also: - Clear history manually at any time - Configure automatic cleanup rules - Set limits based on time or entry count - Apply different limits for individual sections This provides better continuity across reading sessions while giving users more control over stored activity data. --- #### Additional Improvements ##### ⬇️ Background Downloads Background downloading support has been added for a smoother and more seamless content experience. Users can now continue using the app while downloads proceed in the background without interrupting ongoing activity. --- ##### 🎨 Text Adjustment Controls Text appearance customization has been expanded for hadith reading views, providing greater flexibility and readability controls. Available customization options include: - Adjustable font size - Letter spacing and line spacing controls - Text color customization - Bold and italic formatting - Arabic diacritic (A‘rab) visibility controls - Uppercase toggling options - Independent visibility controls for Arabic and translation content These enhancements allow users to tailor the reading experience according to their personal preferences and accessibility needs. --- ##### ⚙️ Custom Language Preferences Language settings have been further refined to support section-specific and book-specific customization. This allows users to configure language preferences independently across different content areas for a more flexible multilingual experience. --- ##### 🖥️ User Interface Improvements The user interface has been extensively redesigned and expanded to improve navigation, accessibility, and usability throughout the app. Enhancements include: - Improved screen organization - Expanded section accessibility - Cleaner navigation flow - Additional utility and informational views - Better overall layout consistency Additional supporting features such as current timings, Gregorian dates, and Islamic calendar information have also been integrated into the experience. --- ##### ⚡ Performance Improvements & Stability This update also includes significant under-the-hood optimizations focused on performance, compatibility, and reliability. Improvements include: - Faster content loading - Improved app responsiveness - Better handling of edge cases - Enhanced compatibility with modern Android devices and operating systems - General bug fixes and stability enhancements --- 📱 Application: Al Islam 🏷️ Version: **2.0 — Mega Update** 🗓️ Release Date: **September 21, 2023** ## FAQ **Is Al Islam free to use?** **Yes — and more of it is free than most people expect.** The entire Quran, all 33 Hadith collections, prayer times, the Qibla finder, the Hijri calendar, the tasbeeh counter, notes, search, collections, reading history and home screen widgets are all free, forever. **Al Islam Premium** is an optional subscription that removes ads and adds: * **Intelligence** — the AI layer that translates, explains and reads aloud any passage in the app * **Cloud backup** for your Collections across devices * **Unlimited** location profiles and imported fonts * **Early access** to new collections and features Full details on the [Premium page](/docs/premium). **Do I need an account?** You can read without an account. Everything essential — the Quran, Hadith, prayer times, Qibla, the calendar, tasbeeh, notes and search — works fully without signing in. Signing in lets you back up and sync your **Collections**, including the notes inside them, across your devices, and manage your Premium subscription. Your reading history, tasbeeh records, calendar data and app settings always stay on your device, whether you sign in or not. **Does the app work offline?** Yes — almost entirely. Reading the Quran and Hadith, prayer times, Qibla, the Hijri calendar, tasbeeh, notes, search, collections and history all work with no connection once your content is downloaded. Downloading new collections, cloud sync, subscription checks and AI features need a connection. **Which languages are supported?** The hadith are available in 5 including Arabic, English, Urdu, Hindi and Bangla, and the Quran is available in **62 languages** (122 translations and 95 tafsir works). We add more with every update. You can see complete details here - [Hadith Collections](/library) - [Quran Resources Catalog](/quran) **Is there an iPhone or iPad version?** Not currently. Al Islam is built for Android phones and tablets, and since version 4.4 for the Android home screen through widgets. **Is there a website or desktop version?** This site hosts our documentation and resource catalogues. The app itself is Android-only for now. **How much storage does the app need?** The app itself is modest, and content is downloaded only when you ask for it. Each Hadith collection and Quran translation you download adds to that, so storage grows with what you choose to keep. You can remove any downloaded content at any time. **What exactly does Premium include?** Premium unlocks four things: * **Intelligence** — the full AI suite: translate any passage, ask questions about it, hear it read aloud, dictate into your notes * **No advertising** — no interstitials, no banners * **Cloud backup** — your Collections and the notes inside them, synced across devices * **No limits** — unlimited prayer time location profiles and imported fonts, plus early access to new content Everything else in the app is free and always will be. See the [Premium page](/docs/premium). **How do I cancel Premium?** Premium is billed through Google Play. Cancel anytime under **Subscriptions** in the Play Store — access continues until the end of the billing period. **Note:** uninstalling the app does not cancel a subscription. A subscription belongs to your Google account, so it must be cancelled through Google Play. **Does Premium include the AI usage, or do I pay separately?** Premium unlocks the Intelligence **suite** — the interface, routing, library and dictation. The AI models themselves run on **your own provider account**, billed by that provider directly to you. We do not resell model access, so there is no markup, no bundle of credits, and none to run out of. It also means the cost is yours to control — and can be **nothing at all**, since several supported providers run locally on your own machine with no key and no bill. **How many ads does the free version show?** **At most five full-screen ads per day**, and that is a hard limit the app enforces rather than an intention. There is a minimum gap between them, and the first couple of screens after you open the app are never interrupted. After each one, the app tells you which ad of the five it was. Premium removes advertising entirely. **What happens to my content if I stop paying?** Nothing is deleted. Notes, collections, saved translations, your own AI commands and every configuration stay exactly where they are. Premium features stop working; your data remains yours and stays on your device. Resubscribing restores everything. **What is Intelligence?** Intelligence is Al Islam's AI layer. Rather than a chat window bolted onto the side of the app, it sits **underneath every reading surface** — so the models work on the app's own content: the ayah, the narration, a scholar's translation, your own notes. It can **translate** any passage into any language, **answer questions** about it, **read it aloud**, and **transcribe your speech** into notes. Full guide in the [Intelligence documentation](/docs/intelligence). **Why do I need my own API key?** Because it is better for you in three specific ways: * **Your content never passes through our servers.** Requests go from your device to your provider directly — we run no proxy and no relay, so we cannot read your prompts or the responses. * **Your costs are itemised by your provider**, not hidden inside our margin. * **Your model choice is not limited to what we negotiated.** A model released this morning works this morning. **Which AI providers can I use?** Thirty-five services across ten protocols — major labs (OpenAI, Anthropic, Gemini, Mistral, DeepSeek and others), Arabic-first services like Fanar, inference platforms (Groq, OpenRouter, Together and more), dedicated translation services (DeepL, Google, Azure), voice services (ElevenLabs, Deepgram), and local models running on your own machine (Ollama, LM Studio, Jan, llama.cpp, vLLM). There is also a general connection for any OpenAI-compatible service, so a provider that did not exist when the app shipped can still be used today. **Can I use the AI features for free?** Yes. Five supported options — **Ollama, LM Studio, Jan, llama.cpp and vLLM** — run entirely on your own machine with no key, no account and no bill. Several hosted services also have free tiers sufficient for occasional use. A Premium subscription is still required to unlock the suite itself. **Are my API keys safe?** **Yes, and deliberately so.** Keys are encrypted on your device with a hardware-backed key that cannot be taken off it. They are: * Never transmitted to our servers * Never written to logs, usage records, backups or exports * Never shown in full again after you save them — only a masked hint * Removed first when you delete a connection Al Islam's AI connection has no default destination: requests reach the providers you configured and nowhere else. **Can Al Islam see my AI conversations?** **No.** Your device contacts your chosen provider directly. We operate no proxy and no relay, so your prompts and their responses never travel anywhere we could read them — not because we promise not to look, but because there is nothing to look at. Once your request reaches your provider, that provider's privacy policy applies. Providers differ on whether they retain or train on submitted data, so it is worth reading theirs. If you want the capability with none of that exposure, use a local model. **Can I trust what the AI says about the Quran and Hadith?** **Verify it.** AI models produce confident, fluent and sometimes **entirely fabricated** output — including invented rulings, invented attributions, and citations that look authentic but are not. A fabricated chain of narration reads exactly like a real one. Al Islam takes this seriously: the instructions behind Ask are written for Islamic source material specifically — stay faithful to the text, invent no rulings or attributions, preserve honorifics, state uncertainty plainly. AI output is always shown **alongside** the authentic sources, never in place of them. But those measures reduce the risk rather than remove it. **AI output is not a religious authority.** Treat it as a study aid, and for anything consequential consult a qualified scholar. **Does Intelligence work offline?** Only with a local model running on your own machine. Translations you have already produced are saved and stay readable offline regardless. **Is my reading history private?** **Absolutely.** Your privacy is our priority. Your reading history is handled with strict security measures: * **100% Local Storage:** Your history never leaves your device and is never transferred to any external servers. * **Full Encryption:** Data is securely encrypted on your device, ensuring no one else can access it. * **Total Control:** You can clear or delete your history at any time with a single tap. **What actually gets backed up to the cloud?** Only your **Collections** — including the notes and drawings inside them — plus your account details and a record of which devices you are signed in on. Nothing else. Your reading history, search history, tasbeeh records, calendar events, fasting logs, prayer settings, imported fonts, AI keys and saved AI translations all stay on your device, whether backup is on or off. **Does Al Islam track what I read?** **No.** We do not track your reading, build profiles, or use your content for advertising. Your reading history, search history, notes, tasbeeh records and calendar data stay on your device. Ad requests on the free plan carry no personal content of any kind. The complete account is in the [Privacy Policy](/privacy). **Why does the app ask for camera access?** Only for the **augmented-reality Qibla mode**, which draws the direction over a live camera view. No photo or video is ever captured, saved or transmitted — the app has no capability to do so. The permission is optional, and every other Qibla method works without it. **Why does the app ask for microphone access?** Only for **voice dictation** in the notes editor. Recording starts when you press record and stops when you stop it — there is no wake-word, no background listening, and nothing that decides on its own that you have finished speaking. The permission is optional, and you can transcribe an imported audio file instead. **Why does the app need my location?** To calculate prayer times and the Qibla direction for where you are. Your coordinates are used on your device and are never stored on our servers or attached to your account. To show a readable place name instead of coordinates, the app looks the location up with OpenStreetMap — a request that carries no name, email or account identifier. You can avoid it entirely by setting your location manually, and you can decline location access altogether. **Is my data encrypted?** Yes. The app's local database is encrypted on your device, protected by keys held in your device's hardware-backed secure keystore. Anything that does travel to our servers travels over encrypted connections, and your records are reachable only by your own account. **Can I delete my account and data?** Absolutely. See the [Account Deletion](/delete-account) page for step-by-step instructions on requesting deletion of your account and associated data. **How accurate are the prayer times?** They are calculated using 11 established methods, and the right one is pre-selected for your region. Different schools and local authorities legitimately differ by several minutes, and you can choose the method, the Asr standard and the high-latitude rule yourself. **Where your local mosque or scholarly authority differs from the app, follow them.** **Why does the Qibla direction look wrong?** The compass relies on your device's magnetometer, which is easily disturbed by metal, magnets, phone cases, electronics and vehicles. Move away from interference and calibrate your device — the app tells you when accuracy drops. Al Islam offers **five independent ways** to find the Qibla — compass, map, augmented reality, the sun's position, and a full scientific view — precisely so you never have to trust a single needle. Cross-check with the sun method for the most reliable confirmation. **Why didn't my reminder appear?** Android controls when background reminders may run, and battery optimisation, power-saving modes, Do Not Disturb, and manufacturer-specific app restrictions can all delay or suppress them. This varies considerably between phone brands. Exclude Al Islam from battery optimisation in your Android settings to make reminders more reliable. **Please do not rely solely on the app for a time-sensitive religious obligation.** **Can I read several translations at once?** Yes. Both the Quran and the Hadith reader let you put **as many renderings on screen as you like** — the Arabic and three English translations, or Urdu and English together — each as its own card, in whatever order you drag them into. One is marked as the **primary**, which is where metadata and references come from. Where a rendering sits and which is authoritative are separate choices, and both are yours. **Can I use my own fonts?** Yes. Import your own TTF fonts for Arabic and Urdu, and set size, line height, letter spacing and colours independently for each language. Font files stay on your device and are never uploaded. **Can I write notes in Arabic?** Fully. Right-to-left text, Arabic headings and tags, mixed-direction paragraphs, and a dedicated Quranic typeface for Arabic passages are all supported. A note can be entirely in Arabic. **What can I put on my home screen?** Widgets for prayer times, today's Hijri date, upcoming occasions, a fasting planner, a daily companion and a full Hijri month grid. They read your local data and transmit nothing. **Is the Al Islam app associated with the Ahmadiyya Muslim Community?** **No.** The Al Islam app by Lymrah is entirely independent and has no affiliation, connection, or relevance to the Ahmadiyya community, its teachings, or its perspective. None of our content is derived from or influenced by them. Our platform is dedicated to serving mainstream Islamic content through a highly transparent, organized, and structured approach: * **Mainstream Content:** The application hosts a massive collection of Islamic resources, predominantly featuring the works of hundreds of recognized **Ahl-al-Sunnah wal-Jama'ah** (Sunni) scholars. * **Clear Labeling & Metadata:** To ensure complete transparency, every resource, book, and media item within the app is meticulously labeled with clear metadata so you always know the source and context of what you are reading. * **Inclusive yet Classified:** While the platform may include mainstream **Shia Muslim** content to broaden the resource library, any such content will always be explicitly categorized and clearly classified, allowing users to navigate the app with total clarity and confidence. **Where does your content come from?** From widely recognised and authentic references — classical Hadith collections and established published translations. Every resource, book and item is labelled with its source and metadata so you always know what you are reading and who produced it. The app does not claim scholarly authority and is not a substitute for qualified scholarship. We welcome corrections at support.alislam@lymrah.com and take them seriously. **How often do you add new content?** Continuously — new Hadith collections, new translations, new tools and refinements to existing features. Every update is recorded in the [Changelog](/changelog). **I found an error in a translation or hadith. What should I do?** Please tell us. Email support.alislam@lymrah.com with the collection, the reference number and what you believe is wrong. Content corrections are prioritised, and any inaccuracy is unintended rather than deliberate. ## About Al Islam (https://alislam.lymrah.com/about) **Al Islam** (`com.pakdeen.alislam`) is a comprehensive Islamic platform designed from the ground up to bring **authentic Islamic knowledge** and **daily Islamic practice** together in one intuitive, powerful, beautifully designed application. Built by **Lymrah**, Al Islam pairs **infrastructure-first engineering** with **user-centric convenience** — making Islamic scholarship accessible to everyone, everywhere, and keeping the essentials of the Islamic day within reach. Currently on **version 4.5**. See what's new in the [Changelog](/changelog). --- #### Our Mission To make authentic Islamic knowledge accessible to everyone, everywhere, in the language that speaks to them — while providing **complete convenience**, **multiple possibilities**, and **full control**. **Free at its core**, and continually evolving. --- #### What Makes Al Islam Different ##### Philosophy: Systems Over Features We don't stack features on top of each other. We **build systems** — cohesive, interconnected infrastructure designed to absorb complexity while staying intuitive on the surface. That philosophy runs through everything in Al Islam: - **[Prayer Times](/docs/prayer-times)** — not static calculations, but a complete Islamic time system: 11 calculation methods, multiple Asr standards, high-latitude rules, location profiles, solar and lunar almanac views, and full offline operation - **[Qibla Finder](/docs/qibla-finder)** — not a lone compass needle, but five independent ways to find and *verify* the direction: compass, map, augmented reality, the sun itself, and a full scientific breakdown - **[Hijri Calendar](/docs/calendar)** — not a date grid, but a complete calendar environment: occasions, moon phases, fasting logs, personal events, date conversion, and reminders - **[Search](/docs/search)** — not a keyword matcher, but a custom full-text engine built in-house and optimized for mobile: advanced query syntax, diacritic handling, and intelligent filtering - **[Collections](/docs/collections)** — not bookmarks, but a file-manager-grade library: unlimited nesting, rich notes on every item, cloud sync, and conflict resolution - **[Notes](/docs/notes)** — not a text box, but Qalam: a full rich-writing system with live formatting, Quran and hadith references, Arabic script support, drawings, and a plain-text format that keeps your notes yours forever - **[Tasbeeh](/docs/tasbeeh)** — not a tap counter, but a dhikr companion: a managed library, routines, goals, streaks, and long-term statistics - **[Intelligence](/docs/intelligence)** — not a chatbot bolted onto the side, but a layer sitting *underneath* every reading surface, running on models you own and keys that never leave your device - **[Text Customization](/docs/text-customization)** — not preset themes, but unified, per-language, per-section typography control Every system ships with **sensible defaults** so it's useful the moment you open it — and **deep customization** for those who want control. ##### Technology & Architecture **Modern Foundation** Al Islam is built on modern, industry-standard frameworks with a **highly modular architecture** and no legacy technology underneath. **Performance Optimization** Performance-critical paths are **heavily optimized** at the architectural level so the app stays smooth everywhere: - **Custom search engine** — millisecond results across 232,559 hadith - **Dynamic memory management** — scales with device capability, runs smoothly on low-end hardware - **Pagination & lazy loading** — millions of items without lag - **Concurrent operations** — searches, syncs, and calculations run in parallel without ever blocking the interface ##### Security & Privacy **Security is a first-class concern:** - **Local data encrypted on your device**, protected by keys sealed in your device's hardware-backed secure keystore — keys that cannot be extracted from the device - **Encrypted search indices** — searching never compromises privacy - **Encrypted transport** — everything that does travel to our servers travels over TLS, and server-side data sits behind strict per-account access controls that make your records reachable by your account alone - **Zero server calls for local features** — your location, reading history, notes, tasbeeh records, and calendar data stay on your device, and there is no version of the app in which they don't **Your privacy, concretely:** - **Local by default** — the overwhelming majority of the app never contacts a server at all. That is a structural guarantee, not a policy one: the features simply have no network path. - **Optional cloud backup** — only your Collections, only if you explicitly enable it - **No tracking** — we don't track what you read or study, and we don't build profiles - **Your AI keys never leave your device**, and AI requests never pass through our servers — see [Intelligence](/docs/intelligence) - **Every permission is optional and explained** — see the [Privacy Policy](/privacy) for a line-by-line account of every one ##### Data Integrity & Reliability **Before every release**, all content passes through: - **Regression testing** — ensuring nothing breaks - **Structural validation** — verifying data consistency - **Data integrity pipelines** — catching corruption before it ships **Resilient by design:** - **Transactional indexing** — interrupted mid-index, the previous index stays valid - **Conflict resolution** — concurrent edits across devices merge automatically - **Progressive syncing** — changes queue offline and sync on reconnection --- #### What You Get ##### Content **[Quran](/quran):** - 6,236 verses (ayahs) - 122 translations across 62 languages - 95 works of tafsir - Complete offline access **[Hadith](/library):** - 33 major collections (the Sihah Sittah and beyond) - 232,559 narrations - 5 languages (Arabic, English, Urdu, Hindi, Bangla) - Comprehensive metadata — grading, authenticity, narrators ##### Knowledge Features - **[Quran Section](/docs/quran)** — complete Quranic content with tabbed navigation, verse jumping, translation and tafsir browsing, and comprehensive referencing - **[Hadith Section](/docs/hadith-library)** — 33 collections with rich metadata, sorting, language selection, progress tracking, and polished reading screens built as a reading stack, so moving between a chapter, a narration and its commentary never loses your place - **[Search](/docs/search)** — text and reference matching, advanced query syntax, intelligent filtering — entirely offline - **[Collections](/docs/collections)** — file-manager-style organization with unlimited nesting, rich notes, cloud backup, and automatic sync - **[History](/docs/history)** — detailed reading logs and a dashboard of metrics, streaks, activity graphs, and habit analysis - **[Text Customization](/docs/text-customization)** — per-language typography, custom fonts, color control, all previewed in real time ##### Daily Practice Tools - **[Prayer Times](/docs/prayer-times)** — 11 calculation methods, location profiles, offline calculation, plus Sun, Sky, and Hijri views: a solar almanac, a live twilight ladder, moon data, and a crescent visibility forecast - **[Qibla Finder](/docs/qibla-finder)** — compass, map, AR, sun-and-shadow verification, and a scientific insights view, with sensor-accuracy and magnetic-interference awareness built in - **[Hijri Calendar](/docs/calendar)** — the full Islamic calendar with occasions, moon phases, fasting logs, personal events, a date converter, and a Hijri birthday finder - **[Tasbeeh Counter](/docs/tasbeeh)** — dhikr counting with a customizable library, routines, daily goals, streaks, and detailed statistics - **[Notes — Qalam](/docs/notes)** — a complete rich-text writing system: live formatting, task lists, tables, drawings, validated Quran and hadith references that open the readers directly, honorifics, full Arabic support, voice dictation, and portable plain-text storage - **[Home Screen Widgets](/docs/home-widgets)** — prayer times, the Hijri date, upcoming occasions, a fasting planner, a daily companion, and a full Hijri month grid, visible without opening the app ##### Intelligence — Your Own Models, Throughout the App Introduced in version 4.5, **[Intelligence](/docs/intelligence)** is a layer that sits underneath every reading surface in the app, so the models work on the app's own content — the ayah, the narration, a scholar's translation, your own notes — rather than on text you had to copy somewhere else. It runs on a **bring-your-own-key** model. You connect accounts you already have; the app never resells model access, and your keys never leave your device. - **Translate** — any passage into any language, presented as a scholar-style card laid out exactly like a published translation, and saved to your Library so you never pay twice for the same passage - **Listen** — readings, answers, and your own notes read aloud in a natural voice, with the player following you between screens - **Ask** — a conversation about the passage in front of you, appearing inside the screen you are already reading, with follow-up questions that keep their memory - **Standing translations** — pin a language to stay, and every hadith or ayah you open arrives with it already beneath the text - **Your own commands** — write an instruction once and run it over any passage in the app - **Dictation** — speak into the notes editor, with the words landing exactly at your cursor - **Thirty-five services** across ten provider protocols, including local models running on your own machine with no key at all The full guide lives in the [Intelligence documentation](/docs/intelligence). ##### Design & User Experience **Modern, polished design:** - A clean, consistent visual language across every screen - Smooth animations and transitions - A refined, glass-inspired aesthetic that stays out of your content's way - Accessibility-minded throughout **Convenience first:** - Smart defaults that work for most users out of the box - Minimal setup required to get started - Quick actions and shortcuts exactly where you need them **Transparency:** - Every feature documented comprehensively - Clear explanations of how things work - Complete metadata visible in the app - Every content source clearly labeled --- #### Frequently Asked Questions ##### Is the Al Islam app associated with the Ahmadiyya Muslim Community? **No.** The Al Islam app by Lymrah is **entirely independent** and has **no affiliation, connection, or relevance** to the Ahmadiyya community, its teachings, or its perspective. None of our content is derived from or influenced by it. ##### What Islamic perspective does Al Islam represent? **Mainstream Islamic content:** the app hosts a vast library of Islamic resources, predominantly the works of recognized Ahl as-Sunnah wal-Jama'ah (Sunni) scholars. **Clear labeling and metadata:** every resource, book, and item is meticulously labeled so you always know the source and context of what you are reading. **Inclusive yet classified:** where mainstream Shia content is included to broaden the library, it is always explicitly categorized and clearly classified, so you can navigate with total clarity and confidence. ##### Is the app free? **Yes.** Al Islam is **free at its core**. All core features — Quran, Hadith, Prayer Times, Qibla, the Hijri Calendar, Tasbeeh, Notes, Search, Text Customization, History, and Collections — are free, forever. Al Islam Premium is an optional subscription, available monthly or annually, that adds: - **Cloud Backup for Collections** — automatic sync across devices - **Unlimited location profiles** — free users can keep 5 Prayer Times location profiles; premium removes the limit - **Intelligence** — the full AI suite described above - **No advertisements** — the free plan shows ads, capped at five full-screen interstitials a day; premium removes them entirely Premium unlocks the Intelligence *suite*. The models themselves run on your own provider account and its billing — see the question below. ##### What is Intelligence, and do I have to pay extra for AI? Intelligence is the app's AI layer, and it works differently from most. **Al Islam does not sell you model access.** There is no shared account, no token bundle, and no markup. You connect **your own** provider account with **your own** key, and whatever your provider charges you is between you and them. A premium subscription unlocks the suite; the usage runs on your terms. This has three consequences worth understanding: 1. **You are never locked in.** Change providers whenever you like, or run several at once. 2. **You can pay nothing at all.** Several supported options run entirely on your own machine, with no key and no bill. 3. **Your content does not pass through us.** Requests go from your device straight to the provider you chose. We operate no proxy and no relay, so your prompts and their responses never travel anywhere we could read them. ##### Which AI providers are supported? Thirty-five services across ten provider protocols — major labs, Arabic-first services, inference platforms, dedicated translation services, voice services, and local models running on your own machine. There is also a general connection for any OpenAI-compatible gateway, so a service that did not exist when the app shipped can still be used today. The full catalogue is in the [Intelligence documentation](/docs/intelligence). ##### Are my API keys safe? Keys are encrypted on your device with a hardware-backed key that cannot be taken off it, and are held separately from everything else the app stores. They are shown once, then only as a masked hint (`••••3kfa`). They never appear in logs, usage records, backups, or exports, and removing a connection removes its keys first. Al Islam's AI connection has **no default destination** — requests reach the providers you configured and nowhere else. ##### Can I trust what the AI says about Quran and Hadith? **Verify it.** AI models can produce confident, fluent, and completely fabricated output — including invented rulings, invented attributions, and citations that look authentic but are not. This is a known limitation of the technology and not something any app can fully eliminate. Al Islam takes it seriously in three ways: - The instructions behind **Ask** are written specifically for Islamic source material: stay faithful to the text, invent no rulings and no attributions, preserve honorifics, and say plainly when something is uncertain rather than smoothing it over. - AI output is always presented as what it is, alongside the authentic sources it was derived from — never in place of them. - The app carries 232,559 hadith and 122 scholarly translations offline, so the authentic reference is always one tap away. **AI output is not a religious authority and must never be treated as a fatwa or a substitute for qualified scholarship.** For anything consequential, consult a scholar. ##### Does the app work offline? **Yes.** Everything essential works completely offline once your chosen content is downloaded: - Reading Quran and Hadith - Calculating prayer times - Finding the Qibla - Following the Hijri calendar and logging fasts - Counting dhikr and tracking statistics - Writing and reading notes - Searching your library - Managing Collections, customizing text, and reviewing History Intelligence is the exception: models require a connection, unless you are running one locally on your own machine — in which case that works offline too. Translations you have already produced are kept on the device and remain readable offline. ##### Can I sync my Collections across devices? **Yes.** With the optional premium **Cloud Backup**, your Collections — including the notes attached to them — sync across your devices: - Changes sync in real time when online - Offline changes queue and sync on reconnection - Conflicts resolve automatically - Everything travels over encrypted connections, and your records are reachable only by your own account Cloud Backup covers your Collections and account details. Notes, tasbeeh records, reading history, calendar data, fasting logs, imported fonts and AI keys are **not** part of backup — they stay on your device whether backup is on or off. ##### What languages are supported? **Quran:** 62 languages, 122 translations **Hadith:** 5 languages today (Arabic, English, Urdu, Hindi, Bangla), with more added regularly **Notes:** full Arabic writing support — right-to-left text, Arabic headings and tags, and a dedicated Quranic typeface for Arabic passages **Prayer Times:** calculation methods covering regions worldwide **Interface:** English, with more languages planned **With Intelligence connected:** effectively any language your chosen model supports, on any passage in the app, saved and reusable afterwards. ##### Can I customize how text appears? **Completely.** The Text Customization system lets you: - Adjust font size (8pt–32pt) - Control line height and letter spacing - Choose built-in fonts or import your own TTF fonts - Set text and prefix colors by hex code or color picker - Customize each language independently - Preview every change in real time Your choices apply everywhere that content appears in the app — including translations produced by your own models, which adopt the same per-language typography as published ones. ##### What can the notes system actually do? More than we can fit in a FAQ answer. Qalam supports live rich-text formatting, headings, task lists with tappable checkboxes, tables, quotes, code blocks, callouts, collapsible sections, freehand drawings, custom colors, and tags — plus Islamic writing tools no general editor has: validated Quran references and hadith citations that open the readers directly, a one-tap honorifics library (ﷺ, ﷽, and more), and first-class Arabic script support. As of version 4.5 it also gains **voice dictation** — record, pause, resume and stop entirely on your command, with the transcript landing exactly at your cursor — and **Ask Intelligence** on a selection or the whole note. Underneath it all, every note is stored as readable plain text, so your writing is portable and permanent. The full guide lives in the [documentation](/docs/notes). ##### How is my data stored? **Locally by default:** - Readings, history, collections, notes, dhikr records, fasting logs, customizations, AI keys and saved translations live on your device - Local data is encrypted, with keys sealed in your device's hardware-backed keystore - Nothing is sent to servers without your explicit permission - Everything works offline **Cloud, optionally:** - Enable Cloud Backup and your Collections are backed up and synced - Data travels over encrypted connections and is reachable only by your own account - You can disable cloud backup at any time The complete account — every permission, every third party, every piece of data that does and does not leave your device — is in the [Privacy Policy](/privacy). ##### How often is new content added? Continuously. We regularly add new hadith collections, new translations, new tools, and improvements to existing features. The [Changelog](/changelog) records every update. ##### Is there a desktop version? Not currently. Al Islam is designed specifically for Android phones and tablets — and, since version 4.4, your Android home screen, through widgets. ##### How can I report bugs or suggest features? - **In-app feedback** — the feedback option in Settings - **Email** — support.alislam@lymrah.com - **Social media** — X ([@AlIslamIO](https://x.com/AlIslamIO)) and [Instagram](https://www.instagram.com/alislamappofficial/) ##### Is there a community or support channel? - **Website** — [alislam.lymrah.com](https://alislam.lymrah.com) - **Email** — support.alislam@lymrah.com - **Social media** — X ([@AlIslamIO](https://x.com/AlIslamIO)), [Instagram](https://www.instagram.com/alislamappofficial/), [YouTube](https://www.youtube.com/channel/UCFU0PERPDcDD01xDl3T771w), [Facebook](https://www.facebook.com/people/Al-Islam/61551210454940/) --- #### Our Commitments **To our users:** 1. **Continuous improvement** — we never stop refining the app 2. **Transparency** — every change is documented 3. **Privacy** — your data is yours; we don't sell it or track you 4. **Quality** — everything is tested and validated before release 5. **Accessibility** — the app works for everyone, on any device **To Islamic scholarship:** 1. **Accuracy** — content is authentic and properly sourced 2. **Completeness** — diverse mainstream Islamic perspectives are represented 3. **Clarity** — every source is labeled and categorized 4. **Respect** — Islamic knowledge is treated with the reverence it deserves 5. **Humility** — where a tool cannot be certain, it says so rather than guessing --- #### Our Story Al Islam began with a simple observation: **Islamic life on a phone is scattered.** One app for Quran translations, another for hadith, another for prayer times, another for the Qibla, another for a tasbeeh, a notes app that understands none of it — and nothing connecting any of them. We set out to build something different: a single platform that treats Islamic knowledge and Islamic practice as the connected whole they really are, with infrastructure strong enough to carry that ambition and an interface simple enough that anyone can use it. What has emerged is a professional-grade application with custom-built systems and continuously expanding resources: 232,559 hadith across 33 collections; 6,236 Quranic verses with 122 translations in 62 languages and 95 works of tafsir; a full Islamic time-and-direction toolkit spanning prayer times, Qibla, and the Hijri calendar; a dhikr tracker; a rich notes system built for study; and, most recently, an intelligence layer that puts modern language models to work on that library without ever taking your keys or your content off your device. It grows with every release. --- #### Philosophy in Practice ##### Example 1: Prayer Times Instead of one calculation method, a **system**: 11 major methods (Muslim World League, Egyptian, Karachi, Saudi, Dubai, MWL, ISNA, Kuwait, Qatar, Singapore, Turkey), two Asr standards, four high-latitude rules, location profiles, time-zone control, Hijri offset, and offline calculation — plus solar and lunar almanac views for those who want to see the astronomy behind the times. Most users never touch a setting, because the right method is pre-selected for their region. For everyone else, complete flexibility is waiting. ##### Example 2: Search Rather than a text matcher, a **custom search engine**: advanced query syntax (exact phrases, required and optional terms, wildcards), automatic diacritic normalization, millisecond latency across millions of records, relevance ranking, multiple content types, concurrent queries — all offline. And yet, basic search is still just typing a word. ##### Example 3: Qibla Instead of a needle that could silently be wrong, a **verification system**: five independent methods — magnetic compass, map geometry, augmented reality, the sun's position, and a full scientific view — with the app actively telling you when sensor accuracy drops or magnetic interference is likely. You never have to simply trust the arrow; you can check it. ##### Example 4: Notes Instead of a plain text box, **Qalam** — a complete writing system where formatting appears live as you type, Quran references validate themselves against the actual mushaf and open the reader when tapped, Arabic renders in a Quranic typeface, and drawings sit alongside text. And instead of a private format, every note is stored as readable plain text: portable, future-proof, and permanently yours. ##### Example 5: Intelligence Instead of a chat window bolted onto the side of the app, a **layer underneath it**. The actions live beneath the passage you are reading, so the model works on the app's own content rather than on something you had to copy out. Translations come back looking like published translations, in your own typography, and are kept so you never pay for the same passage twice. And instead of reselling model access at a markup, **bring your own key**: your accounts, your billing, your choice of thirty-five services — including ones that run entirely on your own machine for nothing. The app's job is to route the work and present the result well; the credentials and the content stay yours. Perfect defaults mean most users never think about any of this machinery. The point is that it's there when they do. --- #### Get Started **Download Al Islam:** - Available on Google Play — [get it here](https://play.google.com/store/apps/details?id=com.pakdeen.alislam) **Explore the app:** - Start reading with the [Quran](/docs/quran) or [Hadith](/docs/hadith-library) - Set up [Prayer Times](/docs/prayer-times) for your location and find your [Qibla](/docs/qibla-finder) - Follow the [Hijri Calendar](/docs/calendar) and log your fasts - Count your daily dhikr with the [Tasbeeh](/docs/tasbeeh) - Save verses to [Collections](/docs/collections) and write your first [note](/docs/notes) - Connect a model and put [Intelligence](/docs/intelligence) to work on what you read - Add a [widget](/docs/home-widgets) so the essentials never leave your home screen - Watch your habits grow in [History](/docs/history) --- #### Connect With Us - **Website:** [alislam.lymrah.com](https://alislam.lymrah.com) - **X (Twitter):** [@AlIslamIO](https://x.com/AlIslamIO) - **Instagram:** [@alislamappofficial](https://www.instagram.com/alislamappofficial/) - **YouTube:** [Al Islam](https://www.youtube.com/channel/UCFU0PERPDcDD01xDl3T771w) - **Facebook:** [Al Islam](https://www.facebook.com/people/Al-Islam/61551210454940/) - **Email:** support.alislam@lymrah.com --- **Al Islam: Islamic Knowledge, Reimagined.** ## Privacy Policy (https://alislam.lymrah.com/privacy) _Effective Date: August 1, 2026_ _Version 4.5 — supersedes Version 4.0 (April 29, 2025)_ Al Islam is built to support your spiritual life — and your privacy is treated with the same care as the app itself. This policy explains, in detail and without evasion, what the app accesses, what stays on your device, what leaves it, and why. We follow one guiding principle: **data minimization.** If a feature can work without your data, we do not take it. If it can work on your device instead of ours, it does. **If you use Al Islam without creating an account, no personal data leaves your device.** --- #### About This Revision Al Islam has grown considerably, and this revision sets out in full what the app accesses today. Two releases in particular expanded that: **Version 4.4 ("Miqat")** introduced the complete Qibla Finder — including an augmented-reality mode that uses the **camera** and the device's **motion and magnetic sensors** — along with the full Hijri calendar system, the Tasbeeh counter, the Qalam notes system with drawings, home-screen widgets, and reminder **notifications**. **Version 4.5 ("Bayt al-Hikmah")** introduced Intelligence, the bring-your-own-key AI layer, and with it voice **dictation**, which uses the **microphone**, and the ability to import **audio files** from your device storage. Alongside these, features added across the 4.x releases now let you **import and export files** — custom fonts, audio, and settings backups. These are meaningful capabilities, and they deserve a policy that describes them precisely rather than in general terms. That is what follows — permission by permission, feature by feature, including a plain list of the things we will never do. --- #### At a Glance | | Stays entirely on your device | Leaves your device | | --- | --- | --- | | Quran, Hadith, translations, tafsir | ✅ | — | | Notes, drawings, bookmarks | ✅ | Only your collections, and only if you enable backup | | Tasbeeh counts, routines, statistics | ✅ | Never | | Reading history, streaks, search history | ✅ | Never | | Prayer times, Hijri calendar, fasting logs | ✅ | Never | | Qibla readings, compass, camera view | ✅ | Never | | Custom fonts you import | ✅ | Never | | AI keys you configure | ✅ | Never | | AI prompts and responses | Stored on device | Sent directly to the provider *you* chose — never to us | | Voice recordings | Stored on device | Sent to your chosen provider only when you ask for a transcript | | Account details, collections, sessions | — | To our servers, when you have an account | | Crash diagnostics | — | Technical data only, no personal content | --- #### 1. Who This Policy Applies To This policy applies to everyone who uses the Al Islam Android application. The app is available to users of all ages. We do not knowingly collect personal data from children under 13. If you are a parent or guardian and believe your child has provided personal information, contact us and we will remove it promptly. --- #### 2. Permissions — Every One, and Why Android shows a list of permissions on the Play Store listing. Below is every permission Al Islam holds, what it is genuinely for, and whether you can decline it. We would rather explain all of them than have you wonder about one. ##### Permissions you are asked for, and may decline | Permission | What it is used for | If you decline | | --- | --- | --- | | **Location** (precise or approximate) | Calculating prayer times and the Qibla direction for where you are | Set your location manually instead — everything still works | | **Camera** | The augmented-reality Qibla mode only | Every other Qibla mode works normally | | **Microphone** | Voice dictation, only while you are actively recording | Dictation is unavailable; you can still import an audio file | | **Notifications** | Prayer, tasbeeh and calendar reminders | No reminders are shown; nothing else changes | | **Files and media** (Android 10 and below only) | Reading a font, audio file or settings file *you* pick | You cannot import those files | Every one of these is optional. The app is fully usable without any of them, and each can be revoked at any time in your device settings without breaking anything else. ##### Permissions that involve no personal data | Permission | Why it exists | | --- | --- | | **Internet / network state** | Sync, content downloads, subscription checks, ads, and AI requests | | **Vibrate** | Haptic feedback on the tasbeeh counter and for reminders | | **Run at startup, wake lock, foreground service** | Rescheduling reminders after a restart and completing background work such as sync and indexing | | **Billing** | Purchasing and verifying a premium subscription through Google Play | | **Advertising ID and related advertising permissions** | Delivering and measuring ads on the free plan (see Section 9) | | **Install referrer** | Used by our advertising partners for install attribution | | **Biometric / fingerprint** | Declared by a third-party library we depend on. **Al Islam does not use biometrics and has no biometric feature.** We list it because it appears on your Play listing and you deserve to know why. | ##### Sensors The Qibla feature reads your device's **compass (magnetometer), accelerometer and rotation sensors** to point toward the Kaaba and to keep the AR view stable as you move. Android does not require a permission prompt for these. These readings are used live, on your device, and are **never stored, logged, or transmitted**. They tell the app which way your phone is facing — nothing more. No other part of the app reads motion sensors. --- #### 3. Camera — Qibla Augmented Reality The AR Qibla mode overlays the Qibla direction on a live camera view. - **No photo or video is ever captured, saved, or transmitted.** There is no recording capability in this feature at all. - The camera feed exists only on screen, only while that mode is open, and stops the moment you leave it. - Nothing from the camera is analysed, uploaded, or retained. The app does not perform image recognition, face detection, or any processing of what the camera sees. - Camera permission is optional. Al Islam offers several other ways to find the Qibla, and all of them work without it. --- #### 4. Microphone — Voice Dictation Dictation lets you speak instead of type when writing notes. **Recording is strictly on your command.** It begins only when you press record, pauses only when you pause it, and stops only when you stop it. There is no background recording, no wake-word, no always-listening mode, and no silence-detection that starts or stops capture on its own. Nothing anywhere in the app opens the microphone except this feature, and only while you have it open. **Where the recording goes.** The audio is written to temporary storage on your device. It is transcribed only when you explicitly ask for a transcript — and it is sent **directly to the AI provider you configured**, never to us. See Section 6. **You stay in control.** You can review, re-record, or delete a recording without ever transcribing it. Temporary audio is overwritten by your next recording and removed when you clear the app's data. Devices without a microphone can use every other part of the app normally, and can still transcribe an audio file imported from storage. --- #### 5. Files and Storage Al Islam can read and write files, always through Android's system file picker. This matters: **the app never receives broad access to your storage.** It receives only the specific file you choose, at the moment you choose it. It cannot browse, scan, or index your device. **Files you can import** - **Custom fonts** (`.ttf`) for Arabic and Urdu rendering. Stored on your device only. Never uploaded, collected, or transmitted. - **Audio files** for transcription. Handled exactly like a recording — sent only to your chosen AI provider, only when you ask. - **Settings files** you previously exported, for restoring tasbeeh and calendar configurations. **Files you can export** - **Tasbeeh settings** and **calendar settings**, written as plain files to a location you pick. These leave the app entirely and become ordinary files under your control — we neither see them nor keep a copy. **Content the app downloads** Language packs, translations, tafsir and Hadith collections are downloaded on request and stored on your device for offline use. These are downloads of public content; they carry no personal data about you. The "files and media" permission appears only on Android 10 and below, where the older storage model required it to read a file you picked. On newer versions of Android, the system file picker needs no permission at all. --- #### 6. AI Assistance — Bring Your Own Key Al Islam's AI features (translation, listening, asking, dictation, saved translations and custom commands) run on a **bring-your-own-key** model. This is a deliberate privacy decision and the most important section in this policy. **You supply the key.** To use AI features you connect your own account with an AI provider of your choosing, from a broad catalogue of supported services. There is no shared Al Islam AI account and nothing is billed through us. **Your keys never reach us.** API keys are encrypted on your device and protected by your device's hardware-backed secure keystore. They are: - never transmitted to our servers, - never written to logs or diagnostic reports, - never included in cloud backup, under any setting, on any plan, - never displayed in full again after you save them — only a masked hint remains, so you can tell keys apart. **Your requests do not pass through us.** When you run an AI action, your device contacts your chosen provider **directly**. We operate no proxy, no relay, and no intermediate server for AI traffic. We cannot read your prompts, your content, or the responses — not because we promise not to, but because they never travel anywhere we can see them. **What is sent, and only when you ask.** An AI action sends only what that action needs: the verse, hadith, note, or text you selected; any instruction you wrote; and, for dictation, the audio you recorded. For the listening feature, the text to be spoken is sent to the provider that generates the audio. Nothing is sent in the background. Nothing is sent until you tap the action. **The provider's policy governs from there.** Once your request reaches your chosen provider, that provider's privacy policy and data-retention practices apply, not ours. Providers differ significantly in whether they retain submitted data or use it to train models. We strongly encourage you to read the policy of any provider before connecting it. **Results stay with you.** Saved translations, transcripts, and responses you keep are stored on your device. They are not synced to our servers. **You stay in control.** You can delete any connection and its stored key at any time, clear saved AI results, and use the entire rest of the app without ever configuring AI at all. --- #### 7. Your Account and Cloud Backup ##### Using Al Islam without an account The app is fully local. No account exists, no personal data is transmitted, and nothing is stored on any server. ##### If you create an account An account is optional and needed only for cloud backup and premium features. We then hold: - **Email address** — for authentication and account identification. - **Display name** — the name you choose, shown inside the app. - **Sign-in method** — email/password or a social sign-in provider. - **Device session records** — device model, Android version, app version, language and region, an app-generated device identifier, and when that device was first seen and last synced. Session records exist for one reason: so you can see every device your account is signed in on and sign out any you do not recognise. As with any internet service, our servers also record the IP address a request arrives from, as part of normal operation and abuse prevention. If you use a social sign-in option, we receive your name and email from that provider as part of authentication. We do not store profile photos, and the app does not let you upload one. ##### Cloud backup (optional, off by default) If you enable backup, **your collections** are synced to our servers so you can restore them on a new device or after reinstalling. To be precise about scope — when backup is on, the data that leaves your device is limited to your **profile details, your collection entries, and your device session records**. That is the entire set. Your notes are part of this. Notes in Al Islam live inside your Collections — both notes attached to a saved ayah or narration and standalone note items — so enabling backup syncs them, including their drawings, along with everything else in your Collections. Backup does **not** include your tasbeeh counts and routines, reading or search history, prayer and calendar settings, fasting logs, imported fonts, AI keys, or saved AI translations. Those remain on your device whether backup is on or off. --- #### 8. Reminders, Widgets and Background Activity **Reminders.** The app can show prayer, tasbeeh and calendar reminders. These are generated **entirely on your device** from data already stored there. No reminder involves a server, and no notification content is transmitted anywhere. If you deny or revoke notification permission, reminders simply do not appear. **Home-screen widgets.** Widgets for prayer times and the Hijri calendar read the same local data and draw it on your home screen. They transmit nothing. Note that widget content is visible to anyone who can see your home screen — a consideration for any widget, not just ours. **Background work.** The app occasionally does scheduled background work: rescheduling reminders after a restart, refreshing widgets, building the offline search index, and syncing if you enabled backup. This is why the app holds the wake lock and background-execution permissions. None of it involves collecting anything about you. --- #### 9. Advertising Al Islam is free to use, and advertising supports that. Ads are served by **Google AdMob**, together with mediation partners including **Unity Ads** and **Liftoff**. These partners may process limited device and advertising information — your device's advertising identifier, general device characteristics, and approximate region — to deliver, cap and measure ads under their own privacy policies. Our commitments: - On the free plan, full-screen interstitial ads are capped at **five per day**. That limit is enforced in the app, not merely intended. - **We do not sell your personal data to advertisers.** - We do not share your account details, notes, collections, reading history, prayer data, location, or AI activity with any advertising partner. Ad requests carry none of it. - Ad personalization is governed by your device settings. You can reset or delete your advertising identifier, or opt out of personalized ads, in Android settings at any time. - **Al Islam Premium removes advertising entirely.** --- #### 10. Diagnostics and Crash Reporting To find and fix defects, Al Islam uses **Firebase Crashlytics**. A report contains technical information only: the error and its stack trace, device model, operating system version, app version, and a short trail of technical log messages leading up to the failure. A report does **not** contain your notes, drawings, collections, AI prompts or responses, API keys, passwords, precise location, recordings, or the content of anything you read or wrote. This data is used solely to diagnose and fix problems, never for advertising or profiling. --- #### 11. Location, in Detail Location is used for exactly two things: calculating prayer times, and calculating the Qibla direction. Your coordinates are used **on your device** for those calculations. They are not stored on our servers and are never attached to your account. **One thing to be precise about.** To display a readable place name — "Lahore, Pakistan" rather than a pair of coordinates — the app sends your approximate coordinates to **OpenStreetMap's Nominatim service**. That request carries no name, email, account identifier, or device identifier; it is a lookup of a place, not of a person. If you prefer to avoid it entirely, set your location manually and no lookup is made. The app does not track your location in the background and does not build a location history. Location is read when you ask it to update, and not otherwise. --- #### 12. How We Use Your Data We use the data described above strictly to: - Authenticate you and keep your account secure. - Sync and restore your collections, if you enabled backup. - Show your active sessions so you can manage them. - Display your chosen name inside the app. - Confirm your premium subscription status. - Diagnose crashes and fix defects. - Deliver and cap advertising on the free plan. That is the complete list. --- #### 13. What We Never Do Stated plainly, so you can hold us to it. We never: - Sell, rent, or trade your personal data. - Read, scan, or analyse the content of your notes, drawings, collections, or AI conversations. - Transmit your API keys anywhere. - Record audio, photographs, or video in the background, or without you starting it. - Read your camera or microphone outside the one feature that uses each. - Track your location in the background or build a location history. - Scan or index your device storage. - Use your personal content to build advertising profiles. - Share your data with advertisers or data brokers. --- #### 14. Storage and Security - The app's local database is **encrypted on your device**, so your content is not readable by other apps or by casual inspection of device storage. - API keys and other secrets are protected by your device's **hardware-backed secure keystore**. - All communication with our servers uses **encrypted connections (HTTPS/TLS)**. - Server-side data is protected by access controls that restrict every record to the account that owns it. No other user can reach your data. - Your premium status is confirmed from your authentication token, avoiding additional queries against your account. No system is perfectly secure. We encourage you to use a strong, unique password and to keep your device locked and up to date. --- #### 15. Subscriptions and Billing Al Islam Premium is an optional, **auto-renewing subscription** available in monthly and annual plans. All billing, payment processing, renewal and cancellation are handled entirely by **Google Play**. We do not collect, process, or store any payment information — no card numbers, no billing addresses, no bank details. Prices shown in the app come from Google Play in your own currency and market. When you purchase, Google Play issues a purchase token, which we verify solely to confirm your subscription is valid. Full subscription, cancellation and refund terms appear in our Terms and Conditions. --- #### 16. Third-Party Services | Service | Purpose | When it is involved | | --- | --- | --- | | Our secure cloud backend | Authentication and optional backup | Only if you create an account | | Google Play | Subscription billing and verification — [Privacy Policy](https://policies.google.com/privacy) | Only if you subscribe | | Google AdMob, with Unity Ads and Liftoff | Advertising | Free plan only | | Firebase Crashlytics | Crash and error diagnostics | On a crash or error | | OpenStreetMap Nominatim | Coordinates → place name — [Usage Policy](https://operations.osmfoundation.org/policies/nominatim/) | Only when resolving a place name | | Social sign-in providers | Authentication | Only if you sign in with one | | AI providers you configure | AI features, using your own account and key | Only if you enable AI | We are not responsible for the independent data practices of these services, and we encourage you to review their policies. --- #### 17. Data Sharing and Disclosure We do not sell, rent, or share your personal data with third parties for commercial purposes. Your data may be disclosed only when required by law, court order, or a valid governmental request, or where necessary to protect the rights, safety, or property of Al Islam or its users. --- #### 18. Your Rights and Controls - **Delete your account** — request deletion at any time. All associated server-side data is permanently removed. - **Get a copy of your data** — contact us and we will provide the personal data associated with your account. - **Disable backup** — turn cloud sync off at any time. Your local data is unaffected. - **Revoke any permission** — location, camera, microphone, notifications and file access can each be revoked independently in device settings. - **Remove AI connections** — delete any stored key and its saved results at any time. - **Clear local history** — reading and search history can be cleared from within the app. - **Sign out a device** — ends that session and removes it from your session list. - **Uninstall** — removes all local data from your device. Depending on where you live, you may have additional statutory rights over your personal data, including access, correction, portability, restriction, objection, and erasure. Contact us and we will honour them. --- #### 19. Data Retention - Account and backup data are retained while your account is active. - If you delete your account, all associated data is permanently erased from our servers within **30 days**. - Crash reports are retained by our diagnostics provider on a limited schedule and contain no personal content. - Temporary recordings are overwritten by your next recording and removed when you clear app data. - Local data is removed when you uninstall the app. --- #### 20. International Users Al Islam is used worldwide. Where your data is processed on our servers or by the third-party services listed above, it may be handled in a country other than your own. Wherever it is processed, it remains covered by the commitments in this policy and protected by encrypted transmission and strict access controls. --- #### 21. Changes to This Policy If we make significant changes — particularly to what we access or how we use it — we will notify you inside the app before those changes take effect. The version number and effective date at the top always reflect the most recent revision, and each revision states what changed and why. --- #### 22. Contact Us If you have any question, concern, or request regarding this policy or your data, please reach out: **Email:** support.alislam@lymrah.com **Developer:** Al Islam **App ID:** com.pakdeen.alislam We aim to respond to every privacy request promptly. --- _Al Islam — Designed for your spiritual life. Built with respect for your privacy._ ## Terms of Use (https://alislam.lymrah.com/terms) _Effective Date: August 1, 2026_ _Version 4.5 — supersedes Version 4.0 (April 29, 2025)_ Welcome to Al Islam. These Terms and Conditions ("Terms") govern your use of the Al Islam Android application ("the App"). By downloading or using the App, you agree to these Terms. If you do not agree, please do not use the App. --- #### About This Revision The App has grown considerably, and these Terms set out in full what it does today. Please read these sections in particular: - **Section 5 — Premium is an auto-renewing subscription.** Section 5 sets out the billing, renewal and cancellation terms in full. - **Section 6 — AI Assistance.** Entirely new. Covers your responsibilities when connecting your own AI provider, who pays for what, and the serious limits of AI-generated religious content. - **Section 11 — Prayer times and Qibla accuracy.** New, and important. What these calculations can and cannot guarantee. - **Section 12 — Reminders.** New. Why a reminder is a convenience and not a guarantee, and what you should not rely on it for. - **Sections 8 to 10 — Camera, microphone, sensors, and file import and export**, all introduced across the 4.x releases. --- #### 1. Use of the App The App is intended for personal, non-commercial use to help you access Islamic content and utilities, including the Quran, Hadith, prayer times, the Hijri calendar, Qibla direction, tasbeeh, and personal notes. You may not: - Use the App for any unlawful or prohibited purpose. - Reverse-engineer, decompile, modify, or tamper with the App or its contents. - Attempt to gain unauthorized access to any part of the App's backend or infrastructure. - Use the App in any way that could damage, disable, or impair its functionality for yourself or others. - Use the App to produce, distribute, or promote content that misrepresents Islamic teachings. --- #### 2. Accounts and Authentication Some features — cloud backup and premium subscriptions — require an account. Most of the App does not, and you are welcome to use it without ever creating one. When you create an account, you agree to: - Provide accurate information, including a valid email address and your chosen display name. - Keep your credentials secure and confidential. - Notify us promptly if you suspect unauthorized access to your account. You are responsible for activity under your account. You can review and sign out your active devices at any time from within the App. We reserve the right to suspend or terminate accounts that violate these Terms. --- #### 3. Permissions The App requests certain device permissions. Each is optional, each is used only for the feature it belongs to, and each can be revoked at any time in your device settings without breaking the rest of the App. By granting a permission you consent to its use as described in our Privacy Policy — which sets out every permission the App holds, what it is for, and what happens if you decline it. Granting a permission does not authorise any use beyond the feature it serves. --- #### 4. The Free Plan and Advertising The App is free to use, and advertising supports that. On the free plan: - Advertisements are displayed, including full-screen interstitial ads. - **Interstitial ads are limited to five per day.** This is a commitment the App enforces, not a guideline. - Ads are delivered by third-party advertising partners under their own terms and privacy policies. Al Islam Premium removes advertising entirely. --- #### 5. Premium Subscriptions and Billing Al Islam Premium is an optional subscription that unlocks additional features. **Please read this section carefully before purchasing.** **Nature of the purchase** Premium is an **auto-renewing subscription**, available in monthly and annual plans. Unless you cancel, it renews automatically at the end of each billing period and your payment method is charged for the next period. **Billing** - All purchases, renewals, and cancellations are processed by **Google Play** under Google Play's billing terms. - Prices are shown inside the App in your own currency and market, as supplied by Google Play at the time of purchase. Where the App compares plans or shows a saving, that figure is calculated from those live prices. - We do not process or store any payment information. **Cancellation** - You may cancel at any time through your Google Play account settings. - Cancellation stops future renewals. It does not end your current billing period — premium features remain available until that period expires. - **Deleting the App does not cancel a subscription.** You must cancel through Google Play. **Price and plan changes** We may change pricing or the composition of plans. Any change to the price of an existing subscription will be communicated in advance in accordance with Google Play's requirements, and you will have the opportunity to cancel before it takes effect. Changes never apply retroactively to a period you have already paid for. **If your subscription lapses** Content you created while subscribed — notes, collections, saved results, configurations — is **not deleted** when a subscription ends. Premium features become unavailable, but your own data remains yours and remains on your device. **Refunds** - Refunds are governed primarily by Google Play's refund policy, and requests are usually best made directly to Google Play. - If premium access was not granted despite a completed payment, contact us and we will resolve it or support your refund request in full. - Statutory rights of withdrawal or refund that apply in your country are unaffected by anything in these Terms. **Security** We are not responsible for unauthorized access to your payment data or account if the App was obtained from any source other than the official Google Play Store. Always install Al Islam from its official listing. --- #### 6. AI Assistance — Bring Your Own Key The App offers optional AI-assisted features, including translation, spoken audio, questions about a passage, saved translations, custom commands, and voice dictation. These operate on a **bring-your-own-key** model, and using them carries responsibilities that are yours rather than ours. **Your provider account** - To use AI features you connect your own account with a third-party AI provider and supply your own API key. - Your relationship with that provider is directly between you and them. Their terms, pricing, and acceptable-use policies apply to your usage. - **You are solely responsible for all costs your provider charges you.** We do not bill for provider usage, cannot see it, and cannot refund it. Usage costs depend on the provider, the model, and how much you use it — please understand your provider's pricing before you begin. - You are responsible for keeping your key secure and for any use made of it. **How requests travel** Requests go directly from your device to the provider you selected. We operate no proxy or intermediate server for AI traffic, do not receive your prompts or responses, and cannot retrieve, restore, or moderate them. **Accuracy and religious content — please read carefully** - AI-generated output can be **inaccurate, incomplete, or entirely fabricated**, including when it concerns Islamic texts, rulings, translations, chains of narration, or attributions. Fabricated citations that appear authentic are a known and common failure of these systems. - **AI output is not a religious authority.** It must never be treated as a fatwa, a scholarly verdict, or a substitute for qualified Islamic scholarship. - Never rely on an AI translation, summary, explanation, or citation of Quran or Hadith without verifying it against the authentic sources presented in the App, or confirming it with a qualified scholar. - We do not generate, review, endorse, or take responsibility for any output produced by a third-party provider through these features. **Availability** AI features may require an active premium subscription, an internet connection, and a working provider account. Provider availability, pricing, and model behaviour are outside our control and may change without notice. --- #### 7. Cloud Backup and Sync The App offers optional cloud backup that syncs your collections across devices. By enabling it, you acknowledge that: - Your collections and account details will be transmitted to and stored on our secure servers. - You are responsible for the content you choose to back up. - The feature may be modified, temporarily suspended, or discontinued. Where a change is significant, you will be notified within the App in advance. - Disabling backup or deleting your account results in your server-side data being permanently removed within 30 days. - **Backup is a convenience, not an archival guarantee.** It should not be your only copy of anything irreplaceable. Cloud backup is optional and off by default. If you do not enable it, that data does not leave your device. **Your API keys are never included in backup**, on any plan, under any setting. --- #### 8. Camera, Microphone and Sensors **Camera.** The augmented-reality Qibla mode displays a live camera view with the Qibla direction drawn over it. The App does not capture, store, or transmit any photograph or video, and has no capability to do so. Camera permission is optional; other Qibla modes work without it. **Microphone.** Voice dictation records only while you actively start and stop a recording. There is no background recording, wake-word, or always-listening behaviour. You are responsible for the content you record and for ensuring you have the right to record and transcribe it — particularly where another person's voice is involved, which may be subject to law in your jurisdiction. **Sensors.** The Qibla feature reads compass and motion sensors to determine which way your device is facing. These readings are used live and are never stored or transmitted. --- #### 9. Importing and Exporting Files The App can import and export files, always through Android's system file picker. It receives only the specific file you select and cannot browse or scan your device storage. **When you import a file** — a custom font, an audio file, or a settings backup — you confirm that you have the right to use it and that it does not infringe anyone's rights. We do not verify, validate, or take responsibility for imported files. A malformed or incompatible file may simply fail to load. **When you export a file** — such as tasbeeh or calendar settings — it leaves the App and becomes an ordinary file under your sole control. We neither retain a copy nor bear responsibility for what happens to it afterwards. --- #### 10. Your Content The App lets you create collections, bookmarks, notes, drawings, tasbeeh routines, and other personal content. You agree that: - **You retain full ownership of everything you create.** - You are solely responsible for the content you create. - Content created on your device is not accessible to us unless you explicitly enable cloud backup. Your Collections — including the notes and drawings inside them — are covered by backup; tasbeeh data, reading history, settings and your API keys are not. - You will use these features respectfully and in keeping with the purpose of the App. We claim no ownership over your notes, drawings, or collections, and we do not read, analyse, or use them for any purpose. --- #### 11. Prayer Times and Qibla Direction These features are calculated aids offered in good faith. They are not authoritative determinations. **Prayer times** - Prayer times are computed from your location using established calculation conventions. Different schools and local authorities adopt different conventions, and results can legitimately differ by several minutes. - Accuracy depends on the precision of your location, your device's clock and time zone, and the convention you have selected. - At extreme latitudes, conventional methods become unreliable and approximation rules are applied. - **Where your local mosque or local scholarly authority differs from the App, follow them.** **Qibla direction** - The compass reading depends on your device's magnetometer, which is readily disturbed by nearby metal, magnets, electronics, phone cases, and vehicles. - Calibrate your device, and where accuracy matters, verify against a known reference. - The augmented-reality view is a visual aid and inherits every one of these limitations. **Hijri dates** Hijri dates are calculated astronomically. Local moon-sighting authorities may declare a different date, and where they do, theirs prevails. We do not warrant the accuracy of any prayer time, direction, or date, and the App should not be your sole source where precision is essential. --- #### 12. Reminders and Notifications The App can remind you of prayers, tasbeeh routines, and calendar events. **Reminders are a convenience and are not guaranteed to be delivered on time, or at all.** Android controls when a background reminder may run. Battery optimization, power-saving modes, "Do Not Disturb", manufacturer-specific app restrictions, force-stopping the App, and device restarts can all delay or suppress a reminder — and these behaviours vary considerably between manufacturers and are outside our control. **Do not rely solely on the App for any religious obligation that is time-sensitive.** We are not liable for a missed prayer, fast, or event arising from a reminder that did not appear or appeared late. --- #### 13. Offline Use, Downloads and Storage The App is designed to work offline for many core features. However: - Some features — downloading language packs and collections, account sync, subscription verification, AI assistance, and place-name lookup — require an internet connection. - Downloadable content consumes device storage, potentially a significant amount. Managing your device storage is your responsibility, and downloads may fail or be removed if storage runs low. - Offline availability may vary with your device and configuration. - We do not guarantee uninterrupted access to any feature at all times. --- #### 14. Islamic Content — Authenticity and Disclaimer Al Islam presents Quranic verses, Hadith, translations, and other Islamic content sourced from widely recognized and authentic references, including classical Hadith collections and established translations. However: - The App does not claim scholarly authority and is not a substitute for qualified Islamic scholarship. - The App is not intended for issuing fatwas or religious verdicts. - Translations carry linguistic variation reflecting each translator's methodology. For scholarly study, refer to the original Arabic. - Interpretations vary. We encourage you to consult trusted scholars for guidance on religious matters. - Any errors or inaccuracies are unintended. We welcome respectful corrections through our support contact and take them seriously. --- #### 15. Intellectual Property All original content, designs, interface components, and features developed for Al Islam are the intellectual property of the developer. Content included in the App is either original, in the public domain (such as classical Islamic texts), or open-source with appropriate attribution. You may not: - Copy, reproduce, or distribute App content for commercial purposes without written permission. - Claim ownership of any content sourced from the App. Educational and da'wah sharing of App content is permitted, provided proper attribution is maintained. --- #### 16. Respectful Use Al Islam is a spiritual and scholarly tool intended to benefit the Muslim Ummah. You agree to use it with respect for its purpose and content, and to refrain from misusing Islamic texts, the App's features, or the platform as a whole. --- #### 17. Privacy Your use of the App is also governed by our Privacy Policy, which is incorporated into these Terms by reference. By using the App, you consent to the practices described there. --- #### 18. Third-Party Services The App relies on a limited set of third-party services, including Google Play for billing, advertising partners, a crash diagnostics provider, an open mapping service for place names, optional social sign-in providers, and — only if you enable them — the AI provider you configure. Each operates under its own terms and privacy policy. We are not responsible for their independent practices. A current list appears in our Privacy Policy. --- #### 19. Disclaimer of Warranties The App is provided "as is" and "as available", without warranties of any kind, express or implied. We do not guarantee that: - The App will always be available, uninterrupted, or error-free. - All content, calculations, or timings will be free from inaccuracies or omissions. - The App will meet your specific requirements. --- #### 20. Limitation of Liability To the fullest extent permitted by applicable law, we are not liable for any indirect, incidental, special, or consequential damages arising from your use of or inability to use the App, including loss of data, missed reminders, or service interruptions. Nothing in these Terms excludes or limits liability that cannot lawfully be excluded or limited, and nothing here affects your statutory consumer rights. --- #### 21. Account Termination You may delete your account at any time by contacting us at support.alislam@lymrah.com. Upon deletion: - Your account and server-side data are permanently removed within 30 days. - Local data is removed when you uninstall the App. - Deleting your account does **not** cancel an active subscription. Cancel that through Google Play. We reserve the right to suspend or terminate accounts that violate these Terms. --- #### 22. Feedback We welcome feedback, bug reports, and feature suggestions. By submitting feedback: - You grant us the right to use your suggestions at our discretion, without compensation or attribution. - Feedback creates no obligation on our part to implement any requested change. --- #### 23. Changes to These Terms We may update these Terms. Where changes are significant, we will notify you within the App before they take effect, and continued use after notification constitutes acceptance. The version number and effective date at the top always reflect the most recent revision, and each revision states what changed. --- #### 24. Contact Us If you have any question or concern about these Terms, please contact us: **Email:** support.alislam@lymrah.com **Developer:** Al Islam **App ID:** com.pakdeen.alislam --- _By using Al Islam, you acknowledge that you have read, understood, and agreed to these Terms and Conditions._ ## Delete your account (https://alislam.lymrah.com/delete-account) You are always in control of your data. This page explains how to delete your **Al Islam** account (`com.pakdeen.alislam`), exactly what is removed, what stays on your device, and how long it takes. --- #### Before you start Deleting your account is **permanent and cannot be undone.** There is no recovery window and no way to restore an account once it has been removed. Two things are worth checking first, because neither happens automatically: 1. **If you have an active Premium subscription, cancel it separately.** Deleting your Al Islam account does not cancel a Google Play subscription — subscriptions belong to your Google account, not to ours. Cancel it in **Google Play → Subscriptions** before or after deleting, or you will continue to be billed. See [Premium](/docs/premium). 2. **If you want a copy of anything, take it first.** Once your account is gone, so is anything that was only on our servers. Your Collections and notes can be exported or copied from the app before you delete. --- #### How to request deletion Email **support.alislam@lymrah.com** from the address linked to your account, asking for your account to be deleted. Sending from the linked address is what lets us confirm the request is genuinely yours. If you no longer have access to that address, write to us anyway and we will work out another way to verify you. You will receive confirmation when the deletion has been completed. --- #### What is deleted Everything associated with your account on our servers: | Removed | What it covers | | --- | --- | | **Your account and sign-in identity** | Your email address, display name, and the authentication record itself, including any social sign-in link | | **Your synced Collections** | Every folder and saved item, and the notes and drawings inside them, if you had cloud backup enabled | | **Your device sessions** | The record of which devices your account was signed in on, and when | | **Your subscription entitlement record** | The flag that granted Premium in the app | --- #### What is not on our servers to begin with This is the part most worth understanding, because it changes what deleting your account actually achieves. **Most of Al Islam never sends anything anywhere.** The following live only on your device, and have never been uploaded, so account deletion does not touch them and does not need to: - Reading history, streaks, and activity statistics - Search history - Tasbeeh counts, routines, and long-term statistics - Prayer time settings and location profiles - Hijri calendar events, reminders, and fasting logs - Text customization settings and any fonts you imported - Your AI provider keys and saved AI translations - Any Collections you kept locally without enabling cloud backup **To remove those, uninstall the app** — or clear its data from Android Settings if you want to keep it installed. Deleting your account and uninstalling the app are two separate actions, and doing one does not do the other. If your goal is simply to stop using the account on a particular phone, **signing out** is enough and removes nothing. --- #### What may be retained A small amount of information survives deletion, for reasons we cannot avoid: - **Billing and subscription records**, where they are required by Google Play or by law for tax and accounting purposes. These are held by Google Play as the payment processor; we do not hold your payment details at any point. - **Anonymised, aggregated diagnostics** — crash and error reports that contain no personal content and cannot be linked back to you. These carry technical information only: an error, a stack trace, a device model, an app version. - **Records we are legally required to keep**, for as long as the relevant law requires. Nothing retained can be used to identify you or to reconstruct your account. --- #### How long it takes Deletion is completed within **30 days** of your request, and usually much sooner. The 30-day figure is an outer limit that accounts for backup rotation — copies of data held for disaster recovery expire on their own schedule, and your data is purged from those as they cycle. --- #### Frequently asked questions ##### Do I have to delete my account to stop syncing? No. Turning off cloud backup in the app stops syncing immediately and leaves your local data untouched. Your account stays, and you can turn backup on again later. ##### Will deleting my account remove Al Islam from my phone? No. Account deletion removes your data from our servers. The app stays installed, and everything stored locally stays with it. Uninstall the app to remove local data. ##### Can I use the app after deleting my account? Yes. Al Islam works fully without an account — Quran, Hadith, Prayer Times, Qibla, the Hijri Calendar, Tasbeeh, Notes, Search, Collections and History are all available without signing in. You would simply have no cloud backup and no Premium entitlement. ##### What happens to my Premium subscription? Nothing, unless you cancel it. A subscription is held by Google Play against your Google account and is entirely separate from your Al Islam account. **Cancel it in Google Play**, or billing continues even though the account it unlocked no longer exists. ##### What happens to my AI provider keys? They were never on our servers. Keys are encrypted on your device and are never transmitted, never included in backup, and never visible to us. They are removed when you delete the connection in the app, clear the app's data, or uninstall. ##### Can I delete my account and keep my notes? Yes. Notes live inside your Collections on your device. Deleting your account removes the **synced copy** on our servers; the copy on your phone remains until you uninstall or clear the app's data. ##### Can I create a new account with the same email later? Yes. The address is released when the old account is deleted. A new account starts empty — nothing from the deleted one can be recovered or carried over. ##### I deleted my account by mistake. Can you restore it? No. Deletion is permanent, and we have no mechanism to reverse it. --- #### Questions Email **support.alislam@lymrah.com** and we will help. For the full account of what Al Islam collects, what stays on your device, and who else is involved, see the [Privacy Policy](/privacy). For subscription terms, see the [Terms and Conditions](/terms). ## Hadith Library (33 collections) ### Sahih Al Bukhari — صَحِيحُ الْبُخَارِي (https://alislam.lymrah.com/library/sahih-bukhari) Compiler: Imam al-Bukhari · 7,563 narrations · 99 chapters · Category: Sahih · Sihah Sittah · Languages: Arabic, Bengali, English, Hindi, Urdu Sahih al-Bukhari (Arabic: صحيح البخاري), formally titled Al-Jami’ al-Musnad al-Sahih al-Mukhtasar min Umuri Rasoolullahi sallallahu ‘alayhi wa sallam wa Sunanihi wa Ayyamihi, is universally regarded by Sunni Muslims as the most authentic book after the Holy Qur’an. It is the first of the Sihah Sittah (Six Authentic Boo ### Sahih Muslim — صَحِيحُ مُسْلِمٍ (https://alislam.lymrah.com/library/sahih-muslim) Compiler: Imam Muslim · 7,563 narrations · 55 chapters · Category: Sahih · Sihah Sittah · Languages: Arabic, English, Hindi, Urdu Sahih Muslim (Arabic: صحيح مسلم) is the second of the six canonical Hadith collections. It was compiled by Imam Muslim ibn al-Hajjaj al-Naysaburi (821–875 CE), a scholar of extraordinary precision who hailed from Nishapur (modern-day Iran). His work is celebrated by scholars primarily for its unparalleled organizationa ### Sunan An Nasai — سُنَنُ النَّسَائِي (https://alislam.lymrah.com/library/sunan-nasai) Compiler: Imam al-Nasa'i · 5,761 narrations · 53 chapters · Category: Sunan · Sihah Sittah · Languages: Arabic, English, Hindi, Urdu Sunan an-Nasa'i (Arabic: سنن النسائي), also known as Al-Sunan al-Sughra, is the fifth book of the Sihah Sittah. It was compiled by Imam Ahmad ibn Shu'ayb an-Nasa'i (829–915 CE), a scholar from the city of Nasa (in modern-day Turkmenistan). Among all the collectors of Hadith, Imam an-Nasa'i is often cited as having the ### Sunan Abu Dawud — سُنَنُ أَبِي دَاوُدَ (https://alislam.lymrah.com/library/sunan-abu-dawud) Compiler: Imam Abu Dawud · 5,274 narrations · 43 chapters · Category: Sunan · Sihah Sittah · Languages: Arabic, Bengali, English, Hindi, Urdu Sunan Abu Dawud (Arabic: سنن أبي داود) is one of the "Sihah Sittah" (Six Authentic Books) and holds a unique position in Hadith literature. Compiled by Imam Abu Dawud Sulayman ibn al-Ash'ath al-Sijistani (817–889 CE), this collection was designed with a very specific "Product Requirement": to serve as a primary source ### Sunan Ibn Majah — سُنَنُ ابْنِ مَاجَهَ (https://alislam.lymrah.com/library/sunan-ibn-majah) Compiler: Imam Ibn Majah · 4,341 narrations · 39 chapters · Category: Sunan · Sihah Sittah · Languages: Arabic, Bengali, English, Hindi, Urdu Sunan Ibn Majah (Arabic: سنن ابن ماجه) is the sixth and final book of the Sihah Sittah. It was compiled by Imam Abu Abdullah Muhammad ibn Yazid al-Qazwini, famously known as Ibn Majah (824–887 CE). Although it was the last of the major six collections to be formally recognized as part of the "mother books" of Hadith, i ### Jami At Tirmidhi — جَامِعُ التِّرْمِذِي (https://alislam.lymrah.com/library/jami-tirmidhi) Compiler: Imam al-Tirmidhi · 3,956 narrations · 50 chapters · Category: Jami · Sihah Sittah · Languages: Arabic, Bengali, English, Hindi, Urdu Jami al-Tirmidhi (Arabic: جامع الترمذي) is a landmark work in Hadith literature, compiled by Imam Abu Isa Muhammad al-Tirmidhi (824–892 CE). Among the primary collections, this book is distinguished by its unique role as a bridge between the raw narrations of the Prophet (ﷺ) and the practical application of Islamic law ### Musanaf Ibn Shaybah — مُصَنَّف ابْن شَيْبَة (https://alislam.lymrah.com/library/musannaf-ibn-abi-shaybah) Compiler: Imam Ibn Abi Shaybah · 39,097 narrations · 43 chapters · Category: Musannaf · Languages: Arabic, Urdu Musannaf Ibn Shaybah (Arabic: مصنف ابن أبي شيبة) is one of the most massive and vital repositories of early Islamic history and law. Compiled by Imam Abu Bakr ibn Abi Shaybah (775–849 CE), it is a "Musannaf" style work, which differs from the "Sunan" or "Sahih" books by its sheer breadth of content and its historical p ### Musnad Ahmad — مُسْنَد أَحْمَد (https://alislam.lymrah.com/library/musnad-ahmad) Compiler: Imam Ahmad · 26,407 narrations · 1304 chapters · Category: Musnad · Languages: Arabic, Urdu Musnad Ahmad (Arabic: مسند أحمد) is one of the most significant and voluminous collections in the history of Islamic scholarship. Compiled by Imam Ahmad ibn Hanbal (780–855 CE), the founder of the Hanbali school of law, this work is a monumental testament to his lifelong devotion to the preservation of the Prophetic le ### Sunan Al Kubra — سُنَن الكُبْرَى (https://alislam.lymrah.com/library/sunan-al-kubra) Compiler: Imam al-Bayhaqi · 21,818 narrations · 100 chapters · Category: Sunan · Languages: Arabic, Urdu Sunan al-Kubra (Arabic: السنن الكبرى) is the magnum opus of Imam al-Bayhaqi (994–1066 CE). It is widely regarded as one of the most comprehensive and voluminous collections of Hadith ever assembled. While it is organized according to the chapters of Jurisprudence (Fiqh), its primary goal was to provide an exhaustive ev ### Mustadrak Al Hakim — المُسْتَدْرَكُ (https://alislam.lymrah.com/library/mustadrak-al-hakim) Compiler: Imam al-Hakim · 8,803 narrations · 52 chapters · Category: Mustadrak · Languages: Arabic, Urdu Al-Mustadrak 'ala al-Sahihayn (Arabic: المستدرك على الصحيحين) is a high-level scholarly work compiled by Imam al-Hakim al-Nishapuri (933–1014 CE). The word Mustadrak means "a supplement" or "a correction," and the book was designed as a critical expansion of the two most authentic collections: Sahih al-Bukhari and Sahi ### Al Tahawi — الطَّحَوِيّ (https://alislam.lymrah.com/library/sharh-maani-al-athar) Compiler: Imam al-Tahawi · 7,327 narrations · 34 chapters · Category: Sharh (Commentary) · Languages: Arabic, Urdu Sharh Ma'ani al-Athar (Arabic: شرح معاني الآثار), authored by Imam Abu Ja'far al-Tahawi (853–933 CE), is a monumental work of comparative jurisprudence and Hadith criticism. While it is a collection of Hadith, it functions as a high-level legal debate, specifically designed to explain and defend the legal methodology o ### Mishkat Al Masabih — مِشْكَاةُ الْمَصَابِيحِ (https://alislam.lymrah.com/library/mishkat-masabih) Compiler: Imam al-Tabrizi · 6,294 narrations · 29 chapters · Category: Anthology · Languages: Arabic, English, Hindi, Urdu Mishkat al-Masabih (Arabic: مشكاة المصابيح) is a renowned 14th-century anthology that serves as a curated "best-of" collection of Hadith. It was compiled by Imam Wali-ud-Din Muhammad ibn Abdullah al-Khatib al-Tabrizi (died 1341 CE). This work is not a primary collection of original field research; rather, it is a maste ### Sunan Al Daraqutni — سُنَن الدَّارَقُطْنِيّ (https://alislam.lymrah.com/library/sunan-daraqutni) Compiler: Imam al-Daraqutni · 4,750 narrations · 26 chapters · Category: Sunan · Languages: Arabic, Urdu Sunan al-Daraqutni (Arabic: سنن الدارقطني) is a specialized and highly technical collection compiled by Imam Abu al-Hasan al-Daraqutni (918–995 CE). While the previous books we discussed were intended to be general guides for law or ethics, this work is more like a "peer-reviewed journal" for master scholars. Al-Daraqu ### Al Silsila Sahiha — السِلْسِلَة الصَّحِيحَة (https://alislam.lymrah.com/library/silsila-sahiha) Compiler: Sheikh al-Albani · 3,704 narrations · 28 chapters · Category: Modern Collection · Languages: Arabic, Urdu Al-Silsila as-Sahiha (Arabic: السلسلة الصحيحة), formally known as Silsilat al-Ahadith al-Sahiha wa Shay'un min Fiqhiha wa Fawa'idiha, is a contemporary 20th-century masterpiece of Hadith scholarship. It was compiled by Shaykh Muhammad Nasiruddin al-Albani (1914–1999 CE), who is widely regarded as one of the most influe ### Sunan Al Darimi — سُنَن الدَّارِمِيِّ (https://alislam.lymrah.com/library/sunan-darimi) Compiler: Imam al-Darimi · 3,367 narrations · 26 chapters · Category: Sunan · Languages: Arabic, Urdu Sunan al-Darimi (Arabic: سنن الدارمي), also known as Musnad al-Darimi, is a foundational collection compiled by Imam Abdullah ibn Abdul Rahman al-Darimi (797–869 CE). Al-Darimi was a towering scholar from Samarkand and a contemporary of Imam al-Bukhari. His work is so highly regarded that many early scholars argued it ### Maarif ul Hadith — مَعَارِف الْحَدِيث (https://alislam.lymrah.com/library/maarif-hadith) Compiler: Maulana Nomani · 2,115 narrations · 17 chapters · Category: Sharh (Commentary) · Languages: Arabic, Urdu Maarif ul Hadith (meaning "Knowledge of the Hadith") is a masterpiece of 20th-century scholarship written by Mawlana Muhammad Manzur Nu'mani (1905–1997 CE). Unlike the classical primary sources that focus on chains of narration and technical grading, this is a "Sharh" (commentary) written in Urdu, specifically designed ### Al-Lu'lu' wal Marjan — اللؤلؤ والمرجان (https://alislam.lymrah.com/library/lolo-walmarjan) Compiler: Muhammad Fu'ad ʿAbd al-Baqi · 1,907 narrations · 54 chapters · Category: Mutafaq Alayh · Languages: Arabic, Urdu Al-Lu'lu' wal Marjan (Arabic: اللؤلؤ والمرجان فيما اتفق عليه الشيخان), meaning The Pearl and the Coral in What the Two Shaykhs Agreed Upon, is a distinguished thematic hadith anthology compiled by the Egyptian hadith scholar Muhammad Fu'ad 'Abd al-Baqi (1882–1967 CE). ### Riyad as-Salihin — رِيَاضُ الصَّالِحِينَ (https://alislam.lymrah.com/library/riyad-as-salihin) Compiler: Imam al-Nawawi · 1,896 narrations · 19 chapters · Category: Anthology · Languages: Arabic, English Riyad as-Salihin (Arabic: رياض الصالحين), formally translated as The Meadows of the Righteous, is one of the most widely circulated, translated, and read books in the Islamic world. Compiled in the 13th century, it serves as a curated, high-utility compendium of Prophetic traditions aimed at refining personal character ### Muwatta Imam Malik — مُوَطَّأ إِمَام مَالِك (https://alislam.lymrah.com/library/muwatta-malik) Compiler: Imam Malik ibn Anas · 1,740 narrations · 46 chapters · Category: Muwatta · Languages: Arabic, English, Urdu Muwatta Imam Malik (Arabic: موطأ الإمام مالك) is the earliest written collection of Hadith and Islamic law to reach us in its complete form. Compiled by Imam Malik ibn Anas (711–795 CE), the leader of the School of Medina, it represents a bridge between the era of the Companions and the later formalization of the Six C ### Bulugh al-Maram — بُلُوغُ الْمَرَامِ (https://alislam.lymrah.com/library/bulugh-al-maram) Compiler: Ibn Hajar al-Asqalani · 1,358 narrations · 16 chapters · Category: Anthology · Languages: Arabic, Urdu Bulugh al-Maram (Arabic: بلوغ المرام من أدلة الأحكام, “Attainment of the Objective from the Evidences of the Rulings”) is one of the most influential Ahadith al-Ahkam collections in Sunni Islam. It was compiled by the renowned Hadith master and Shafi’i jurist Ibn Hajar al-Asqalani (1372–1449 CE). ### Al-Adab Al-Mufrad — الأدب المفرد (https://alislam.lymrah.com/library/aladab-almufarrad) Compiler: Imam al-Bukhari · 1,329 narrations · 1 chapters · Category: Adab · Languages: Arabic, Urdu Al-Adab Al-Mufrad (Arabic: الأدب المفرد), meaning The Singular Book on Manners, is a dedicated hadith collection compiled by Imam Muhammad ibn Ismail al-Bukhari (810–870 CE) — the same scholar behind Sahih al-Bukhari. Unlike his Sahih, which focuses on legal and theological matters, this work is entirely devoted to Isl ### Al-Mu'jam al-Saghir — المعجم الصغير (https://alislam.lymrah.com/library/mujam-as-sagheer-tibrani) Compiler: Imam Abu'l-Qasim Sulayman al-Tabarani · 1,197 narrations · 47 chapters · Category: Mujam · Languages: Arabic, Urdu Al-Mu'jam al-Saghir (Arabic: المعجم الصغير), meaning The Small Lexicon, is one of three major encyclopaedic hadith collections compiled by Imam Abu'l-Qasim Sulayman ibn Ahmad al-Tabarani (260–360 AH / 873–971 CE), one of the most prolific hadith scholars in Islamic history. ### Muwatta Imam Muhammad — مُوَطَّأ إِمَام مُحَمَّد (https://alislam.lymrah.com/library/muwatta-muhammad) Compiler: Imam al-Shaybani · 1,007 narrations · 13 chapters · Category: Muwatta · Languages: Arabic, Urdu Muwatta Imam Muhammad is a unique and pivotal version of the Muwatta of Imam Malik. It was transmitted and edited by Imam Muhammad ibn al-Hasan al-Shaybani (748–805 CE), who was one of the two primary students of Imam Abu Hanifa and also a direct student of Imam Malik for over three years. This work serves as a fascina ### Musnad Ishaq ibn Rahwayh — مسند إسحاق بن راهويه (https://alislam.lymrah.com/library/masnad-ishaq-bin-rahwiya) Compiler: Imam Ishaq ibn Ibrahim ibn Rahwayh · 982 narrations · 39 chapters · Category: Musnad · Languages: Arabic, Urdu Musnad Ishaq ibn Rahwayh is a major hadith collection compiled by Imam Ishaq ibn Ibrahim ibn Rahwayh al-Hanzali al-Marwazi (161–238 AH / 778–853 CE), one of the pre-eminent hadith scholars of the third century AH and a direct teacher of Imam al-Bukhari. ### Shamail Tirmidhi — شَمَائِل التِّرْمِذِيِّ (https://alislam.lymrah.com/library/shamail-tirmidhi) Compiler: Imam al-Tirmidhi · 390 narrations · 55 chapters · Category: Shamail · Languages: Arabic, English, Urdu Shamail Tirmidhi (Arabic: الشمائل المحمدية), also known as Al-Shamail al-Muhammadiyyah, is a specialized masterpiece compiled by Imam Abu Isa al-Tirmidhi (the same author of the Jami). Unlike general collections that focus on legal rulings or theology, this book is a dedicated biographical study of the physical appeara ### Musnad Abdullah ibn al-Mubarak — مسند عبدالله بن المبارك (https://alislam.lymrah.com/library/masnad-abdullah-bin-mubarak) Compiler: Imam ʿAbdullah ibn al-Mubarak · 289 narrations · 1 chapters · Category: Musnad · Languages: Arabic, Urdu Musnad 'Abdullah ibn al-Mubarak is one of the earliest surviving hadith collections, compiled by the polymath scholar Imam 'Abdullah ibn al-Mubarak al-Marwazi (118–181 AH / 736–797 CE). ### Sahifa Ibn Hammaam — صَحِيفَة الِابْن حَمَّام (https://alislam.lymrah.com/library/sahifa-ibn-hammaam) Compiler: Hammam ibn Munabbih · 139 narrations · 1 chapters · Category: Sahifa · Languages: Arabic, Urdu Sahifa Ibn Hammam (Arabic: صحيفة همام بن منبه) is one of the most historically significant documents in the world of Hadith. It is a small collection of narrations recorded by Hammam ibn Munabbih (died 719 or 748 CE), who was a direct student of the famous companion Abu Hurairah. ### Musnad Abdullah ibn Umar — مسند عبداللہ بن عمر (https://alislam.lymrah.com/library/masnad-abdullah-bin-umar) Compiler: Abu Umayya Muhammad ibn Ibrahim al-Tarsusi · 97 narrations · 1 chapters · Category: Musnad · Languages: Arabic, Urdu This musnad collects the narrations of the Companion 'Abdullah ibn 'Umar ibn al-Khattab (r.a.) (ca. 614–693 CE) — one of the most prolific hadith narrators among the Companions, second only to Abu Hurayrah (r.a.) in total narrations. ### Musnad Abd al-Rahman ibn Awf — مسند عبدالرحمٰن بن عوف (https://alislam.lymrah.com/library/masnad-abdul-rahman-bin-auf) Compiler: Imam Ahmad ibn Muhammad al-Burthi · 52 narrations · 1 chapters · Category: Musnad · Languages: Arabic, Urdu This is a specialised musnad (a hadith collection organised by Companion) dedicated entirely to the narrations of 'Abd al-Rahman ibn 'Awf (r.a.) (ca. 580–652 CE), one of the ten Companions promised Paradise (al-'Asharah al-Mubashsharah) and one of the wealthiest among them. ### Kanz al-Ummal — كنز العمال في سنن الأقوال و الأفعال (https://alislam.lymrah.com/library/kanz-al-ummal) Compiler: Ali al-Muttaqi al-Hindi · 44,554 narrations · 54 chapters · Category: Compendium · Languages: Arabic, Urdu Kanz al-Ummal is a large, subject-arranged Hadith compendium compiled between 943–975 AH / 1537–1567 CE by Al-Muttaqi al-Hindi (d. 975 AH / 1567 CE) to reorganize a wide body of earlier material so reports can be located topically. The collection is based chiefly on Jalal al-Din al-Suyuti's al-Jami al-Saghir, its additions, and Jam al-Jawami, which the author combined after first arranging them into intermediate works. Covering an extensive range of subjects—including belief, law, manners, and history—its topical framework makes a very large corpus highly accessible for research, teaching, and comparison. Al-Muttaqi's primary contribution is indexing; he brought related reports together under shared headings while preserving al-Suyuti’s compact source symbols, though individual entries still require evaluation through their cited original sources. ### Sahih Ibn Khuzaymah — صَحِيحُ ابْنِ خُزَيْمَةَ (https://alislam.lymrah.com/library/sahih-ibn-khuzaymah) Compiler: Imam Ibn Khuzaymah · 3,766 narrations · 79 chapters · Category: Sahih · Languages: Arabic, Urdu Sahih Ibn Khuzaymah is an early collection of authenticated Hadith compiled during the lifetime of Imam Abu Bakr Muhammad ibn Ishaq ibn Khuzaymah al-Naysaburi (223–311 AH / 838–924 CE). The surviving portion of the work covers major areas of Islamic worship and law—such as purification, prayer, and fasting—arranged through detailed legal chapter headings that state the specific rulings the author derived from the evidence. As a primary collection, Ibn Khuzaymah selected reports he considered authentic while explicitly adding critical notes where a narrator or transmission chain required qualification. Because only a part of the original manuscript survives, it stands as an invaluable but incomplete gateway to early Hadith-based jurisprudence. ### Fatah Al-Rabani — الْفَتْحُ الرَّبَّانِي (https://alislam.lymrah.com/library/fatah-alrabani) Compiler: Al-Banna al-Saati · 13,440 narrations · 177 chapters · Category: Modern Collection · Languages: Arabic, Urdu Al-Fath al-Rabbani is a modern thematic rearrangement of Imam Ahmad ibn Hanbal's Musnad, prepared by Ahmad Abd al-Rahman al-Banna al-Sa'ati (c. 1300–1378 AH / 1882–1958 CE) and first printed in 1353 AH / 1934–1935 CE. While the original Musnad is organized by Companion narrator, this work restructures the narrations into subject-based books and chapters covering faith, law, manners, and virtues to make the text direct and accessible for researchers. It is commonly accompanied by the commentary Bulugh al-Amani, which explains difficult vocabulary, identifies parallel transmissions, and discusses Hadith grading and legal implications. Ultimately, Fath al-Rabbani acts as a practical bridge between a classical narrator-based architecture and topic-based legal study, facilitating rapid navigation through a massive corpus. ### Hisnul Muslim — حِصْنُ الْمُسْلِم (https://alislam.lymrah.com/library/hisnul-muslim) Compiler: Said al-Qahtani · 276 narrations · 134 chapters · Category: Adhkar · Languages: Arabic, English, Urdu Hisnul Muslim is a highly popular, concise manual of daily supplications and remembrances compiled by Sa'id ibn Ali ibn Wahf al-Qahtani (1371–1440 AH / 1951–2018 CE) in 1409 AH / 1988 CE as an abridgment of his longer study on the subject. The book gathers authentic Arabic invocations for recurring life scenarios—such as morning routines, travel, illness, and prayer—and organizes them into short, situational chapters for quick access. By pairing the core text of each supplication with direct source citations rather than extended commentary or full chains of narration, it maintains an uncluttered layout dedicated to memorization and practice. Valued for its clarity and everyday utility, Hisnul Muslim serves as an accessible contemporary reference tool that bridges classical prophetic traditions with practical daily devotion. ## Quran Resources ### Translations (122) - Sherif Ahmeti — Albanian (Quran Sherif Ahmeti - Albanian (Translation)) - Hasan Efendi Nahi — Albanian (Quran Hasan Efendi Nahi - Albanian (Translation)) - Muhammed Sadiq and Muhammed Sani Habib — Amharic (Quran Sadiq Habib - Amharic (Translation)) - Vasim Mammadaliyev and Ziya Bunyadov — Azerbaijani (Quran Mammadaliyev Bunyadov - Azerbaijani (Translation)) - Alikhan Musayev — Azerbaijani (Quran Alikhan Musayev - Azerbaijani (Translation)) - Muhiuddin Khan — Bengali (Quran Muhiuddin Khan - Bengali (Translation)) - Zohurul Hoque — Bengali (Quran Zohurul Hoque - Bengali (Translation)) - Ramdane At Mansour — Berber (Quran Ramdane At Mansour - Berber (Translation)) - Besim Korkut — Bosnian (Quran Besim Korkut - Bosnian (Translation)) - Mustafa Mlivo — Bosnian (Quran Mustafa Mlivo - Bosnian (Translation)) - Tzvetan Theophanov — Bulgarian (Quran Tzvetan Theophanov - Bulgarian (Translation)) - Ma Jian — Chinese (Quran Ma Jian - Chinese (Translation)) - Ma Jian (Traditional) — Chinese (Quran Ma Jian Traditional - Chinese (Translation)) - A. R. Nykl — Czech (Quran Ar Nykl - Czech (Translation)) - Preklad I. Hrbek — Czech (Quran Ivan Hrbek - Czech (Translation)) - Hussein Taji — Dari (Quran Hussein Taji - Dari (Translation)) - Badkhashani — Dari (Quran Muhammad Anwar Badkhashani - Dari (Translation)) - Office of the President of Maldives — Divehi (Quran Maldives President Office - Divehi (Translation)) - Salomo Keyzer — Dutch (Quran Salomo Keyzer - Dutch (Translation)) - Fred Leemhuis — Dutch (Quran Fred Leemhuis - Dutch (Translation)) - Sofian S. Siregar — Dutch (Quran Sofian Siregar - Dutch (Translation)) - Sahih International — English (Quran Sahih International - English (Translation)) - Abdullah Yousaf Ali — English (Quran Yousaf Ali - English (Translation)) - Taqi Usmani — English (Quran Taqi Usmani - English (Translation)) - Maulana Maududi — English (Quran Maulana Maududi - English (Translation)) - Safiur Rahman Mubarakpuri — English (Quran Mubarakpuri - English (Translation)) - Marmaduke Pickthall — English (Quran Marmaduke Pickthall - English (Translation)) - Muhammad Sarwar — English (Quran Muhammad Sarwar - English (Translation)) - Muhammad Habib Shakir — English (Quran Habib Shakir - English (Translation)) - Muhammad Hamidullah — French (Quran Muhammad Hamidullah - French (Translation)) - Abu Rida Muhammad ibn Ahmad ibn Rassoul — German (Quran Abu Rida Rassoul - German (Translation)) - A. S. F. Bubenheim and N. Elyas — German (Quran Bubenheim Elyas - German (Translation)) - Adel Theodor Khoury — German (Quran Adel Khoury - German (Translation)) - Amir Zaidan — German (Quran Amir Zaidan - German (Translation)) - Rabila Al-Umry — Gujarati (Quran Rabila Al-Umry - Gujarati (Translation)) - Abubakar Mahmoud Gumi — Hausa (Quran Abubakar Gumi - Hausa (Translation)) - Dar Al-Salam — Hebrew (Quran Dar Al-Salam Center - Hebrew (Translation)) - Muhammad Farooq Khan and Muhammad Ahmed — Hindi (Quran Farooq Khan Ahmed - Hindi (Translation)) - Suhel Farooq Khan and Saifur Rahman Nadwi — Hindi (Quran Suhel Khan Nadwi - Hindi (Translation)) - Indonesian Ministry of Religious Affairs — Indonesian (Quran Indonesia Kemenag - Indonesian (Translation)) - Muhammad Quraish Shihab et al — Indonesian (Quran Quraish Shihab - Indonesian (Translation)) - Hamza Roberto Piccardo — Italian (Quran Roberto Piccardo - Italian (Translation)) - Othman al-Sharif — Italian (Quran Othman al-Sharif - Italian (Translation)) - Ryoichi Mita — Japanese (Quran Ryoichi Mita - Japanese (Translation)) - Saeed Sato — Japanese (Quran Saeed Sato - Japanese (Translation)) - Bashir Missouri — Kannada (Quran Bashir Missouri - Kannada (Translation)) - Bayanul Furqan — Kashmiri (Quran Bayanul Furqan (Koshur Quran) - Kashmiri (Translation)) - Khalifa Altay — Kazakh (Quran Khalifa Altay - Kazakh (Translation)) - RMA — Kinyarwanda (Quran Rwanda Muslims Association - Kinyarwanda (Translation)) - Burhan Muhammad-Amin — Kurdish (Quran Burhan Muhammad Amin - Kurdish (Translation)) - Abdullah Muhammad Basmeih — Malay (Quran Abdullah Basmeih - Malay (Translation)) - Haidar — Malayalam (Quran Abdul-Hamid Haidar & Kanhi Muhammad - Malayalam (Translation)) - Karakunnu — Malayalam (Quran Muhammad Karakunnu & Vanidas Elayavoor - Malayalam (Translation)) - Shafi'i Ansari — Marathi (Quran Muhammad Shafi'i Ansari - Marathi (Translation)) - Ahl Al-Hadith Nepal — Nepali (Quran Ahl Al-Hadith Central Society of Nepal - Nepali (Translation)) - Einar Berg — Norwegian (Quran Einar Berg - Norwegian (Translation)) - Ghali Apaghuna — Oromo (Quran Ghali Apapur Apaghuna - Oromo (Translation)) - Abdulwali Khan — Pashto (Quran Abdulwali Khan - Pashto (Translation)) - Hussain Ansarian — Persian (Quran Hussain Ansarian - Persian (Translation)) - Abolfazl Bahrampour — Persian (Quran Abolfazl Bahrampour - Persian (Translation)) - Mohammad Mahdi Fooladvand — Persian (Quran Mahdi Fooladvand - Persian (Translation)) - Mohsen Gharaati — Persian (Quran Mohsen Gharaati - Persian (Translation)) - Mahdi Elahi Ghomshei — Persian (Quran Mahdi Ghomshei - Persian (Translation)) - Baha'oddin Khorramshahi — Persian (Quran Bahaoddin Khorramshahi - Persian (Translation)) - Mostafa Khorramdel — Persian (Quran Mostafa Khorramdel - Persian (Translation)) - Naser Makarem Shirazi — Persian (Quran Makarem Shirazi - Persian (Translation)) - Mohammad Kazem Moezzi — Persian (Quran Kazem Moezzi - Persian (Translation)) - Sayyed Jalaloddin Mojtabavi — Persian (Quran Jalaloddin Mojtabavi - Persian (Translation)) - Mohammad Sadeqi Tehrani — Persian (Quran Sadeqi Tehrani - Persian (Translation)) - Sayyed Mohammad Reza Safavi — Persian (Quran Mohammad Reza Safavi - Persian (Translation)) - Józefa Bielawskiego — Polish (Quran Jozefa Bielawskiego - Polish (Translation)) - Samir El-Hayek — Portuguese (Quran Samir El Hayek - Portuguese (Translation)) - George Grigore — Romanian (Quran George Grigore - Romanian (Translation)) - Abu Adel — Russian (Quran Abu Adel - Russian (Translation)) - Muslim Religious Board of the Republiс of Tatarstan — Russian (Quran Tatarstan Religious Board - Russian (Translation)) - Ignaty Yulianovich Krachkovsky — Russian (Quran Ignaty Krachkovsky - Russian (Translation)) - Elmir Kuliev — Russian (Quran Elmir Kuliev - Russian (Translation)) - V. Porokhova — Russian (Quran Valeriya Porokhova - Russian (Translation)) - Gordy Semyonovich Sablukov — Russian (Quran Gordy Sablukov - Russian (Translation)) - Dar Al-Salam — Serbian (Quran Dar Al-Salam Center - Serbian (Translation)) - Taj Amroti — Sindhi (Quran Taj Mehmood Amroti - Sindhi (Translation)) - Rowwad Center — Sinhala (Quran Rowwad Translation Center - Sinhala (Translation)) - Mahmud Muhammad Abduh — Somali (Quran Mahmud Abduh - Somali (Translation)) - Raúl González Bórnez — Spanish (Quran Raul Gonzalez Bornez - Spanish (Translation)) - Julio Cortes — Spanish (Quran Julio Cortes - Spanish (Translation)) - Muhammad Isa García — Spanish (Quran Isa Garcia - Spanish (Translation)) - Ali Muhsin Al-Barwani — Swahili (Quran Ali Al Barwani - Swahili (Translation)) - Knut Bernström — Swedish (Quran Knut Bernstrom - Swedish (Translation)) - AbdolMohammad Ayati — Tajik (Quran Abdol Mohammad Ayati - Tajik (Translation)) - Jan Turst Foundation — Tamil (Quran Jan Trust Foundation - Tamil (Translation)) - Abder-Rahim — Telugu (Quran Abder-Rahim ibn Muhammad - Telugu (Translation)) - Azeez ur Rahman — Telugu (Quran Muhammad Azeez ur Rahman - Telugu (Translation)) - KFQC — Thai (Quran King Fahad Quran Complex - Thai (Translation)) - SIU — Thai (Quran Society of Institutes and Universities - Thai (Translation)) - Suleyman Ates — Turkish (Quran Suleyman Ates - Turkish (Translation)) - Alİ Bulaç — Turkish (Quran Ali Bulac - Turkish (Translation)) - Diyanet Isleri — Turkish (Quran Diyanet Isleri - Turkish (Translation)) - Abdulbaki Golpinarli — Turkish (Quran Abdulbaki Golpinarli - Turkish (Translation)) - Yasar Nuri Ozturk — Turkish (Quran Yasar Nuri Ozturk - Turkish (Translation)) - Diyanet Vakfi — Turkish (Quran Diyanet Vakfi - Turkish (Translation)) - Elmalili Hamdi Yazir — Turkish (Quran Elmalili Hamdi Yazir - Turkish (Translation)) - Suat Yildirim — Turkish (Quran Suat Yildirim - Turkish (Translation)) - Edip Yüksel — Turkish (Quran Edip Yuksel - Turkish (Translation)) - Yaqubovic — Ukrainian (Quran Mikhailo Yaqubovic - Ukrainian (Translation)) - Fateh Jhalandari — Urdu (Quran Fateh Jhalandari - Urdu (Translation)) - Maulana Maududi — Urdu (Quran Maulana Maududi - Urdu (Translation)) - Taqi Usmani — Urdu (Quran Taqi Usmani - Urdu (Translation)) - Maulana Junagari — Urdu (Quran Muhammad Junagari - Urdu (Translation)) - Dr. Israr Ahmad — Urdu (Quran Israr Ahmad - Urdu (Translation)) - Ahmad Raza Khan — Urdu (Quran Ahmad Raza Khan - Urdu (Translation)) - Maulana Islahi — Urdu (Quran Amin Ahsan Islahi - Urdu (Translation)) - Dr. Tahirul Qadri — Urdu (Quran Tahir Ul Qadri - Urdu (Translation)) - Maulana Abdus Salam — Urdu (Quran Abdus Salam - Urdu (Translation)) - Dr. Aslam Siddiqui — Urdu (Quran Aslam Siddiqui - Urdu (Translation)) - Allama Jawadi — Urdu (Quran Allama Jawadi - Urdu (Translation)) - Hussain Najafi — Urdu (Quran Hussain Najafi - Urdu (Translation)) - Mrs. Riffat Ijaz — Urdu (Quran Riffat Ijaz - Urdu (Translation)) - Muhammad Saleh — Uyghur (Quran Muhammad Saleh - Uyghur (Translation)) - Muhammad Sodik Muhammad Yusuf — Uzbek (Quran Sodik Muhammad Yusuf - Uzbek (Translation)) - Hasan Abdul-Karim — Vietnamese (Quran Hasan Abdul-Karim - Vietnamese (Translation)) - Rowwad Center — Vietnamese (Quran Rowwad Translation Center - Vietnamese (Translation)) - Mikael Aykyuni — Yoruba (Quran Mikael Aykyuni - Yoruba (Translation)) ### Tafsir (95) - Al-Saadi — Albanian (Quran Taysir al-Karim al-Rahman al-Saadi - Albanian (Tafsir)) - Imam Ibn Kathir — Arabic (Quran Tafsir Ibn Kathir - Arabic (Tafsir)) - Al-Qurtubi — Arabic (Quran Al-Jami' li-Ahkam al-Quran al-Qurtubi - Arabic (Tafsir)) - Al-Saddi — Arabic (Quran Tafsir al-Saddi - Arabic (Tafsir)) - Ibn Ashur — Arabic (Quran Al-Tahrir wa al-Tanwir Ibn Ashur - Arabic (Tafsir)) - Al-Baghawi — Arabic (Quran Ma'alim al-Tanzil al-Baghawi - Arabic (Tafsir)) - Al-Tabari — Arabic (Quran Jami' al-Bayan fi Ta'wil al-Quran al-Tabari - Arabic (Tafsir)) - Al-Wahidi — Arabic (Quran Al-Wasit fi Tafsir al-Quran al-Wahidi - Arabic (Tafsir)) - Saudi Scholars — Arabic (Quran Al-Tafsir al-Muyassar - Arabic (Tafsir)) - KFQC — Arabic (Quran Al-Mukhtasar fi Tafsir al-Quran - Arabic (Tafsir)) - Al-Jazairi — Arabic (Quran Aysar al-Tafasir Abu Bakr Jabir al-Jazairi - Arabic (Tafsir)) - Al-Shanqiti — Arabic (Quran Adwa' al-Bayan al-Shanqiti - Arabic (Tafsir)) - Abu Hayyan — Arabic (Quran Al-Bahr al-Muhit Abu Hayyan al-Andalusi - Arabic (Tafsir)) - Al-Wahidi — Arabic (Quran Al-Basit fi Tafsir al-Quran al-Wahidi - Arabic (Tafsir)) - Al-Samin — Arabic (Quran Al-Durr al-Masun al-Samin al-Halabi - Arabic (Tafsir)) - Jalal al-Din al-Suyuti — Arabic (Quran Al-Durr al-Manthur al-Suyuti - Arabic (Tafsir)) - Al-Zamakhshari — Arabic (Quran Al-Kashshaf al-Zamakhshari - Arabic (Tafsir)) - Ibn Adil — Arabic (Quran Al-Lubab fi Ulum al-Kitab Ibn Adil al-Hanbali - Arabic (Tafsir)) - Ibn Atiyyah — Arabic (Quran Al-Muharrar al-Wajiz Ibn Atiyyah - Arabic (Tafsir)) - Saudi Scholars — Arabic (Quran Al-Muyassar fi Gharib al-Quran - Arabic (Tafsir)) - Al-Wahidi — Arabic (Quran Al-Wajiz fi Tafsir al-Quran al-Wahidi - Arabic (Tafsir)) - Al-Qannuji — Arabic (Quran Fath al-Bayan fi Maqasid al-Quran al-Qannuji - Arabic (Tafsir)) - Al-Shawkani — Arabic (Quran Fath al-Qadir al-Shawkani - Arabic (Tafsir)) - Al-Iji — Arabic (Quran Jami' al-Bayan al-Iji - Arabic (Tafsir)) - Al-Qasimi — Arabic (Quran Mahasin al-Ta'wil al-Qasimi - Arabic (Tafsir)) - Mawsoo' Scholars — Arabic (Quran Mawsu'at al-Tafsir al-Ma'thur - Arabic (Tafsir)) - Al-Biqa'i — Arabic (Quran Nazm al-Durar al-Biqa'i - Arabic (Tafsir)) - Tadabbur Scholars — Arabic (Quran Tadabbur wa Amal - Arabic (Tafsir)) - Abu al-Su'ud — Arabic (Quran Irshad al-'Aql al-Salim Abu al-Su'ud - Arabic (Tafsir)) - Al-Alusi — Arabic (Quran Ruh al-Ma'ani al-Alusi - Arabic (Tafsir)) - Al-Baydawi — Arabic (Quran Anwar al-Tanzil wa Asrar al-Ta'wil al-Baydawi - Arabic (Tafsir)) - Al-Mawardi — Arabic (Quran Al-Nukat wa al-'Uyun al-Mawardi - Arabic (Tafsir)) - Al-Nasafi — Arabic (Quran Madarik al-Tanzil wa Haqa'iq al-Ta'wil al-Nasafi - Arabic (Tafsir)) - Al-Razi — Arabic (Quran Mafatih al-Ghayb Fakhr al-Din al-Razi - Arabic (Tafsir)) - Al-Samani — Arabic (Quran Tafsir al-Quran al-Samani - Arabic (Tafsir)) - Al-Samarqandi — Arabic (Quran Bahr al-'Ulum al-Samarqandi - Arabic (Tafsir)) - Al-Tha'alibi — Arabic (Quran Al-Jawahir al-Hisan fi Tafsir al-Quran al-Tha'alibi - Arabic (Tafsir)) - Al-Tha'labi — Arabic (Quran Al-Kashf wa al-Bayan 'an Tafsir al-Quran al-Tha'labi - Arabic (Tafsir)) - Al-Saadi — Arabic (Quran Taysir al-Karim al-Rahman al-Saadi - Arabic (Tafsir)) - Ibn Abi Hatim — Arabic (Quran Tafsir al-Quran al-'Azim Ibn Abi Hatim - Arabic (Tafsir)) - Ibn Abi Zamanin — Arabic (Quran Tafsir al-Quran al-'Aziz Ibn Abi Zamanin - Arabic (Tafsir)) - Ibn al-Jawzi — Arabic (Quran Zad al-Masir fi 'Ilm al-Tafsir Ibn al-Jawzi - Arabic (Tafsir)) - Ibn al-Qayyim — Arabic (Quran Tafsir Ibn al-Qayyim al-Jawziyyah - Arabic (Tafsir)) - Ibn Juzay — Arabic (Quran Al-Tashil li-'Ulum al-Tanzil Ibn Juzay - Arabic (Tafsir)) - Al-Mahalli — Arabic (Quran Tafsir Al-Jalalayn - Arabic (Tafsir)) - Makki — Arabic (Quran Tafsir Makki ibn Abi Talib al-Qaysi - Arabic (Tafsir)) - KFQC — Arabic (Quran Tahlil Kalimat al-Quran - Arabic (Grammatical Analysis)) - KFQC — Assamese (Quran Al-Mukhtasar fi Tafsir al-Quran - Assamese (Tafsir)) - Imam Ibn Kathir — Bengali (Quran Tafsir Ibn Kathir - Bengali (Tafsir)) - Abu Bakr Zakaria — Bengali (Quran Tafsir Abu Bakr Muhammad Zakaria - Bengali (Tafsir)) - Salahudin Yousaf — Bengali (Quran Ahsanul Bayaan Salahuddin Yusuf - Bengali (Tafsir)) - Fathul Majid — Bengali (Quran Fathul Majid - Bengali (Tafsir)) - KFQC — Bosnian (Quran Al-Mukhtasar fi Tafsir al-Quran - Bosnian (Tafsir)) - KFQC — Chinese (Quran Al-Mukhtasar fi Tafsir al-Quran - Chinese (Tafsir)) - Maulana Maududi — English (Quran Tafheem Ul Quran - English (Tafsir)) - Al-Mahalli — English (Quran Tafsir Al-Jalalayn - English (Tafsir)) - Wahiduddin Khan — English (Quran Tazkirul Quran Wahiduddin Khan - English (Tafsir)) - Mufti Muhammad Shafi — English (Quran Maarif ul-Quran Mufti Shafi - English (Tafsir)) - KFQC — French (Quran Al-Mukhtasar fi Tafsir al-Quran - French (Tafsir)) - KFQC — Hindi (Quran Al-Mukhtasar fi Tafsir al-Quran - Hindi (Tafsir)) - Al-Saadi — Indonesian (Quran Taysir al-Karim al-Rahman al-Saadi - Indonesian (Tafsir)) - KFQC — Indonesian (Quran Al-Mukhtasar fi Tafsir al-Quran - Indonesian (Tafsir)) - KFQC — Italian (Quran Al-Mukhtasar fi Tafsir al-Quran - Italian (Tafsir)) - KFQC — Japanese (Quran Al-Mukhtasar fi Tafsir al-Quran - Japanese (Tafsir)) - Rebar — Kurdish (Quran Tafsir Rebar - Kurdish (Tafsir)) - KFQC — Kurdish (Quran Al-Mukhtasar fi Tafsir al-Quran - Kurdish (Tafsir)) - KFQC — Kyrgyz (Quran Al-Mukhtasar fi Tafsir al-Quran - Kyrgyz (Tafsir)) - KFQC — Malayalam (Quran Al-Mukhtasar fi Tafsir al-Quran - Malayalam (Tafsir)) - KFQC — Pashto (Quran Al-Mukhtasar fi Tafsir al-Quran - Pashto (Tafsir)) - Al-Saadi — Persian (Quran Taysir al-Karim al-Rahman al-Saadi - Persian (Tafsir)) - KFQC — Persian (Quran Al-Mukhtasar fi Tafsir al-Quran - Persian (Tafsir)) - Al-Saadi — Russian (Quran Taysir al-Karim al-Rahman al-Saadi - Russian (Tafsir)) - Imam Ibn Kathir — Russian (Quran Tafsir Ibn Kathir - Russian (Tafsir)) - KFQC — Serbian (Quran Al-Mukhtasar fi Tafsir al-Quran - Serbian (Tafsir)) - KFQC — Sinhala (Quran Al-Mukhtasar fi Tafsir al-Quran - Sinhala (Tafsir)) - KFQC — Spanish (Quran Al-Mukhtasar fi Tafsir al-Quran - Spanish (Tafsir)) - KFQC — Tagalog (Quran Al-Mukhtasar fi Tafsir al-Quran - Tagalog (Tafsir)) - KFQC — Tamil (Quran Al-Mukhtasar fi Tafsir al-Quran - Tamil (Tafsir)) - KFQC — Thai (Quran Al-Mukhtasar fi Tafsir al-Quran - Thai (Tafsir)) - Al-Saadi — Turkish (Quran Taysir al-Karim al-Rahman al-Saadi - Turkish (Tafsir)) - Imam Ibn Kathir — Turkish (Quran Tafsir Ibn Kathir - Turkish (Tafsir)) - KFQC — Turkish (Quran Al-Mukhtasar fi Tafsir al-Quran - Turkish (Tafsir)) - Imam Ibn Kathir — Urdu (Quran Tafsir Ibn Kathir - Urdu (Tafsir)) - Maulana Maududi — Urdu (Quran Tafheem Ul Quran - Urdu (Tafsir)) - Dr. Israr Ahmad — Urdu (Quran Bayan Ul Quran - Urdu (Tafsir)) - Taqi Usmani — Urdu (Quran Aasaan Quran - Urdu (Tafsir)) - Salahudin Yousaf — Urdu (Quran Ahsan Ul Bayan - Urdu (Tafsir)) - Mufti Muhammad Shafi — Urdu (Quran Maariful Quran - Urdu (Tafsir)) - Taqi Usmani — Urdu (Quran Tayseer Ul Quran - Urdu (Tafsir)) - Al-Saadi — Urdu (Quran Taysir al-Karim al-Rahman al-Saadi - Urdu (Tafsir)) - Sayyid Qutb — Urdu (Quran Fi Zilal al-Quran Sayyid Qutb - Urdu (Tafsir)) - Wahiduddin Khan — Urdu (Quran Tazkirul Quran Wahiduddin Khan - Urdu (Tafsir)) - KFQC — Uyghur (Quran Al-Mukhtasar fi Tafsir al-Quran - Uyghur (Tafsir)) - KFQC — Uzbek (Quran Al-Mukhtasar fi Tafsir al-Quran - Uzbek (Tafsir)) - KFQC — Vietnamese (Quran Al-Mukhtasar fi Tafsir al-Quran - Vietnamese (Tafsir))