Qur'an & Sunnah Companion

Tracking since Apr 1, 2026.

Changelog

• May 6, 2026
  description

  Listen to Qur'an, read authentic Hadith, and receive dhikr reminders - your complete Islamic companion in one click.
  
  Transform your browsing into a spiritual journey with the Qur'an & Sunnah Companion - your pocket-sized īmān boost in every tab.
  
  🕌 What it does:
  This lightweight Chrome extension brings Islamic spirituality directly to your browser with three powerful features in one convenient popup:
  
  📖 Qur'an Recitation
  Listen to beautiful Qur'an recitations from renowned reciters including Abdul Basit, Minshawi, Al-Hussary, and more
  Choose from all 114 surahs with high-quality audio
  Continue listening even when the popup is closed
  Perfect for background recitation while working or studying
  
  📚 Sahih Hadith
  Discover authentic Hadith from Sahih Bukhari and other trusted collections
  Fresh Hadith rotated regularly to expand your Islamic knowledge
  Both Arabic text and English translations provided
  Learn Prophetic wisdom throughout your day
  
  🤲 Dhikr Reminders
  Customizable notification reminders for dhikr (remembrance of Allah)
  Choose your preferred intervals (15 minutes to 4 hours)
  Beautiful collection of authentic duas and dhikr
  Gentle notifications that don't disrupt your workflow
  
  ✨ Why users love it:
  Privacy-focused: No data collection, completely offline-capable
  Lightweight: Minimal resource usage, won't slow down your browser
  Bilingual: Full English and Arabic interface support
  Seamless: Works without leaving your current tab
  Authentic: All content sourced from verified Islamic sources
  Perfect for:
  Muslims seeking to incorporate more spirituality into their daily routine
  Students and professionals who want Islamic reminders during work
  Anyone learning Arabic or studying Islamic texts
  Those who appreciate beautiful Qur'an recitation
  
  🎯 One-click access to:
  Instant Qur'an playback
  Daily Hadith wisdom
  Mindful dhikr reminders
  Spiritual connection throughout your browsing
  Install now and turn every browsing session into an opportunity for spiritual growth. No registration required, completely free, and respects your privacy.

  # Qur'an & Sunnah Companion
  
  A browser extension that brings Qur'an recitation, authentic Hadith, and Dhikr reminders to your browser. Available for Chrome (Manifest V3) and Firefox (Manifest V2).
  
  [Chrome Web Store](https://chromewebstore.google.com/detail/quran-sunnah-companion/okkohadnmodfaienacdlfaledjblcbka?hl=en-US&utm_source=ext_sidebar) | [GitHub](https://github.com/Abdalla-Eldoumani/islam-extension)
  
  ## Features
  
  ### Qur'an Recitation
  - 50+ reciters from Quran.com, MP3Quran.net, and Islamic.network with automatic deduplication
  - Inline search to filter reciters by name, bitrate, and style
  - All 114 Surahs with progress bar, seek controls, and autoplay
  - Background playback continues when the popup is closed
  
  ### Authentic Hadith
  - 9-book Arabic collection with English and French translations
  - Local cache for instant display
  - New hadith each time you open the popup
  
  ### Dhikr Reminders
  - 32 authentic adhkar with Arabic, English, and transliteration
  - Reward explanations in English, Arabic, and French
  - Configurable interval (30 seconds to 1 hour) with preset buttons
  - Two reminder styles: system notification or in-extension popup
  - Notifications auto-dismiss after 60 seconds so a forgotten reminder cannot pile up
  
  ### Privacy
  No personal data is collected. No accounts, tracking, or ads. The extension uses storage for preferences, alarms for Dhikr scheduling, and network access for Qur'an audio and Hadith APIs. The Dhikr collection works offline.
  
  ## Installation
  
  ### Chrome Web Store
  Install directly from the [Chrome Web Store](https://chromewebstore.google.com/detail/quran-sunnah-companion/okkohadnmodfaienacdlfaledjblcbka?hl=en-US&utm_source=ext_sidebar).
  
  ### Manual Installation (Chrome)
  1. Download and extract the [repository ZIP](https://github.com/Abdalla-Eldoumani/islam-extension/archive/refs/heads/main.zip)
  2. Open `chrome://extensions` and enable **Developer mode** (top-right toggle)
  3. Click **Load unpacked** and select the `chrome/` folder from the extracted files
  4. Pin the extension from the puzzle piece icon in the toolbar
  
  ### Firefox (Permanent)
  1. Download the [repository ZIP](https://github.com/Abdalla-Eldoumani/islam-extension/archive/refs/heads/main.zip) and extract it
  2. Go to `about:addons` > gear icon > **Install Add-on From File** and select `firefox/manifest.json`
  
  ### Firefox (Temporary / Development)
  1. Go to `about:debugging` > **This Firefox** > **Load Temporary Add-on**
  2. Select `firefox/manifest.json` from the cloned repository
  
  ## Usage
  
  - **Qur'an**: Pick a Surah and reciter, press Play. Turn on autoplay to advance through Surahs automatically.
  - **Hadith**: Opens with a new hadith each time.
  - **Dhikr**: Toggle reminders on, choose an interval, and allow browser notifications when prompted.
  
  ## Technical Details
  
  Built with vanilla JavaScript and CSS (no frameworks). Uses Chrome Extension APIs: Storage, Alarms, Notifications, Offscreen.
  
  ### APIs
  - **Quran.com** -- Surah metadata and primary audio
  - **MP3Quran.net** -- Additional reciters
  - **Islamic.network** -- CDN audio sources
  - **Hadith APIs** -- Arabic collections and English/French translations
  
  ### Browser Support
  - Chrome / Chromium 109+ (Manifest V3)
  - Firefox 109+ (Manifest V2, included in `firefox/`)
  - Microsoft Edge and other Chromium browsers
  
  ### Trilingual Interface
  One-tap language switcher (English / Francais / Arabic) with full RTL support. All UI labels, Surah names, Dhikr rewards, and Hadiths update instantly.
  
  ## Contributing
  
  Contributions are welcome. See [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md) for setup, conventions, and how to add a reciter or a language.
  
  ```bash
  git clone https://github.com/Abdalla-Eldoumani/islam-extension.git
  cd islam-extension
  npm install
  npm run sync
  ```
  
  The Chrome and Firefox builds share their non-platform code via a `shared/` directory. Edit files there, then run `npm run sync` to copy them into both `chrome/shared/` and `firefox/shared/` before reloading the extension.
  
  ## Documentation
  
  - [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) — message passing, storage schema, the Chrome MV3 + offscreen pattern, the Firefox MV2 background page pattern.
  - [docs/INSTALLATION.md](docs/INSTALLATION.md) — install steps for Chrome, Firefox, Edge, Brave.
  - [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md) — development workflow, atomic commits, religious-content rules, adding reciters and locales.
  - [docs/I18N.md](docs/I18N.md) — translation tables, RTL handling, the read-only rule for religious text.
  - [docs/PRIVACY.md](docs/PRIVACY.md) — permissions table, what data is stored where, what is sent to which third party.
  - [docs/SECURITY.md](docs/SECURITY.md) — third-party dependencies, vulnerability reporting, the deferred audit items.
  - [docs/MV3_MIGRATION.md](docs/MV3_MIGRATION.md) — the Firefox MV3 path, gated on Mozilla resolving background audio playback.
  
  ## Troubleshooting
  
  - **Audio won't play**: Verify your internet connection, try another reciter, or check that browser audio permissions are enabled.
  - **Notifications not showing**: Allow notifications when prompted and confirm they are enabled in your browser settings.
  - **Extension won't load**: Enable Developer mode and make sure you selected the `chrome/` or `firefox/` folder.
  
  ## License
  
  [MIT](LICENSE)
  
  ## Acknowledgments
  
  All praise is due to Allah (SWT). Thanks to Quran.com for their API and to the reciters whose recitations make this possible.
  
  ## Changelog
  
  ### 2.1.1
  
  - Audio control persistence. Play, Pause, and Resume now render on every popup reopen as long as the offscreen document or background page still holds audio, regardless of whether the inputs match the saved keys. Restoration polls the runtime first (the offscreen always sets `audioUrl` on play) and falls back to `chrome.storage.local.audioState` if the service worker is asleep or slow to wake. Saved reciter ids from previous catalogue revisions resolve to the canonical entry via the alt-id index.
  - Combobox redesign. The surah and reciter pickers ship as a parchment panel inside the existing design system. Type-to-filter is case-insensitive and accent-insensitive, including for Arabic tashkeel and tatweel. Outside-click closes the panel even when clicking on a different card inside the popup.
  - Clear-surah button. The surah picker has its own inline clear icon, mirroring the clear-reciter affordance.
  - Dhikr bracket rendering. Mixed Arabic and Latin dhikr lines no longer flip the closing parenthesis past the Arabic word.
  - Shared reciter catalogue in the popup. The popup migrated to `shared/reciter-catalogue.js`, removing the popup-local copies and bringing the popup and background paths back into agreement on canonical ids.
  - Polling tracker no longer wipes the Resume affordance when a surah ends naturally with autoplay off. The end-of-track render now defers to the same logic the popup uses on a cold reopen, so the timestamp and progress bar stay visible instead of collapsing to zero.
  
  ### 2.1.0
  
  - Resume bug fix. Pause, close the popup, reopen later — the play button now correctly shows `Resume` with the saved timestamp on both Chrome and Firefox. Firefox also persists position across full browser restarts.
  - Reciter catalogue expansion. Al-Quran Cloud joins as a fourth provider; the previously hardcoded Islamic.network slug list is dropped. Coverage labels in the picker (`complete`, `limited`, `unknown`) are populated by a daily background HEAD-probe so users can pick reliable reciters confidently.
  - Surah search. The surah picker is now a search-as-you-type input. Type `mulk`, `67`, `Al-Fatihah`, or `الفاتحة` to filter.
  - Continue affordance. When a previous session is detected, a `Continue Surah <name> from M:SS` button appears above the play controls.
  - Sleep timer. New dropdown in the Qur'an card with Off / 15 / 30 / 45 / 60-minute presets. Audio pauses when the timer fires.
  - Design refinement. Stronger ink and rule contrast, larger card titles, gold-rule ON-state for toggle buttons, and the reminder window now uses the parchment tokens.
  - Security audit refresh. `api.alquran.cloud` added to the allowlist; coverage probe HEAD requests pass through `ensureAllowedAudioHost`. See `docs/SECURITY.md` for the full audit summary.
  
  ### 2.0.0
  
  - Modernization pass: consolidated cross-browser logic into `shared/`, parchment design tokens with self-hosted fonts and SVG sprite, JSDelivr hadith source pinned to a commit SHA, dhikr interval floor raised with auto-dismiss, emoji prefixes removed from UI strings.

• May 6, 2026
  host_permissions

  https://api.hadith.gading.dev/*, https://api.quran.com/*, https://verses.quran.com/*, https://mirrors.quranicaudio.com/*, https://download.quranicaudio.com/*, https://www.mp3quran.net/*, https://*.mp3quran.net/*, https://cdn.islamic.network/*, https://hadeethenc.com/*, https://cdn.jsdelivr.net/*

  https://api.hadith.gading.dev/*, https://api.quran.com/*, https://verses.quran.com/*, https://mirrors.quranicaudio.com/*, https://download.quranicaudio.com/*, https://www.mp3quran.net/*, https://*.mp3quran.net/*, https://cdn.islamic.network/*, https://hadeethenc.com/*, https://cdn.jsdelivr.net/*, https://api.alquran.cloud/*

Permissions & access

Permissions

offscreenstoragealarmsnotificationswindows

Host access

https://api.hadith.gading.dev/*, https://api.quran.com/*, https://verses.quran.com/*, https://mirrors.quranicaudio.com/*, https://download.quranicaudio.com/*, https://www.mp3quran.net/*, https://*.mp3quran.net/*, https://cdn.islamic.network/*, https://hadeethenc.com/*, https://cdn.jsdelivr.net/*, https://api.alquran.cloud/*

Screenshots

Similar extensions

Alternatives to Qur'an & Sunnah Companion, ranked by description similarity.

Muslim Reminder

Muslim Reminder delivers daily Quran verses, duas, and Islamic reminders in your browser.

40

★ 5.0

Quran Verses & Duaa Reminder

Get daily Quran verses and inspiring duaa reminders directly in your browser.

12

★ 5.0

Sakinah

Find peace through the Qur'an with random Ayahs, AI-guided spiritual guidance, and customizable notifications.

23

★ 5.0

Qur’an Quotes – Daily Ayahs, Islamic Inspiration & Reminders

Get daily Qur’an ayahs, Islamic reminders, and faith-building quotes. Boost your Iman with beautiful verses and offline access.

30

★ 5.0

Quran & Adhan - Daily Islamic Reminder

Beautiful new tab with Quran verses, prayer times, and Islamic reminders.

31

IlmTab - Islamic New Tab

Islamic new tab with prayer times, Quran verses, hadith, adhkar, and beautiful Islamic content for daily spiritual connection.

216

★ 5.0

Daily Eloquence

Read the selected Hadith or Quranic verse every time you open a new tab so you begin each task the right way! Contemplate the…

190

★ 4.8

Quran Before Work

Start your day with Quran ayahs for inspiration and focus.

8