# 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.4-beta - 29 Hadith books · 170,523+ narrations · 114 surahs · 122 Quran translations · 95 tafsir · 62 languages ## 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 ### 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 ### The Hadith Library (https://alislam.lymrah.com/docs/hadith-library) *29 authentic collections with references, Sanad and Takhreej.* Al Islam's **Hadith section** provides access to **29 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 **29 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/collection)** — 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/collection)** — save this hadith to Collections - **Change language** — switch to a different language translation - **Copy** — copy the hadith text (long-press to copy everything, including metadata) - **[Customize text](/docs/text-customization)** — adjust typography for this view ### 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 **Random Hadith** section on the home screen displays random hadith from your downloaded collections. ### How It Works - Pulls hadith randomly from **all your downloaded collections** - Only searches in the **language you've selected** - Shows one hadith at a time in a beautiful interface - Updates every time you refresh or swipe ### Actions from Random Hadith From the Random Hadith view, you can: - **Bookmark** — save this hadith to Collections - **Customize text** — adjust typography - **Copy** — copy the hadith text - **Preview** — open the full preview screen - **Swipe to next** — get another random hadith ### Performance The Random Hadith feature is **extremely fast**, even with many downloaded collections. Random selection happens **instantly** regardless of how many collections or hadith you have downloaded. ### Scope The more collections you download, the larger the pool from which random hadith are selected. --- ## 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:** - **29 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. ### 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** — 170,523 narrations across 29 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 170,523 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 170,523 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 170,523 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 ### 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.* The core library is free. **Premium** removes ads and unlocks the full experience. ## What you get - A completely **ad-free** experience. - **Cloud sync** for bookmarks, notes and history. - Unlimited location profiles. - Priority access to new books, languages and features. Billed securely through **Google Play**; cancel anytime. ### 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/calender) *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.4-beta — Miqat (2026-07-09) # Al Islam — Version 4.4 (Beta) ## Miqat **📅 Release Date:** 09 May 2026 (Only accessible to beta users) **Release Type:** Major Tools, Calendar, Prayer Times, Widgets & Content Update Version **4.4** is a major daily-utility expansion for **Al Islam**, introducing new Islamic tools, a full Hijri calendar system, dhikr tracking, expanded Prayer Times astronomy, Android home screen widgets, Qibla finder, and many refinements across the app. This update focuses on making Al Islam more useful throughout the day: finding the Qibla, checking prayer times, following the Hijri calendar, tracking fasts, counting dhikr, viewing moon phases, checking upcoming Islamic dates, and keeping essential Islamic information visible directly from the home screen. > Several new systems in this release are in their first major public phase. They are already usable and deeply featured, but future updates will continue improving layouts, flexibility, convenience, widgets, and overall user experience. --- ## 🧭 Complete Qibla Finder Version 4.4 introduces an all-new **Qibla Finder** inside the **Tools** section. This is not a simple compass-only screen; it is a complete Qibla direction system with multiple ways to find, verify, inspect, and customize the Qibla direction. The Qibla Finder connects with existing **Prayer Times location profiles**, so users can use their saved locations without setting up a separate Qibla location again. Users can follow the active Prayer Times location, choose from saved profiles, or use location detection where available. ### Multi-Method Qibla Guidance | View | What it does | | ------------ | ---------------------------------------------------------------------------------------------------------------- | | **Compass** | Live Qibla compass with heading, bearing, sensor accuracy, declination, Sun/Moon markers, and alignment feedback | | **Map** | Geographic Qibla view with Kaaba marker, user location, Great Circle path, and Rhumb Line comparison | | **AR** | Camera-based Qibla overlay for real-world direction finding | | **Sun** | Sensor-free Qibla verification using solar position and shadows | | **Insights** | Scientific breakdown of bearings, distance, Earth geometry, and magnetic environment | The **Compass** view shows the live heading, Qibla bearing, degree markers, direction labels, Qibla marker, and alignment confirmation. It can also show the Sun and Moon on the compass dial, the current moon phase, user coordinates, distance to the Kaaba, and solar verification information. To improve reliability, the compass includes sensor accuracy indicators, magnetic declination, tilt warnings, bubble-level support, and magnetic interference awareness. This helps users understand when the phone compass may be affected by nearby metal, electronics, vehicles, magnetic cases, or indoor interference. The **Map** view shows the user’s position and the Kaaba on a map, including the **Great Circle** shortest path and **Rhumb Line** fixed-bearing path. This helps explain why Qibla direction can look different on a flat map compared to the actual direction over Earth’s curved surface. The **AR** view overlays Qibla guidance directly on the live camera view. Users can point the phone around a room, hotel, office, airport, or outdoor space and see the Qibla direction in the real environment. The **Sun** view provides a physical verification method using sunlight and shadows. It can show solar Qibla moments such as shadow-along-Qibla and sun-over-Qibla style alignment, allowing users to verify direction without relying only on the magnetic compass. The **Insights** view exposes the technical layer behind the result. It can show Great Circle, Ellipsoidal / WGS-84, and Rhumb Line bearings; user coordinates; Kaaba coordinates; journey midpoint; distance comparisons; bearing drift; Earth globe visualization; day/night terminator; magnetic declination; inclination; expected and measured field strength; and interference warnings. ### Qibla Customization A dedicated customization screen gives users detailed control over how Qibla Finder behaves and appears. Key options include: * Bearing method: **Great Circle**, **Ellipsoidal / WGS-84**, or **Rhumb Line** * North reference: **True North** or **Magnetic North** * Manual declination override * Heading offset and calibration * Coordinate format and distance unit * 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, Sun/Moon dial markers * AR bearing ruler and AR marker size * Earth globe, sky path chart, moon arc, moon phase disc * Field strength gauge, bearing comparison ruler, declination rose * Default opening view and location behavior * Visible cards, chips, and scientific overlays --- ## 🌙 Full Hijri Calendar System Version 4.4 adds a complete **Hijri Calendar** system to Al Islam. This is not only a Hijri date grid; it is a full Islamic calendar environment with Hijri dates, Gregorian correspondence, moon phases, Islamic occasions, fasting logs, personal events, date conversion, Hijri birthday calculation, reminders, and customization. The calendar is designed to be useful immediately when opened. Users can see today’s Hijri date, Arabic month name, Gregorian date, weekday, sacred-month status where applicable, current moon phase, month progress, and the next important Islamic date. ### Today, Moon Phase & Upcoming Dates The top calendar area includes a rich current-day card showing the Hijri date, Arabic month name, Gregorian date, weekday, moon phase, illumination percentage, and progress through the Hijri month. Upcoming Islamic dates are shown in a dedicated strip, making it easy to see what is coming next without manually browsing the calendar. Examples of upcoming date types include: * White Days * Ramadan-related dates * Rajab and Dhul-Hijjah dates * Ashura and Arafah * Eid dates * Mawlid an-Nabi ﷺ * Other important Islamic occasions ### Interactive Hijri Month Grid The month grid shows Hijri dates with companion Gregorian dates inside each cell. It highlights today, selected dates, Jumu’ah, outside-month days, Islamic occasions, fasting days, logged fasts, personal events, and moon phase markers. When a user selects a date, the day panel can show: * Hijri date and Gregorian date * Weekday and Arabic month name * Moon phase and moon illumination * Islamic occasion details * Countdown information * Fasting context * Personal events * Actions to log fast, add event, copy, or share ### Year Overview & Fast Navigation A new year overview shows all twelve Hijri months as compact month cards. Each month can show its length and event count, making it easier to plan around Ramadan, Dhul-Hijjah, Muharram, Rajab, and other important months. The new jump system allows users to move directly to a specific Hijri month and year using month chips, year selection, type input, or the Today shortcut. ### Events, Personal Reminders & Fasting Logs The calendar includes a dedicated **Events & Occasions** section that gathers built-in Islamic occasions, personal events, reminders, and fasting logs in one place. Personal events can include: * Custom title * Emoji or icon * Custom color * Hijri or Gregorian date * Yearly repeat or one-time behavior * Reminder timing * Markdown notes * Archive and delete management This makes the calendar useful for Hijri birthdays, family dates, anniversaries, personal reminders, vows, study milestones, Islamic goals, and private calendar notes. Fasting logs are integrated directly into the calendar. Users can log fasts, see them on the calendar grid, track fasting activity for the month, review last-30-days activity, and maintain all-time fasting records. The fasting lens can highlight: * Sunnah fasting days * Obligatory fasting days * Forbidden fasting days * User-logged fasts * Fasting nudges such as Monday/Thursday reminders ### Date Converter & Hijri Birthday Finder The new **Date Converter** allows users to convert between Hijri and Gregorian dates using smooth date wheels. When one calendar changes, the other updates instantly. The result card can show: * Converted Hijri/Gregorian date * Weekday * Arabic month name * Moon phase * Days remaining or days ago * Open in calendar * Copy and share actions The **Hijri Birthday Finder** helps users find their Hijri date of birth from a Gregorian birth date. It can show the Hijri birth date, age in Hijri years, age in Gregorian years, next Hijri birthday, and countdown. ### Calendar Customization The Hijri Calendar includes deep customization while keeping the main experience simple. Users can configure: | 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** | JSON export/import and reset to defaults | --- ## 📿 Tasbeeh Counter & Dhikr Tracker Version 4.4 introduces a complete **Tasbeeh Counter** and dhikr tracking system inside Tools. It is designed as a focused dhikr companion with live counting, custom adhkar, routines, goals, streaks, statistics, feedback controls, and personalization. The main experience is simple: select a dhikr and tap to count. Behind that, the system includes progress tracking, session data, undo/redo, quick-add controls, custom dhikr creation, templates, library management, and long-term statistics. ### Main Counter Experience The Tasbeeh screen shows pinned or recent adhkar at the top, allowing users to quickly switch between dhikr items such as SubhanAllah, Alhamdulillah, Allahu Akbar, La ilaha illallah, Astaghfirullah, and custom entries. Each dhikr can display Arabic text, transliteration, translation, and virtue or reward text. The main counter uses a large visual progress ring showing the current count and target. Users can: * Tap to count * Use quick-add: `+10`, `+33`, `+100` * Undo mistakes * Redo actions * Reset the current count * View session duration * View session count and pace * Track daily goal progress * See streaks, today’s count, and seven-day count A focus mode is included for users who want a cleaner counting screen. It hides extra controls so the user can concentrate on the active dhikr and counter. ### Dhikr Library & Custom Adhkar The new **Dhikr Library** manages built-in and custom adhkar. Each dhikr card can show its icon, title, category, target, and lifetime count. Users can: * Search adhkar and categories * Favorite dhikr * Pin or unpin dhikr * Edit entries * Archive entries * Create custom dhikr * Start from templates * Manage routines Custom dhikr can include Arabic text, transliteration, translation, virtue / reward / fadl text, category, target per lap, step per tap, daily goal, emoji/icon, and accent color. ### Routines Tasbeeh supports structured dhikr routines. This is useful for post-prayer adhkar, morning adhkar, evening adhkar, or personal dhikr sequences. Combined with target behavior settings, users can move through multiple adhkar in an organized flow. ### Tasbeeh Statistics The statistics screen gives users a detailed view of dhikr activity over time. It can show lifetime counts, today’s count, last seven days, last thirty days, current streak, best streak, best day, goal days, personal records, recent sessions, and per-dhikr breakdowns. Visual tracking includes: * Daily activity heatmap * Recent-weeks activity grid * Last 14 days vs goal chart * Per-dhikr progress bars * Recent session history * Longest session * Fastest pace * Counts per minute This turns Tasbeeh into more than a tap counter. It becomes a long-term dhikr habit tracker. ### Tasbeeh Customization Tasbeeh includes a dedicated customization screen for feedback, gestures, behavior, appearance, reminders, and data. | 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 | --- ## ☀️ Prayer Times: Sun, Sky & Hijri Expansion Prayer Times receives a major expansion in version 4.4. The existing system already supports location profiles, precise location, search location, manual coordinates, time zone selection, 11 calculation methods, Asr standards, high-latitude rules, rounding, twilight definitions, Hijri date offset, profile switching, temporary location search, and offline calculation. This update adds new **Sun**, **Sky**, and **Hijri** views, turning Prayer Times into a more visual and educational Islamic time system. ### Sun View The new Sun tab explains the prayer day through solar movement. A solar altitude curve shows the Sun’s path across the day, with Fajr, sunrise, Dhuhr, Asr, Maghrib, and Isha placed directly on the curve. This helps users understand how prayer times relate to the Sun: * Fajr and Isha appear in twilight zones * Sunrise and Maghrib appear around the horizon * Dhuhr appears near solar noon * Asr appears on the descending solar path according to the selected Asr standard The Sun view also includes a **Twilight Ladder**, showing depression angles live. It visualizes the apparent horizon, civil twilight, nautical twilight, astronomical twilight, and current sun position. This helps users understand what calculation angles such as 18°, 17°, 15°, or 19.5° actually represent. The Solar Almanac can show: | Solar Data | Meaning | | ------------------------------------------------ | ---------------------------------------------- | | **Solar noon** | When the Sun reaches its highest point | | **Equation of time** | Difference between sundial time and clock time | | **Day length / Night length** | Duration of daylight and night | | **Solar declination** | Sun’s celestial latitude | | **Apparent sunrise / sunset** | Refraction-aware rise and set times | | **Duha begins** | Duha time based on solar altitude | | **Solar midnight** | Lower culmination of the Sun | | **Sun altitude now** | Current height of the Sun above/below horizon | | **Hour angle** | Sun’s angle from the local meridian | | **Shadow ratio** | Current shadow-length relationship | | **Right ascension / Julian day / Sidereal time** | Advanced astronomical reference values | ### Sky View The new Sky tab connects Prayer Times with the movement of the Sun and Moon. It includes a sky chart showing sun and moon altitude curves across the day, along with a current-time marker. The Moon card can show: * Current moon phase * Moon illumination percentage * Moon age * Moonrise and moonset * Moon distance * Moon direction and altitude * Next new moon * Next full moon This connects Prayer Times with the lunar calendar and visible sky, making the section more useful for users who care about Hijri dates, moon phases, and sky awareness. ### Hijri View The new Hijri tab inside Prayer Times shows the current Hijri date, month progress, upcoming Islamic dates, and short descriptions of important occasions. It can show upcoming dates such as: * White Days * Mawlid an-Nabi ﷺ * Rajab begins * Ramadan dates * Battle of Badr * Other important Islamic occasions The Hijri tab also includes a next-crescent sighting forecast using the Yallop visibility test. It can show conjunction time, first and second evening visibility, Yallop grade, best viewing time, moon age, lag, ARCV, ARCL, crescent width, and q value. The app also clarifies that official month starts depend on the user’s local sighting authority. ### Date Picker & Almanac Controls Prayer Times date switching now uses the new Hijri/Gregorian date picker. Users can select dates through calendar mode, wheel mode, or type mode, and can work from either Hijri or Gregorian dates. This makes it easier to check prayer times for Ramadan days, Dhul-Hijjah dates, Ashura, White Days, Eid dates, or any specific Hijri or Gregorian date. Because Prayer Times now includes more almanac data, users can enable or disable optional cards from the options menu. This keeps the section flexible for both simple daily prayer-time use and deeper astronomical inspection. --- ## 📱 Android Home Screen Widgets Version 4.4 introduces Android home screen widgets for Al Islam. These widgets bring essential Islamic information directly to the user’s home screen, making Prayer Times, Hijri dates, upcoming occasions, and calendar information visible without opening the app. ### Included Widgets | Widget | What it shows | | ------------------------------- | --------------------------------------------------------------------------------------------------- | | **Prayer Times Widget** | Location, current Hijri date, next prayer, countdown, highlighted prayer time, and daily prayer row | | **Compact Prayer Widget** | Smaller prayer-time layout for quick home-screen viewing | | **Hijri Date Widget** | Current Hijri day, month, year, Arabic month name, and Gregorian date | | **Upcoming Occasions Widget** | Upcoming Islamic dates with icons, Hijri dates, Gregorian dates, and countdowns | | **Hijri Month Calendar Widget** | Full Hijri month grid with companion Gregorian dates and event markers | The Prayer Times widget shows Fajr, Dhuhr, Asr, Maghrib, and Isha directly on the home screen. The Hijri widgets keep the Islamic date and month visible throughout the day. The Upcoming widget helps users prepare for important dates such as White Days, Rajab, Ramadan-related dates, Mawlid an-Nabi ﷺ, and other occasions. Widgets are currently in their first release phase. More widget types, improved layouts, additional controls, and better flexibility are planned for future updates. --- ## 📚 New Islamic Collections Added Version 4.4 adds more Islamic reference content to the app. | 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 | These additions continue expanding Al Islam as a broader Islamic knowledge and daily-practice platform, combining reading, study, reference content, tools, reminders, and personal Islamic utilities in one place. --- ## 🛠️ Refinements, Edge Cases & Stability Version 4.4 also includes many refinements and edge-case fixes across the app. Several potential issues were resolved while integrating the new tools and connecting them with existing systems. Improved areas include: * Qibla calculation and sensor handling * Magnetic interference handling * Compass and AR behavior * Hijri date synchronization * Hijri/Gregorian date conversion * Prayer Times date picker integration * Crescent visibility calculations * Calendar event handling * Fasting log handling * Tasbeeh session tracking * Dhikr statistics * Widget rendering and updates * Home screen data consistency * Tool customization screens * Cross-feature date handling * General UI consistency * Performance and stability The update also improves integration between Prayer Times, Hijri Calendar, Qibla Finder, Tasbeeh Counter, Date Converter, Date Picker, Home Widgets, fasting logs, personal events, and upcoming Islamic dates. --- ## 🌟 Overall Version **4.4 — Miqat** is a major step toward making Al Islam a more complete daily Islamic companion. ### Major additions in this release * Complete Qibla Finder * Full Hijri Calendar * Tasbeeh Counter and Dhikr Library * Tasbeeh Statistics and Routines * Personal Events and Fasting Logs * Date Converter and Hijri Birthday Finder * Hijri/Gregorian Date Picker * Prayer Times Sun, Sky, and Hijri Views * Solar Almanac and Twilight Ladder * Crescent Visibility Forecast * Android Home Screen Widgets * New Islamic Collections * More customization * More edge-case fixes This update brings more Islamic daily-life tools into one connected experience — prayer, direction, calendar, moon, sun, fasting, dhikr, widgets, and reference content — while keeping the app modern, convenient, customizable, and deeply integrated. 📱 Application: Al Islam 🏷️ Version: **4.4 — Miqat (Beta)** 🗓️ Release Date: **July 9, 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. The core library of 29 Hadith books and the Quran is free. A Premium subscription removes ads and unlocks the full, uninterrupted experience. **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) **Do I need an account?** You can read without an account. Signing in lets you sync bookmarks, notes and history across devices and manage your Premium subscription. **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. **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. **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. **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. ## About Al Islam (https://alislam.lymrah.com/about) **Al Islam** (`com.pakdeen.alislam`) is a comprehensive Islamic knowledge platform designed from the ground up to provide **authentic Islamic content** in an intuitive, powerful, and beautifully-designed interface. Built by **Lymrah**, Al Islam combines **infrastructure-first design** with **user-centric convenience** to make Islamic scholarship accessible to everyone, everywhere. Currently on **version 4.4-beta**. 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 simply stack features on top of each other. Instead, we **build systems** — cohesive, interconnected infrastructure designed to handle complexity while remaining intuitive. This philosophy manifests throughout Al Islam: - **[Prayer Times](/docs/prayer-times)** — not just static calculations, but a system supporting 11 calculation methods, multiple Asr standards, high-latitude adjustments, location profiles, and offline operation - **[Search](/docs/search)** — not a simple keyword matcher, but a custom Lucene-inspired engine optimized for mobile, supporting advanced query syntax, diacritics, and intelligent filtering - **[Collections](/docs/collections)** — not just bookmarks, but a full file-manager-style organization system with unlimited nesting, markdown annotations, cloud sync, and conflict resolution - **[Text Customization](/docs/text-customization)** — not preset themes, but a unified system allowing per-language, per-section granular typography control Every system is designed with **sensible defaults** so users experience convenience immediately, while **unlimited customization** is available for those who need it. ### Technology & Architecture **Modern Foundation** Al Islam is built using modern technologies, the latest industry-standard frameworks, and a **highly modular architecture** without relying on any legacy technology stack. **Performance Optimization** Performance-critical components are **heavily optimized** with low-level architectural improvements to ensure smooth operation throughout the app: - **Custom search engine** — millisecond-level results across 170K+ hadith - **Dynamic RAM allocation** — scales with device capability, works smoothly on low-end devices - **Pagination & lazy loading** — handles millions of items with zero lag - **Concurrent operations** — multiple searches, syncs, and calculations happen simultaneously without blocking the UI ### Security & Privacy **Security is a highest priority:** - **All data protected** using multiple layers of strong encryption - **Encrypted search indices** — search doesn't compromise privacy - **Encrypted cloud sync** — TLS 1.3 in transit, AES-256 at rest - **Zero server calls** for local features — your location, reading history, and collections are yours alone unless you opt-in to cloud backup **Your Privacy:** - **Local-by-default** — everything works offline and on-device - **Optional cloud backup** — only if you explicitly enable it - **No tracking** — we don't track what you read or study - **Transparent encryption** — your keys are derived from your password; we cannot access your data ### Data Integrity & Reliability **Before every release**, all data passes through: - **Regression testing** — ensuring nothing breaks - **Structural validation** — verifying data consistency - **Data integrity pipelines** — catching corruption before release **Reactive Architecture:** The app is designed to **automatically recover** from interruptions: - **Transactional indexing** — if interrupted mid-index, the old index remains valid - **Conflict resolution** — automatic merging of concurrent edits across devices - **Progressive syncing** — changes queue if offline and sync when reconnected --- ## What You Get ### Content **[Quran](/quran):** - 6,236 verses (Ayahs) - 122 translations across 62 languages - 95 tafsir (interpretation) works - Complete offline access **[Hadith](/library):** - 29 major collections (Sahih Sittah and others) - 170,523 narrations - 5 languages (Arabic, English, Urdu, Hindi, Bangla) - Comprehensive metadata (grading, authenticity, narrators) **Features:** - **[Search](/docs/search)** — Custom Lucene-inspired engine with text and reference matching, advanced query syntax, and intelligent filtering - **[Prayer Times](/docs/prayer-times)** — 11 calculation methods, multiple Asr standards, location profiles, offline operation, high-latitude adjustments, Hijri date synchronization - **[Collections](/docs/collections)** — File-manager-style bookmarking and organization with unlimited nesting, markdown notes, cloud backup, and automatic syncing - **[Text Customization](/docs/text-customization)** — Unified typography control supporting per-language customization, custom fonts, color selection, all with real-time preview - **[Hadith Section](/docs/hadith)** — 29 collections with rich metadata, sorting, language selection, progress tracking, and beautiful preview screens - **[Quran Section](/docs/quran)** — Complete Quranic content with tabbed navigation, Go to Verse jumping, translation and tafsir browsing, and comprehensive referencing - **[History](/docs/history)** — Detailed reading logs, comprehensive Dashboard with metrics, streaks, activity graphs, and reading habit analysis ### Design & User Experience **Modern, Polished Design:** - Clean, intuitive interface following current design standards - Consistent visual language throughout the app - Smooth animations and transitions - Dark and light theme support - Accessibility-first design **Convenient, Handiness-Focused:** - Smart defaults that work for most users - Minimal configuration required to get started - Quick-access buttons and shortcuts throughout - Contextual actions where you need them **Transparency:** - Every feature documented comprehensively - Detailed explanations of how features work - Complete metadata visible in the app - Clear labeling of all content sources --- ## 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 them. ### What Islamic perspective does Al Islam represent? **Mainstream Islamic 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. ### Is the app free? **Yes.** Al Islam is **free at its core**. All core features — Quran, Hadith, Prayer Times, Search, Text Customization, History, and Collections — are free forever. We offer optional premium features: - **Cloud Backup for Collections** — automatic sync across devices - **Unlimited Collection Profiles** — free users can create 5 location profiles for Prayer Times; premium users have unlimited ### Does the app work offline? **Yes.** All core features work completely offline once you've downloaded the content you want to read. No internet connection is required for: - Reading Quran or Hadith - Calculating prayer times - Searching (using the custom search engine) - Accessing Collections - Customizing text appearance - Viewing History ### Can I sync my Collections across devices? **Yes.** With the optional premium **Cloud Backup** feature, your Collections automatically sync across all your devices: - Changes sync in real-time when you're online - Changes queue when offline and sync when reconnected - Conflicts are automatically resolved - All data is encrypted end-to-end ### What languages are supported? **Quran:** 62 languages with 122 translations **Hadith:** Currently 5 languages (Arabic, English, Urdu, Hindi, Bangla), with more being added regularly **Prayer Times:** Calculation methods available for regions worldwide **Interface:** Available in English, with more language support planned ### Can I customize how text appears? **Completely.** The Text Customization system allows you to: - Adjust font size (8pt–32pt) - Control line height and letter spacing - Choose from built-in fonts or import custom TTF fonts - Select text and prefix colors with hex code or color picker - Customize separately per language - Preview changes in real-time All customization applies throughout the app wherever that content appears. ### How is my data stored? **Locally by default:** - All your readings, history, collections, and customizations are stored on your device - No data is sent to servers without your explicit permission - Everything works offline **Cloud (optional):** - If you enable Cloud Backup, your Collections are encrypted and backed up to our servers - Encryption keys are derived from your password; we cannot access your data - You can disable cloud backup anytime ### How often is new content added? Continuously. We're regularly adding: - New Hadith collections - New language translations - Improvements to existing features Check the [Changelog](/changelog) to see all updates. ### Is there a desktop version? Not currently. Al Islam is designed specifically for Android phones and tablets. ### How can I report bugs or suggest features? You can: - **In-app feedback** — use the feedback button in Settings - **Contact us** — reach out through our website or email - **Social media** — find us on X (@AlIslamIO) and Instagram ### Is there a community or support forum? You can reach out to us through: - **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 enhancing the app 2. **Transparency** — every change is documented 3. **Privacy** — your data is yours; we don't sell it or track you 4. **Quality** — before every release, everything is tested and validated 5. **Accessibility** — the app works for everyone, on any device **To Islamic Scholarship:** 1. **Accuracy** — all content is authentic and properly sourced 2. **Completeness** — we include diverse mainstream Islamic perspectives 3. **Clarity** — all sources are clearly labeled and categorized 4. **Respect** — we treat Islamic knowledge with the utmost respect --- ## Our Story Al Islam began with a simple observation: **Islamic scholarship is vast and scattered**. A person studying the Quran might need multiple apps for different translations, a different app for hadith, another for prayer times, and so on. We set out to build something different — a single, comprehensive platform that treats Islamic knowledge as an interconnected whole, with infrastructure powerful enough to handle the complexity but intuitive enough that anyone can use it. Al Islam started as an ambitious vision to unify Islamic scholarship into a single, comprehensive platform. What has emerged is a professional-grade application with enterprise-level infrastructure, custom-built systems, and continuously expanding resources: 170,523 hadith across 29 collections, 6,236 Quranic verses with 122 translations in 62 languages, 95 tafsir works, and growing daily. --- ## Philosophy in Practice ### Example 1: Prayer Times Instead of offering one prayer time calculation method, we built a **system** that supports: - 11 major calculation methods (Muslim World League, Egyptian, Karachi, Saudi, Dubai, MCW, ISNA, Kuwait, Qatar, Singapore, Turkey) - 2 Asr standards (Hanafi and Shafi'i) - 4 high-altitude rules for extreme latitudes - 5 location profiles (free) or unlimited (premium) - Multiple time zones - Hijri date offset adjustment - Automatic timezone detection - Offline operation Most users never adjust from the defaults because we pre-select the correct method for their region. But for those who need customization, complete flexibility exists. ### Example 2: Search Rather than a simple text matcher, we built a **custom search engine** that: - Supports advanced query syntax (exact phrases, required/optional terms, wildcards) - Automatically normalizes diacritics - Handles millions of records with millisecond latency - Works offline - Ranks results by relevance - Indexes across multiple content types - Supports concurrent searches And yet, basic search is as simple as typing a word. ### Example 3: Text Customization Instead of preset themes, we built a **unified customization system** that: - Allows per-language typography control - Supports custom font import - Provides granular font size, line height, and letter spacing control - Includes color customization with multiple input methods - Previews changes in real-time - Applies consistently throughout the app Perfect defaults mean most users never need to customize. But the flexibility is there. --- ## Get Started **Download Al Islam today:** - Available on Google Play Store [click here](https://play.google.com/store/apps/details?id=com.pakdeen.alislam) **Explore the app:** - Start with the [Quran](/docs/quran) or [Hadith](/docs/hadith) - Set up [Prayer Times](/docs/prayer-times) for your location - Create a [Collections](/docs/collections) to save your favorite verses - Discover your reading patterns in [History](/docs/history) --- ## Connect With Us - **Website:** [alislam.lymrah.com](https://alislam.lymrah.com) - **X (Twitter):** [@AlIslamIO](https://x.com/AlIslamIO) - **Instagram:** [@AlIslamIO](https://instagram.com/AlIslamIO) - **Email:** support.alislam@lymrah.com --- **Al Islam: Islamic Knowledge, Reimagined.** ## Privacy Policy (https://alislam.lymrah.com/privacy) _Effective Date: April 29, 2025_ _Version 4.0_ 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 clearly and honestly what data we collect, why we collect it, and how it is handled. We follow a principle of data minimization: if a feature works without your data, we do not take it. **If you use Al Islam without creating an account, no data leaves your device — period.** --- ## 1. Who This Policy Applies To This policy applies to all users of the Al Islam Android application. The app is available to users of all ages. We do not knowingly collect personal data from children under the age of 13. If you are a parent or guardian and believe your child has provided personal information, please contact us and we will promptly remove it. --- ## 2. Data We Collect — and When ### Guest Users (No Account) If you use Al Islam without signing in, the app is fully local. No account is created, no data is transmitted, and no information is stored on any server. Everything — prayer times, Quran, collections, preferences — stays entirely on your device. ### Registered Users (Account Created) When you choose to create an account, we collect the following: - **Email address** — used for authentication and account identification. - **Display name** — the name you enter during registration, shown within the app. - **Sign-in method** — whether you authenticated via a social login or email/password. - **Basic device information** — such as device model and brand, used to manage your active sessions (e.g., so you can see where your account is logged in). If you sign in using a social login option, we receive your email and name from that provider as part of the authentication process. We do not store your profile photo, and you cannot upload a profile picture through the app. ### Backup & Sync (Optional) Al Islam offers an optional cloud backup feature. If you enable it, your collections data is securely synced to our servers. This allows you to restore your data across devices or reinstalls. If you do not enable backup, none of your collections data ever leaves your device. ### Location (Prayer Times) - In phone only Location access is entirely optional and only used to calculate accurate Islamic prayer times based on your geographic coordinates. Your location is processed locally on your device. It is not stored, transmitted, or used for any other purpose. You can disable location access at any time from your device settings. ### Storage (Custom Fonts) If you upload a custom `.ttf` font file for Arabic or Urdu rendering, that file is read once and stored locally on your device only. We never upload, collect, or transmit font files. --- ## 3. How We Use Your Data We use the data described above strictly for the following purposes: - Authenticating your identity and securing your account. - Syncing and restoring your collections backup across devices (only if enabled). - Managing your active device sessions so you can see where your account is in use. - Personalizing in-app display using your chosen name. We do not use your data for advertising, profiling, marketing, or any purpose beyond operating the app features you have explicitly chosen to use. --- ## 4. Data Storage & Security Your account data and (if enabled) backup data are stored on our secure servers with strong access controls in place. Your data is only accessible to your own account — not by other users or unauthorized parties. Your premium subscription status is verified through your authentication token and requires no additional data queries, minimizing the data accessed on your behalf. --- ## 5. Subscriptions & Billing Al Islam offers an optional premium subscription. All billing, payment processing, and subscription management is handled entirely by Google Play. We do not collect, process, or store any payment information — including card numbers, billing addresses, or bank details. When a purchase is made, Google Play issues a purchase token which we verify server-side solely to confirm your subscription is valid. We do not store this token or use it for any other purpose. For questions about billing or refunds, please refer to Google Play's policies directly. --- #### 6. Third-Party Services Al Islam uses a limited number of third-party services to provide certain functionality within the app. These services include: - **Our secure cloud backend** — for authentication and optional cloud backup and synchronization. - **Google Play** — for subscription billing and purchase verification. See [Google's Privacy Policy](https://policies.google.com/privacy). - **Third-party sign-in providers** — if you choose to sign in using a supported social login provider, that provider's privacy policy applies to the information they share with us (typically your name and email address). - **Advertising providers** — the app may display third-party advertisements on supported plans. These providers may process limited device and advertising-related information to deliver, measure, and improve advertisements in accordance with their own privacy policies. We do not sell your personal data to advertisers. Ad personalization and data processing are governed by the respective advertising provider and your device or platform privacy settings. --- ## 7. Data Sharing & Disclosure We do not sell, rent, or share your personal data with any third parties for commercial purposes. Your data may only be disclosed in the following limited circumstances: - When required by law, court order, or governmental authority. - To protect the rights, safety, or property of Al Islam or its users. We will never share your data with advertisers, data brokers, or any party not directly necessary to operate the app. --- ## 8. Your Rights & Controls You have full control over your data: - **Delete your account** — request account deletion at any time by contacting us. All associated data will be permanently removed from our servers. - **Disable sync** — turn off cloud backup at any time. Your local data remains unaffected. - **Revoke location access** — turn off location permission in your device settings at any time. - **Clear local data** — uninstalling the app removes all locally stored data from your device. - **Sign out** — signing out ends your session on that device. --- ## 9. Data Retention We retain your account and backup data for as long as your account is active. If you delete your account, all associated data is permanently erased from our servers within 30 days. Local device data is removed when you uninstall the app. --- ## 10. Security We take reasonable technical measures to protect your data, including encrypted connections (HTTPS/TLS), strict access controls on all stored data, and session management with device tracking. However, no system is perfectly secure, and we encourage you to use a strong password and keep your device secure. --- ## 11. Changes to This Policy If we make significant changes to this privacy policy — particularly changes that affect what data we collect or how we use it — we will notify you within the app before the changes take effect. Continued use of Al Islam after notification constitutes acceptance of the updated policy. The effective date at the top of this document will always reflect the most recent revision. --- ## 12. Contact Us If you have any questions, concerns, or requests regarding this privacy policy or your data, please reach out: **Email:** support.alislam@lymrah.com **Developer:** Al Islam **App ID:** com.pakdeen.alislam --- _Al Islam — Designed for your spiritual life. Built with respect for your privacy._ ## Terms of Use (https://alislam.lymrah.com/terms) *Effective Date: April 29, 2025* *Version 4.0* 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. --- ## 1. Use of the App The App is intended for personal, non-commercial use to help users access Islamic content and utilities, including the Quran, Hadith, prayer times, and related features. 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. --- ## 2. Accounts & Authentication Certain features of the App — including cloud backup and premium subscriptions — require you to create an account. When creating an account, you agree to: - Provide accurate information, including a valid email address and your chosen display name. - Keep your login credentials secure and confidential. - Notify us immediately at contact support if you suspect unauthorized access to your account. You are responsible for all activity that occurs under your account. We reserve the right to suspend or terminate accounts that violate these Terms. --- ## 3. Subscriptions & Billing Al Islam offers an optional premium subscription that unlocks additional features. Please read the following carefully before purchasing. **Nature of Purchase** Premium access is currently a one-time purchase — not a recurring subscription. You are purchasing access to premium features for the duration specified at the time of purchase. Subscriptions do not auto-renew. **Billing** - All purchases are processed through Google Play in accordance with Google Play's billing policies. - Pricing and available plans are displayed within the App at the time of purchase. - We do not process or store any payment information. All billing is handled entirely by Google Play. **Refund Policy** - Premium purchases are non-refundable once access has been successfully activated. - If premium access was not granted to your account despite a completed payment, you will be eligible for a full refund within 3 days of purchase. - To request a refund or report an access issue, please contact us through the support section within the App. **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 download Al Islam from its official listing. --- ## 4. Cloud Backup & Sync The App offers an optional cloud backup feature that allows you to sync your collections data across devices. This feature is currently experimental. By enabling it, you acknowledge that: - Your collections data will be transmitted to and stored on our secure servers. - You are responsible for the content you choose to back up. - As an experimental feature, cloud backup may be modified, temporarily suspended, or discontinued at any time. You will be notified within the App in advance of any such change. - Disabling backup or deleting your account will result in your server-side data being permanently removed within 30 days. Cloud backup is entirely optional. If you do not enable it, no data leaves your device. --- ## 5. 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 data practices described in the Privacy Policy. --- ## 6. Third-Party Services The App uses a limited number of third-party services to deliver specific features: - **Open-source geocoding service (Nominatim)** — used to resolve location coordinates into readable place names for prayer time display. Coordinate data sent to this service is not linked to your account or identity. See [Nominatim's usage policy](https://operations.osmfoundation.org/policies/nominatim/) for details. - **Google Play** — for purchase processing and billing. See [Google's Privacy Policy](https://policies.google.com/privacy). - **Third-party sign-in provider** — if you choose to use a social login option, that provider's terms and privacy policy also apply. We are not responsible for the independent data practices of these services. --- ## 7. Islamic Content — Authenticity & 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 may contain minor linguistic variations based on the translator's methodology. Users are encouraged to refer to the original Arabic texts for scholarly study. - Interpretations of religious texts may vary. We encourage users to consult trusted scholars or religious authorities for guidance on religious matters. - Any unintended errors or inaccuracies are not deliberate. We welcome respectful corrections via our support contact. --- ## 8. User-Generated Content The App allows users to create personal collections, bookmarks, notes, and organize content. By using these features, you agree that: - You are solely responsible for any content you create within the App. - Content you create locally on your device is not accessible to us unless you explicitly enable cloud backup. - You will use these features respectfully and in accordance with the spirit of the App. --- ## 9. Activity History & Usage Logs The App may maintain local records of your activity, such as recent readings or search history. These logs: - Are stored only on your device and are never transmitted to our servers. - Are configurable and can be cleared at any time from within the App settings. --- ## 10. Offline Use & Content Availability The App is designed to support offline use for many of its core features. However: - Certain features — such as downloading language packs, account sync, and subscription verification — require an active internet connection. - Offline availability may vary depending on your device storage and configuration. - We do not guarantee uninterrupted access to any feature at all times. --- ## 11. Intellectual Property All original content, designs, UI components, and features developed for Al Islam are the intellectual property of the developer. Content included in the App is either original, public domain (e.g., 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 sharing of App content is permitted, provided proper attribution is maintained. --- ## 12. Respectful Use Al Islam is a spiritual and scholarly tool intended to benefit the Muslim Ummah. You agree to use the App with respect for its purpose and content, and to refrain from any misuse of Islamic texts, features, or the platform as a whole. --- ## 13. 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 will be free from inaccuracies or omissions. - The App will meet your specific requirements. --- ## 14. 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 but not limited to loss of data or service interruptions. --- ## 15. Account Termination You may delete your account at any time by contacting us at support.alislam@lymrah.com. Upon deletion: - Your account and associated server-side data will be permanently removed within 30 days. - Local data on your device will be removed when you uninstall the App. We reserve the right to suspend or terminate accounts that violate these Terms, without prior notice. --- ## 16. User 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 does not create any obligation on our part to implement requested changes. --- ## 17. Changes to These Terms We may update these Terms at any time. If significant changes are made, we will notify you within the App before the changes take effect. Continued use of the App after notification constitutes your acceptance of the updated Terms. The effective date at the top of this document will always reflect the most recent revision. --- ## 18. Contact Us If you have any questions or concerns 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 request deletion of your **Al Islam** account (`com.pakdeen.alislam`) and exactly what happens. ## How to request deletion 1. **In-app (recommended)** — open Al Islam → Profile → Account → **Delete account**, then confirm. Your account and synced data are scheduled for permanent deletion. 2. **By email** — if you can't access the app, email us from the address linked to your account and we'll process your request. ## What gets deleted - Your account and sign-in identity - Bookmarks, folders and notes - Reading and activity history - App preferences and synced settings ## What may be retained - Subscription/billing records required by Google Play and for legal or tax purposes - Anonymised, aggregated diagnostics that cannot identify you ## Good to know Deletion is permanent and cannot be undone. If you have an active Premium subscription, cancel it separately in the Google Play Store. Requests are completed within 30 days. Questions? Email **support.alislam@lymrah.com**. ## Hadith Library (29 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. ## 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))