Pre-built and reproducible Quran EPUBs with correct Arabic rendering, in 42 languages.

Download from the EPUB table below or see the latest release.

Best used in KOReader. See KOReader Settings for essential setup.

Extra features with the Quran Helper KOReader plugin: per-instance word dictionary with automatic entry matching, grammar dictionaries with WBW + syntax + i'rab, tafsir lookup (20 tafsirs, 6 languages), surah overviews, juz' and surah name in status bar, and more.

This tool uses validated script/font pairing to avoid the rendering bugs (broken sukun marks, mangled ligatures) common in other Quran EPUBs. Feedback and bug reports welcome — open a Feature Request for desired content or formats.

Each translation is available in up to three formats:

• Bilingual — Arabic and translation shown together, ayah by ayah. Best for studying or reading with a translation side by side.
• Interactive — Arabic text only, tap any ayah (number marker) to see the translation in a footnote popup. Best for reading the Arabic with occasional reference to the translation.
• Word-by-Word — Each Arabic word shown with its meaning directly below, forming visual word stacks. A full sentence translation follows each ayah. 8 languages have native word-level glosses; all translations also have an English-gloss WBW variant (plus Indonesian gloss for Malay). Best for vocabulary study and understanding how Arabic maps to the translation word by word.

There is also an Arabic-only EPUB with no translation — continuous flowing text. It is identical to the interactive version in visual layout.

All released EPUBs use Riwayat Hafs 'an 'Asim, anchored to the Madinah Mushaf (1405 AH / 604 pages). An experimental build for Riwayat Warsh 'an Nafi' is also available — see Other Versions (Work in Progress) for details and known limitations.

These EPUBs use embedded Arabic fonts and EPUB3 features (like footnotes and interactive lookup) that most proprietary e-reader software does not handle well. In those cases, KOReader is highly recommended — open-source, excellent Arabic rendering, runs on Android, Kobo, Kindle, PocketBook, and Linux.

See KOReader Settings for essential setup — footnote popups, RTL page turns, mushaf page numbers, and more.

• Kobo: Native reader struggles with Arabic. Install KOReader — no jailbreak needed.
• Kindle: Stock Kindle does not render Arabic EPUBs correctly. Requires jailbreaking + KOReader.
• Other e-readers: Proprietary readers will likely have rendering errors.
• Apple Books: Mostly works well on iOS and macOS, no changes needed. Some features may not fully work.
• Android e-readers: Most popular e-reader software like Moon+ Reader, Readera, Librera, etc., have various formatting errors and issues with rendering. Use KOReader where possible.
• Windows/Mac/Linux: You can also use the Calibre ebook viewer, which mostly works fine.

NB: Translation text uses your e-reader's built-in serif font. For non-Latin scripts (Urdu, Bengali, Hindi, etc.), make sure your device has fonts for that script installed. KOReader ships with Noto fonts covering most scripts. The Quranic fonts are embedded in the EPUB itself.

Overwrite the old file with the new one, keeping the same filename. KOReader (and most e-readers) store your reading position, highlights, and settings separately — they will be preserved. Do not delete the book from within KOReader before replacing, as this will delete your data. After updating, you can force refresh metadata (cover, etc) by long-pressing the book in KOReader and selecting Refresh cached metadata.

Essential Settings for a good reading experience. Footnote popups, RTL page turns, page numbers, and more

Word-by-Word download links: epub = native-language word gloss, epub^{en wbw} = English word gloss, epub^{id wbw} = Indonesian word gloss. Cross-language WBW pairs English (or Indonesian) word-level meanings with a full sentence translation in the target language — useful for readers who understand basic English vocabulary but prefer reading a translation in their own language.

Many translations include translator footnotes where the source data provides them (Sahih International, Hamidullah, Garcia, Hamza Roberto Piccardo, Nasr, and others). Editions marked "with commentary" or "annotated" have especially extensive notes — Tafhim ul-Quran includes Sayyid Abul Ala Maududi's full tafseer-style commentary, and the annotated Clear Quran has 1,270 scholarly footnotes. See KOReader Settings for footnote popup setup.

