Visits : 1

Quran Browser – Advanced Desktop Application for Quran Study

Quran Browser is a comprehensive desktop application designed for serious Quran study and research. It combines advanced text search capabilities with audio playback, note-taking, lesson organization, and numerous study tools in one integrated environment. Perfect for students, teachers, researchers, and anyone seeking to deepen their understanding of the Quran.

🖼️ Application Screenshots

Main Interface

Verse Detail View with Context

Notes Management System

Courses Management System

Words Dictionary

Pinned Verses Management

Compact Help

Comprehensive Help

Main Interface – Dark Mode

👨‍🎓 Who Is Quran Browser For?

Quran Browser is designed for:

Quran Students: For memorization, revision, and understanding
Teachers & Educators: For preparing lessons and course materials
Researchers: For linguistic analysis and thematic studies
Reciters: For practicing with synchronized audio
General Users: For daily reading and reflection

✨ Key Features Overview

🔍

Advanced Quran Search

Full-text search in Uthmani and simplified scripts
Multiple search methods: Text, Surah, and Verse Range
Special search operators (# for exact match, % for wildcards)
Arabic diacritics-aware searching
Search history and auto-suggestions

🎵

Audio Playback & Synchronization

Synchronized audio playback with text highlighting
Multiple playback modes: single verse, context, full surah
Repeat modes with customizable counts
Automatic basmalah insertion between surahs
Custom audio directory support

📝

Comprehensive Notes System

Verse-specific notes and reflections
Rich text formatting in notes editor
Notes manager with filtering and searching
Auto-save and recovery features
Export/import notes to CSV format

📚

Lessons & Course Manager

Create and organize Quran study courses
Multiple content types: verses, searches, text notes
Reorder lesson elements easily
Auto-playback through lesson content
Print lesson content in organized format

⭐

Bookmarks & Pinned Verses

Quick-reference bookmarks system
Pinned verses with group management
Star indicators for pinned verses
Organize verses by topics or themes
Quick access to frequently referenced verses

💾

Data Management & Backup

Complete data export/import functionality
Backup and restore all application data
Transfer data between installations
JSON-based configuration and data storage
Cross-platform data compatibility

🎨

Display Customization

Toggle between Uthmani and simplified scripts
Dark/Light theme switching
Adjustable font sizes with keyboard shortcuts
Word highlighting with custom colors
Responsive layout for different screen sizes

⚙️

Advanced Study Tools

Word dictionary with definitions
Verse context display (12 verses before/after)
Copy verses with smart formatting
Word occurrence counting in searches
Quick navigation between surahs and verses

🔎 Search Capabilities

Text Search

Search by Arabic keywords
Supports partial diacritics
Special operators: #, %, @
Word occurrence counting
Search within current surah (!)

Surah Search

Load complete surahs
Quick navigation between surahs
Dropdown selection of all 114 surahs
Keyboard arrow navigation

Verse Range Search

Search specific verse ranges
Format: "Surah FirstAyah LastAyah"
Quick access to specific passages
Perfect for study of specific sections

🎧 Audio Features

Verse Playback: Play selected verse or range
Context Playback: Verse plus 5 following verses
Surah Playback: Complete surah with continuation
Repeat Modes: Infinite or limited repeats
Auto-advance: Automatic progression to next verse

Audio Format: Standard MP3 files (SSSAAA.mp3)
Basmalah: Automatic insertion between surahs
Custom Audio: Support for different reciters
Playback Control: Play, pause, stop, skip
Status Display: Current playback information

⌨️ Keyboard Shortcuts

Work efficiently with comprehensive keyboard shortcuts.

Complete list of 50+ shortcuts available in application help (Ctrl+H).

🛠️ Technology Stack

Built with modern technologies for reliability and cross-platform compatibility:

Python 3.7+ PyQt5 (GUI Framework) SQLite Database JSON Configuration Cross-platform (Windows/Linux/macOS) SQLAlchemy (ORM) QThread (Background Processing) HTML/CSS (Help System)

🌐 Open Source & Development

Quran Browser is an open-source project developed with a focus on accuracy, performance, and usability for serious Quran study. The source code is publicly available on GitHub.

View Source on GitHub

Contributions, bug reports, and feature requests are welcome. Developers can explore the architecture, search engine, and audio synchronization logic directly.

🚀 Download Quran Browser

Start your enhanced Quran study experience today!

Current version: 1.3.1 (released 2026-01-28)

🪟 Download for Windows

System Requirements: Windows 10+, Linux with Qt5, or macOS 10.14+.
Audio files available separately from EveryAyah.com

📥 Installation Guide

Windows Installation

Download the Windows ZIP file
Extract to your preferred location
Run QuranBrowser1.3.1.exe
No Installation is required, it is a standalone executable
Download audio files from EveryAyah.com (optional)

Linux Installation

Go to the GitHub repo for details
View Source on GitHub

💬 Support & Community

Get help, request features, and join our user community:

Telegram Support Group Email Support

Audio Files: Download Quran audio files (per-verse MP3) from EveryAyah.com and place them in the audio directory.

📝 Release History

Version history for Quran Browser. Latest features and improvements.

# Changelog


## 1.3.1 — 2026-01-27
### Features
- Now supporting Windows platform
- Added Quran words dictionary dialog
- Enhanced search logic with word boundary aware search
- Detail view supports font size change
- Added color highlighting for search query
- Added autocomplete feature in search
- Added font size control

### Improvements
- Scroll to top after surah selection
- Bug fixes and improvements to course manager
- Course improvements
- Bookmarks improvements
- More improvements and fixes
- Better status messages
- Updated install scripts
- Minor fixes across the app
- Removed ignored files from tracking

### Fixes
- Bug fixes and general improvements
- Fixed Windows install script
- Fixed course handling
- Reload bookmarks after adding bookmark
- Enhanced search history navigation

---

## 1.3.0 — 2025-07-03
### Refactor
- Complete refactor of codebase

---

## 1.2.0 — 2025-03-26
### Features & Improvements
- UI improvements
- Bookmarks handling improvements
- Course management improvements

---

## 1.1.0 — 2025-02-14
### Initial release
- User manual created
- Project setup and first commit

❓ Frequently Asked Questions

📥 Where can I get Quran audio files?

Quran Browser does not bundle audio files to keep downloads lightweight. You can download per-verse Quran recitations from EveryAyah.com.
After downloading, extract the files and set the folder as your audio directory via Settings → Audio or using Ctrl + Shift + A.

🔄 How do I transfer my data to another computer?

Quran Browser includes a complete data export and import system.

Use Ctrl + Shift + E to export all data
This includes notes, bookmarks, pinned verses, and lessons
Copy the exported file to another computer
Import it using the same Data Transfer dialog

🔎 What do the search operators (#, %, @, !, ?) mean?

# — Exact word match (e.g. الرحمن#)
% — Wildcard match (e.g. %الله)
@ — Preserve hamza and alif variants
! — Search within the currently loaded surah
? — Search within the surah selected in the dropdown

🌍 Is the application available in Arabic?

Yes. Quran Browser is primarily designed for Arabic users. The interface, help system, and documentation are available in Arabic.
Press Ctrl + Shift + H to access the full Arabic help manual.