Quran Reader
An offline-first Quran reader for desktop, built with Tauri 2,
SvelteKit and Rust. No account, no telemetry, and no network request while you
read — the Quran data ships inside the binary. Recitation and tafsir are
fetched only when you ask for them, and kept for offline use after that.
Status: early. Reading, navigation, the Mushaf page view and tafsir
(Arabic + English) work and are used daily. Audio has just landed and has not
had a week of use yet. Search and translations are not built. See
PLAN.md for what exists and what doesn't.
Features
Two ways to read
- Mushaf page view — renders all 604 pages of the Madani Mushaf with the
same line breaks and word placement as the printed original, using the
official KFGQPC (Uthman Taha) glyph fonts
- Scrolling reader — continuous Surah reading, per-ayah bookmark, copy
and tafsir actions, page/juz boundary markers
Tafsir
- Tafsīr Ibn Kathīr — the Arabic original and the abridged
English (Darussalam)
- Tafsīr al-Jalālayn — the Arabic original and English
(tr. Feras Hamza)
- A side panel that follows the verse you are reading, in both views (
t),
with a picker to switch between editions
- Each edition is a content pack you download once from the editions list,
then read offline from then on. None is bundled with the app
- Each edition is labelled with its school of fiqh and its creed: both are
Shāfiʿī, al-Jalālayn is Ashʿarī and Ibn Kathīr Atharī. A commentary's school
decides how it reads the legal verses and its creed decides how it reads the
attribute verses; neither is visible in the text, so the reader is told
rather than left to guess
Recitation
- Hear a verse from its verse card — a bar under the commentary, in the
card and the side panel, with a seek track for the long verses. It plays
that verse and stops. Reading is what this app is for; recitation is there for
the moment a word does not sit right in your mouth, so it is not a player the
page is built around
- Listen to a whole Surah from the Listen chip in the Surah banner. It opens
a small panel with the verse playing, repeat, and an offline download for the
whole Surah — and closing it puts everything away
- Repeat a verse a set number of times, with an optional pause between for
saying it back
- Five reciters, all Ḥafṣ ʿan ʿĀṣim, each labelled with its riwāya
- Nothing ships in the installer and nothing is fetched until you ask.
A verse is downloaded once, cached, and plays offline for good. Settings →
Audio shows what it costs on disk and clears it, per reciter or entirely
Navigation
- Browse by Surah, Juz, Hizb or page
- Go-to overlay (
Ctrl/Cmd+G): 255, 2:255, or p255
- Keyboard-driven sidebar search (
/): type, arrow through the results, Enter
- Deep links:
/surah/2?ayah=255, /juz/30, /hizb/59, /page/604
- Reopens where you left off — each Surah, Juz, Hizb and page keeps its own
place, and launching goes back to whichever you were last reading
- A Recent tab listing your reading sittings, each with the verses it covered
Reading
- Focus mode — hides everything but the text
- Auto-scroll with a drag-to-adjust speed handle
- Independent app zoom and reader zoom, both persisted
- Reading-progress bar showing position in the Surah, with Juz/Hizb on hover
- Dark, light and sepia themes
Offline and small
- The Quran database is compiled into the binary — first launch works with
no network, no import step, no download
- Mushaf page fonts load lazily behind an LRU, so opening Al-Baqara doesn't
pull 48 font files up front
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