Note on Maududi footnotes: A small number (~9%) of Tafhim ul-Quran footnotes are truncated in the upstream source data (ending mid-sentence). This is a known issue in the digitized text that all online sources share — not specific to this project.

The Quran Helper plugin enhances the reading experience with automatic word dictionary matching, grammar and tafsir lookup, surah overviews, and juz' status bar info.

Download quran_koplugin_v1.8.zip (18 KB), unzip quran.koplugin/ into KOReader's plugins/ folder:

For the plugin to be installed correctly, the file structure should look like this (no nested folder, and foldername must be quran.koplugin exactly; remove "-main" or similar if you downloaded the zip from head):

koreader
└── plugins
    └── quran.koplugin
        ├── _meta.lua
        ├── main.lua
        └── ...

Restart KOReader. Go to Top Menu → Tool icon → Quran Helper to configure.

Shows the current juz in KOReader's footer status bar while reading.

• Six juz display formats: جزء ٣ (default), Juz 3, Arabic name (تلك الرسل), Arabic name with جزء (جزء تلك الرسل), Latin name (Tilkar-Rusul), Latin name with Juz' (Juz' Tilkar-Rusul)
• Optional surah name appended (off by default), e.g. جزء ٣ — البقرة or Juz 3 — Al-Baqarah, with five format options including سورة/Surat prefix variants
• Boundary indicator (*) when a new juz begins on the current page (e.g., جزء ٣*)

Enable juz' title in status bar — the juz display is on by default in the plugin, but KOReader needs "External content" enabled in the status bar to show it:

1. You must have a book open (be in Reader view)
2. Top Menu → Gear icon → Status bar → Status bar items → check External content. After this you can change the plugin settings on-the-fly.

You can also sort the status bar items in this menu.

Plugin settings — configure juz format, surah name display, and other options:

1. You should have a book open (be in Reader view) and status bar visible to see the results immediately for testing
2. Top Menu → Tool icon → Quran Helper
3. Adjust settings as needed

Per-instance English word-by-word StarDict dictionary for KOReader. Long-press any Quranic word while reading to see:

• Translation — English word meaning for that specific occurrence
• Transliteration — Latin script pronunciation
• Morphology — part of speech (Arabic + English), grammatical case/mood, gender/number/person, verb form and pattern (wazn) — specific to this occurrence
• Lemma and root — dictionary form and Arabic root letters
• Root definition — Lane's Lexicon summary for the root
• Occurrence counts — how many times this lemma and this exact form appear in the Quran

~33,000 unique entries covering every word instance in the Quran (77,426 instances, combined where the content is identical). Headwords use QPC Uthmani Hafs encoding — the same script as the EPUBs above. Other Quran text encodings will not match.

With the plugin installed: the plugin detects which ayah you are reading and automatically filters the dictionary results to show only the entry matching that position — one result with the correct translation and morphology for that exact word occurrence.

Without the plugin: KOReader shows all entries for the word form. Each unique translation/morphology combination is a separate entry that you scroll through (e.g. 1/5). Functional but less convenient for common words.

Install: Download quran_qpc_en_stardict_v1.3.zip (2.1 MB), unzip into KOReader's data/dict/ folder (creates a quran_qpc_en/ subfolder). Subfolder names and nesting does not matter as long as the files are in the dict folder. Restart KOReader.

koreader
└── data
    └── dict
        └── quran_qpc_en
            ├── quran_qpc_en.dict
            ├── quran_qpc_en.idx
            └── quran_qpc_en.ifo

You can sort your dictionaries in Top menu → Magnifying glass icon → Settings → Dictionary settings. Here you can also set book-specific preferences for the open book.

