Quran EPUBs + offline dictionaries + KOReader plugin (42 languages, grammar/tafsir lo

[zeeyado]

Hi everyone,

Sharing a Quran EPUB project built around KOReader's features: HarfBuzz shaping, StarDict dictionaries, EPUB3 footnotes, and the plugin system.

https://github.com/zeeyado/quran-ebook

**The problem:** Most Quran EPUBs have broken Arabic (mangled ligatures, missing diacritics) because the text encoding and font don't match. These use validated pairing (QPC Uthmani Hafs + KFGQPC from the King Fahd Complex), embedded in the EPUB.

**EPUBs:**
- 42 languages, 46 translators
- Three formats: Arabic-only, bilingual (side-by-side), interactive (tap ayah number for translation popup via EPUB3 footnotes)
- Madinah Mushaf pagination (works with KOReader's stable page numbers)

**Offline StarDict dictionaries (data/dict/):**
- Word-by-word: 22,000+ entries — translation, morphology, root, lemma, Lane's Lexicon
- Grammar/i'rab: word-by-word breakdown + dependency syntax (QAC treebank) + Arabic grammatical analysis per ayah
- Surah overviews in 6 languages
- 20 tafsirs in 6 languages — tap ayah number, get commentary in a popup

**KOReader plugin (Quran Helper v1.4, plugins/):**
- Juz info in status bar (multiple format options, optional surah name)
- Handles lookup key generation for grammar + tafsir dictionaries
- Detects current surah from TOC automatically

Everything is open source and pre-built on the release page.

Feedback on rendering across different devices and KOReader versions is especially welcome. I've primarily tested on macOS/SD, Boox (Android), and Kobo, so reports from Kindle, PocketBook, and other Android users would be especially helpful.

[gaueko]

Hello, I am muslim and I was surprised to see this project I didnt knew about until now. It will be specially helpful to me because I dont have a quranic mushaf as I dont understand arabic very well. So I always read online, but the average screen of smartphones are as we know a pain to the eyes. I am going to read it my Kindle. Thank you for your efforts and may Allah bless you.