Skip to main content
Get up and running with Open Mushaf Native in just a few minutes. This guide will walk you through downloading, installing, and using the app for the first time.

​
Download the app

Open Mushaf Native is available on multiple platforms. Choose the one that works best for you:

Android

Download from Google Play Store

Web App

Use directly in your browser

APK

Download APK from GitHub

​
First launch

When you first open Open Mushaf Native, you’ll be guided through a quick setup:
1

Select your Riwaya

Choose between Hafs ‘an ‘Asim or Warsh ‘an Nafi’ recitation styles.
You can change this later in the Settings menu.
2

Complete the tutorial

A brief interactive tutorial will introduce you to the main features:
  • Swipe navigation between pages
  • Tap to access the top menu
  • Long press on text to view Tafseer
3

Start reading

The app will open to the last page you were reading, or page 1 if it’s your first time.

​
Basic navigation

​
Page navigation

Swipe left or right to move between Mushaf pages. The app uses gesture recognition for smooth navigation.

​
Access Tafseer

To read Tafseer (commentary) for any verse:
  1. Long press on any verse in the Mushaf page
  2. A bottom sheet will appear with available Tafseer sources
  3. Swipe between different commentaries using the tabs
  4. Drag the bottom sheet handle to resize it
Open Mushaf Native includes 11 classical Tafseer sources, including Ibn Katheer, Al-Tabari, and Al-Qurtubi.

​
Essential features

​
Search the Quran

1

Open search

Tap the search icon in the bottom navigation bar
2

Choose search mode

Select from four search modes:
  • Simple: Basic text search
  • Fuzzy: Finds similar matches
  • Root: Search by Arabic root
  • Lemma: Search by word lemma
3

View results

Results are highlighted with different colors based on match type. Tap any result to jump to that page.

​
Daily reading tracker

Track your daily Quran reading progress:
  1. Open the Tracker tab from the bottom menu
  2. Set your daily goal (in Ahzab units)
  3. Your progress is automatically tracked as you read
  4. Goals reset at midnight each day

​
Dark mode

Open Mushaf Native automatically adapts to your system theme. You can also:
  • Adjust the Mushaf page contrast in Settings
  • Customize the reading experience with various options

​
Offline usage

Open Mushaf Native works completely offline once the initial pages are cached.
The app automatically preloads nearby pages as you read:
  • Current page
  • Previous page
  • Next 2 pages
This ensures smooth navigation even without an internet connection. Tafseer content and search data are also available offline.

​
Customization

Access Settings from the More menu to customize:
  • Riwaya selection: Switch between Hafs and Warsh
  • Page flip sound: Enable/disable audio feedback
  • Dark mode contrast: Adjust page brightness (0-100%)
  • Notifications: Configure daily tracker and Hizb notifications

​
Next steps

Explore features

Learn about offline reading, Tafseer, and search

Customization guide

Personalize your reading experience

Navigation guide

Master all navigation methods

Full installation

Build from source or deploy your own instance

Build docs developers (and LLMs) love

Get started for freeTalk to us