Build your own: python tools/build_dictionary.py --instance (requires cached data from Quran.com API, EQTB morphology, and Lane's Lexicon — see script for details).

Known upstream data issues:

• Transliteration from Quran.com API omits hamza (شَآءَ → shāa instead of shā'a) and sometimes drops shaddah doubling (ٱلۡحَقُّ → l-ḥaqu instead of l-ḥaqqu)
• Root definitions from Lane's Lexicon are per-root, not per-lemma — a verb and its derived noun share the same root gloss (e.g. شَآءَ "to will" shows the root شيأ gloss for "thing")
• Lemma data from EQTB (Extended Quranic Treebank) has known errors: some verb lemmas show the conjugated surface form instead of the dictionary headword, and some plural noun lemmas are incorrect. This is being investigated — an alternative lemma source will replace the EQTB lemmas in a future update. If you notice an incorrect lemma, please report it.
• QPC repurposes three Unicode codepoints for tanween variants (U+0657 for open fathatan, U+065E for open dammatan, U+0656 for kasratan) with custom glyphs in the QPC font. KOReader's dictionary popup uses a standard Arabic font, which renders these as their literal Unicode glyphs (inverted damma, fatha-with-dots, subscript alef). The dictionary builder normalizes headwords to standard tanween (U+064B, U+064C, U+064D) for correct rendering, and includes the original QPC forms as synonym keys for backward compatibility. With the KOReader plugin installed, lookups are normalized automatically for exact matching. Without the plugin, the QPC synonym keys provide exact matching with the original (cosmetically incorrect) rendering

Long-press any ayah number marker while reading to see per-ayah grammatical analysis. Requires the plugin.

• Word-by-word translation — English gloss for each word in the ayah (from Quran.com word-by-word data)
• Morphology — 35 POS types, case/mood, gender/number/person, verb form and wazn, passive voice, indefinite state (from EQTB)
• Syntax roles — subject, predicate, complement, conjunction, etc. with target word shown (e.g. "predicate (خبر) of ٱللَّهُ") — from the EQTB dependency treebank (full Quran coverage)
• I'rab — traditional Arabic grammatical analysis prose (إعراب), ~93% coverage (from QAC)

6,236 entries covering every ayah in the Quran. The plugin detects the current surah from the table of contents and handles the lookup automatically — just long-press the ayah number. The grammar dictionaries use special keys (e.g. "Al-Baqarah 255") that are not searchable without the plugin — the plugin is required.

Install: Pick one or more grammar dictionary variants and unzip into KOReader's data/dict/ folder (same location as the word dictionary):

koreader
└── data
    └── dict
        └── quran_grammar_combined
            ├── quran_grammar_combined.dict
            ├── quran_grammar_combined.idx
            └── quran_grammar_combined.ifo

Build your own: python tools/build_grammar_dictionary.py --variant all (requires cached data — see script for details).

Known upstream data issues:

• Word-by-word translations from Quran.com API use phrase-level rather than word-level glosses in ~50 chapters (mostly chapters 4+). E.g. three words may all show "O you who believe" instead of individual glosses. Chapters 1–3 have clean word-level data. This is the upstream API data, not a processing error.
• I'rab data covers ~93% of ayahs (5,790 of 6,236). The remaining ~446 ayahs have no i'rab analysis in the QAC source data.
• Lemma data from EQTB has known errors for some verb and noun forms (same issue as the word dictionary — shared data source). Being investigated. If you notice an incorrect lemma, please report it.

Long-press a surah name header (the decorative calligraphic name at the start of each surah) to see an introduction and overview of that surah. Navigate between surahs with the prev/next buttons or volume keys. Requires the plugin.

Install: Pick one or more languages and unzip into KOReader's data/dict/ folder. You can install multiple languages — all will show in the popup.

koreader
└── data
    └── dict
        └── quran_surah_overview_en
            ├── quran_surah_overview_en.dict
            ├── quran_surah_overview_en.idx
            └── quran_surah_overview_en.ifo

Source: Quran.com API v4 surah info endpoint.

Build your own: python tools/build_surah_overview.py --all (or --language en for a single language).

Long-press any ayah number marker to see tafsir commentary for that ayah (in addition to grammar data, if installed). Each tafsir is a separate dictionary — install whichever ones you want. Navigate between ayahs with prev/next buttons or volume keys. Requires the plugin.

Some tafsirs group multiple ayahs under one commentary entry (e.g. Ibn Kathir). The popup title shows the ayah range, and all ayahs in the group are reachable. Like the grammar dictionaries, the tafsir dictionaries use special keys that require the plugin.

Install: Pick one or more tafsirs and unzip into KOReader's data/dict/ folder (same location as the word dictionary). You can install multiple tafsirs — all will show in the popup.

koreader
└── data
    └── dict
        └── quran_tafsir_muyassar
            ├── quran_tafsir_muyassar.dict
            ├── quran_tafsir_muyassar.idx
            └── quran_tafsir_muyassar.ifo

Source: Quran.com API v4 tafsir endpoints. 20 tafsirs across 6 languages.

Build your own: python tools/build_tafseer_dictionary.py --all (or --tafsir muyassar for a single tafsir). Use --list to see all available tafsirs.

pip install -e ".[dev]"
quran-ebook build configs/bilingual/en_sahih.yaml

Each YAML file in configs/ defines one EPUB variant. Configs are organized by type: arabic/, bilingual/, interactive/. Build everything with quran-ebook build --all configs/.

PRs or FRs are welcome.

• Arabic text: Quran.com API v4 — QPC Uthmani Hafs encoding (Riwayat Hafs 'an 'Asim), Madinah Mushaf V1 (1405 AH) page mapping
• Translations: Quran.com API v4 + fawazahmed0/quran-api — 42 languages, 46 translators (see configs/ for full list)
• Surah names: Quran.com API v4 for most languages; QuranEnc for languages not on the API (e.g. Fulfulde)
• Surah overviews: Quran.com API v4 — /chapters/{id}/info endpoint, available in English, Urdu, Indonesian, Malayalam, Tamil, Italian
• Tafsir: Quran.com API v4 — /tafsirs/{id}/by_chapter/{ch} endpoint, 20 tafsirs across 6 languages (Arabic, English, Urdu, Bengali, Russian, Kurdish)
• Morphology & syntax (grammar + word dictionaries): EQTB (Extended Quranic Treebank) — POS, case, mood, gender, number, person, verb form, dependency relations with head pointers (CC BY 4.0)
• I'rab: Quranic Arabic Corpus — traditional Arabic grammatical analysis prose (GPL)
• Root definitions: Lane's Lexicon — root meanings (public domain)
• Primary font (Hafs): KFGQPC Uthmanic Script Hafs — King Fahd Complex, via Tarteel CDN
• Primary font (Warsh): KFGQPC Warsh Uthmanic Script v0.10 — King Fahd Complex, via thetruetruth/quran-data-kfgqpc
• Symbol font: Scheherazade New (SIL International) — rub al-hizb markers, surah header numerals, TOC labels, and in-book cover text
• Basmala font: Quran Common (QUL / King Fahd Complex) — ornamental bismillah ligature (U+FDFD)
• Header font: Surah Name V4 (QUL / King Fahd Complex) — calligraphic surah name glyphs

An experimental Arabic-only EPUB for Riwayat Warsh 'an Nafi' is included in the release. See the Arabic EPUB table for the download link.

Data source: KFGQPC (King Fahd Glorious Quran Printing Complex) via thetruetruth/quran-data-kfgqpc. This is the only freely available digital Warsh package with matched text and font. The same data is used by most open-source multi-qiraat projects.

Font: KFGQPC Warsh Uthmanic Script v0.10 (2018, Ashfaq Ahmad Niazi). The text encoding is inseparable from its font — Warsh text rendered with a Hafs font produces broken diacritics, and vice versa. The font uses Maghribi orthographic conventions: dot under fa (ف), compact comma-style damma, hamzat al-wasl markers (U+06EC), and the distinctive North African kaf.

What this edition is: The Quranic text follows Warsh 'an Nafi' with Madani ayah numbering (6,214 ayahs across 114 surahs, vs 6,236 in Hafs). The basmala is unnumbered and absent from Al-Fatiha's ayah count. 50 surahs have different ayah counts compared to Hafs. All 30 juz boundaries are present and correct for the Warsh tradition (12 of 30 differ from Hafs). Orthographic conventions such as sun-letter assimilation marking (shadda placement) follow the Medina Warsh printing tradition.

Page numbers: The KFGQPC data uses a 604-page digital layout that mirrors the Hafs Madinah Mushaf grid structure. These are not physical Warsh mushaf page numbers — the printed Warsh Madinah Mushaf has ~576 pages. All 114 surah start pages are identical between the KFGQPC Warsh and Hafs datasets. Page references in the EPUB footer are KFGQPC virtual pages, not references to any specific printed Warsh mushaf.

What works:

Known limitations:

• No calligraphic surah headers or ornamental basmala. The Hafs decorative fonts (surah-name-v4, quran-common) use Mashriqi orthographic marks (different sukun, hamza shapes) that do not match Warsh/Maghribi conventions. No Warsh-specific decorative fonts exist in the digital Quran font ecosystem. The EPUB falls back to plain Arabic text in the Warsh font for both.
• Single waqf marker type. The KFGQPC Warsh data uses only U+06D6 (صلى) for pause marking, consistent with the simplified waqf system used in many Medina Warsh mushafs. The multi-symbol waqf system (قلى, مـ, لا, ج, three dots) common in Hafs mushafs is not present in this data source.
• KOReader plugin: The Quran navigation plugin hardcodes Hafs ayah counts and juz boundaries. Surah-level navigation works (reads the EPUB TOC), but ayah-level prev/next navigation will be incorrect. The juz status bar reads the EPUB TOC and should display correctly.
• Dictionaries: The WBW, grammar, and tafsir dictionaries are keyed to Hafs ayah numbers (6,236 ayahs). Since Warsh has different ayah boundaries in 50 surahs, dictionary lookups will be misaligned for those surahs for now. The surah overview dictionary is also differently keyed.
• Bilingual / interactive / WBW layouts are not yet available for Warsh (Arabic-only for now).

Experimental support for tajweed color-coded Quran text using the Quran Foundation's per-page glyph fonts (QCF V4). Each word is rendered as a single pre-composed glyph with tajweed colors baked into the font via OpenType COLR/CPAL tables. This avoids the Arabic shaping breakage that CSS color spans cause in CREngine.

The EPUB build pipeline is functional — Arabic-only, bilingual, and interactive layouts all build and pass epubcheck. Spacing and sizing tuning is in progress.

Requires patched KOReader: QCF V4 tajweed colors need COLR v0 color font support in CREngine. A patch has been submitted as koreader/crengine#654. Until merged, tajweed colors only render in a locally patched KOReader build. A plain (non-color) QCF V1 variant works on stock KOReader.

Built on the work of many contributors to the Quranic digital ecosystem:

• rockneverdies55/quran-epub — demonstrated the demand for open-source Quran ebooks
• bilalsaci/compare-quran-scripts-and-fonts — identified correct script/font pairings and diagnosed rendering bugs
• mohd-akram/mushaf — clean EPUB3 structure reference
• mostafa-khaled775/quran-epub-builder — multi-qiraat approach reference

Fonts: KFGQPC Uthmanic Script (Hafs + Warsh), Quran Common, and Surah Name V4 (King Fahd Complex via QUL), Scheherazade New (SIL International, OFL 1.1).

GPL-3.0

Quran text and translation data sourced from Quran.com API. Font licenses: Scheherazade New (SIL OFL 1.1), KFGQPC Uthmanic Script / Quran Common / Surah Name V4 (King Fahd Complex — use, copy, and distribute permitted; modification not permitted).