Repository navigation
Releases
Quran Mushaf Reader 0.19.2
The first release since 0.16, and the biggest yet: a new text engine for sharper, more accurate pages, support for more tafsir books, offline listening, and a guided tour for first-time readers.
Reading
- New text engine. Pages are now drawn by the app's own engine, fixing several letter-shaping errors (such as hamza seats and joining marks) and drawing pages about twice as fast.
- Smoother page turns, with page edges drawn like the fore-edges of a real book.
- The arrow keys turn pages right away, including during the welcome tour.
- Opening and closing the tafsir glides smoothly, and the book stays fully visible beside it.
Tafsir
- Download complete tafsir books (Ibn Kathir, Al-Tabari, Al-Qurtubi, Al-Wasit). They work offline and can be removed anytime.
- "Add a tafsir…" in the source list and a "More tafsirs" link make new books easy to find.
- Quran text quoted inside a tafsir is shown in green.
Listening
- Download surahs for offline listening from the Download manager (Ctrl+D) or straight from the player.
- Choose what to hear from the ayah menu: one ayah, to the end of the page, the whole surah, or on to the end of the Quran.
- The page turns by itself to follow the recitation.
Search
- Jump straight to a juz, hizb or rub by typing it, in English or Arabic.
- Choosing an ayah takes you to it and highlights it.
Getting started and options
- A short guided tour on first launch, replayable from Options.
- Options regrouped into General, Reading, Your library and More.
- Every keyboard shortcut can be changed.
Reliability
- Faster startup.
- Settings are backed up automatically, and damaged settings are restored from the last good copy.
- Clear messages if something can't be drawn or played, with a way to try again.
- Support for very large screens (5K and ultra-wide).
Privacy
The app has no accounts, analytics or ads. It connects to the internet only to fetch recitations and tafsir books you choose. See PRIVACY.md.
Quran Mushaf Reader 0.16 — the new native app
The first release of the rebuilt Quran Mushaf Reader. The app is now native, written in Rust with Slint, and no longer uses WebView2. It starts faster, uses far less memory than the WebView2 version, and needs nothing else installed.
Highlights
- Sharp Digital Khatt pages drawn for your exact screen, with contextual letter elongation on by default
- Smooth GPU page turns you can drag by the corner or flip with the arrow keys
- Five themes: Light, Sepia, Dark gray, Pure black and Navy night
- Tafsir and translation beside the page, recitation with ayah highlighting, and quick search by surah, page, juz or hizb
- Full Arabic and English interface
Download
- QuranMushafReader-Setup-x64-0.16.0.exe: installs for your account, no administrator rights needed
- QuranMushafReader-Windows-x64-0.16.0.zip: extract and run, no install
The installer isn't code-signed yet, so Windows may show "Windows protected your PC". Select More info, then Run anyway.
The Quran files are byte-identical to the verified resource pack. Run Verify-Quran-Resources.ps1 in the app folder to check your copy. Checksums for both downloads are in SHA256SUMS.txt.
Quran Mushaf Reader v0.5.0 Preview
Quran Mushaf Reader v0.5.0
A major update to Quran Mushaf Reader, introducing a redesigned interface, a significantly lighter Windows application, improved Quran text rendering, and a more capable listening experience.
This release also brings important improvements to fullscreen reading, tafsir navigation, audio playback, and installation.
What's New
A lighter Windows application
- Replaced the previous .NET and WinUI-based desktop host with Rust, significantly simplifying the application's native architecture.
- Removed the need for separate .NET and Windows App Runtime installations, making the application easier to set up.
- Significantly reduced the installer size to 12.17 MB and the whole installed app to 61.0 MB over the ~200MB size for the earlier version, excluding optional Quran recitation downloads.
- Improved native window management, including resizing, maximization, fullscreen restoration, and high-DPI display handling.
- Strengthened application security through validated communication, restricted navigation, and tighter production settings.
- Simplified internal resource management, cleanup, and recovery handling.
The Quran reader continues to use Microsoft Edge WebView2 for its web-based interface. This release modernizes the native Windows host rather than replacing the entire rendering engine.
Refreshed interface and reading experience
- Redesigned the interface with clearly labeled Search, Listen, and Options controls in the Windows title bar.
- Improved Arabic and English layouts, automatically positioning reading controls according to the selected interface language.
- Improved fullscreen reading, making better use of available screen space and removing the previous scaling restriction.
- Added smooth interface transitions and improved tafsir panel animations, with support for reduced-motion preferences.
- Added customizable ayah highlighting: Automatic, Green, or Gold, with Automatic adapting to the selected theme.
- Improved Quran text rendering with refined Digital Khatt shaping, spacing, and justification for more consistent and readable lines.
- Added a localized startup screen with the application icon and loading indicator.
Enhanced Quran listening
- Reworked the recitation engine to buffer upcoming ayahs, reducing interruptions between recordings while preserving natural recitation pauses.
- Added customizable listening ranges, with optional repetition of selected ayahs or entire surahs.
- Expanded right-click listening options to include playback from an ayah through the end of a page, surah, or the Quran.
- Added more convenient playback controls, including seeking, ±10-second skipping, playback speed, volume, and a compact player that remains available while the listening panel is closed.
- Improved handling of network interruptions with automatic retries and clearer playback status.
- Added in-app downloads of complete surahs, with percentage progress, download sizes, and clearer storage information.
- Improved support for continuous surah recordings with synchronized ayah timings.
Quran Text Integrity
The Quran text, verse ordering, page divisions, and bundled tafsir content have been preserved throughout this update.
The application uses Quranic resources from the [Quranic Universal Library (QUL)](https://qul.tarteel.ai), developed by Tarteel AI. The bundled Digital Khatt library and font files have been verified against their original source files using SHA-256 hashes.
Improvements to text shaping, spacing, and justification affect only the visual presentation, without modifying the underlying Quran text. All 604 Mushaf pages have passed integrity checks.
Installation
Installation is now significantly simpler and lighter. The Windows desktop host has been migrated from .NET and WinUI to Rust, removing the need for separate .NET and Windows App Runtime installations.
The installer has been reduced to just 12.17 MB, while the complete installed application uses approximately 61 MB - a substantial reduction in download size and storage requirements compared with earlier development builds.
Additional Quran recitations remain available as optional downloads within the app.
To install the app, download the Windows Installer (.exe).
The Source Code ZIP is for developers who want to inspect or build the app.
Quran Mushaf Reader v0.2.0 Preview
Simplified the installation, added tafseer and recitation support, added custom daily reading goal, as well as bug fixes and improvements.
Quran Mushaf Reader v0.1.0 Preview
First release using digital Khatt