GitHub - OmarAfifi-CSE/tabattal: 📖 تَبَتَّلْ | The purest digital Mushaf & Quran video studio. Authentic 15-line Madani vector (QCF V2), synchronized 9:16/1:1/16:9 reel maker, verse cards, hifz tools, offline audio & tafsir. Free & Open-Source Sadaqa Jariya.

The Purest, Most Precise Digital Mushaf Experience & Quran Video Studio

﴿ وَاذْكُرِ اسْمَ رَبِّكَ وَتَبَتَّلْ إِلَيْهِ تَبْتِيلًا ﴾

مصحفك كما تعرفه، وأثرٌ يصل أبعد.

مصحف المدينة، والتلاوة، والتفسير، والحفظ، وصانع مقاطع قرآنية متزامنة — مجانًا وبدون إعلانات أو تتبع.

🌟 The Vision

⚠️ The Problem

Digital Quran apps typically force compromises across reading and sharing:

📸 The "Scanned Image" Trap Static page scans → massive app size, slow loading, and blurry/pixelated text on high-res screens.

📝 The "Generic Text" Trap Standard unformatted body text → destroys the sacred, standardized 15-line pagination of the authentic Madani Mushaf.

🔇 The "Static Media" Trap Sharing is limited to plain text or flat cards → no way to create modern, synchronized Quran video reels for social platforms without third-party editors.

✅ The Solution

Tabattal brings an authentic Madani Mushaf and a native Quran video studio into one focused experience.

📖 Authentic Vector Engine: Powered by King Fahd Complex QCF V2 glyph fonts, preserving the familiar 604-page, 15-line Madani Mushaf layout.
🎬 Quran Video & Reels Studio: Design and export synchronized videos in 9:16, 1:1, and 16:9 with recitations, line-by-line Madani typography, and custom image or video backgrounds.

Read with focus. Understand with context. Share with care.

📱 Showcase

Arabic Showcase

📖 تلاوة القرآن والقائمة الذكية رسم عثماني مطابق لمصحف المدينة وقائمة إجراءات سريعة	📑 القائمة الجانبية والأدوات تنقل فوري وشامل لجميع خدمات وأدوات المصحف	🎬 صانع مقاطع الفيديو والريلز فيديوهات قرآنية سينمائية متزامنة بدقة 1080p	🎨 تصميم بطاقات الآيات بطاقات فاخرة للآيات مع التفسير والترجمة للمشاركة
🧠 وضع تثبيت واختبار الحفظ إخفاء ذكي للآيات والكلمات وكشفها تفاعليًا بلمسة	📚 مكتبة التفسير الشاملة تفسير كامل متصل مع تفاسير متعددة لأشهر العلماء	🎧 مدير الصوتيات والتلاوات تحميل السور والمصحف كاملًا بجودة نقية دون إنترنت	🎨 المظهر واللغة وثيمات المصحف 11 مظهرًا ووضع ليلي ودعم متعدد اللغات (العربية، الإنجليزية، والإندونيسية)

English Showcase

📖 Authentic Mushaf & Smart Menu Flawless 15-line Madani layout with quick actions	📑 Navigation Drawer & Tools Hub Instant access to all Quranic learning utilities	🎬 Quran Video Studio & Reels Synced audio video creator in 9:16, 1:1, and 16:9	🎨 Verse Card Designer & Sharing High-res social cards with Tafsir & Translation
🧠 Smart Hifz & Memorization Mode Mask verses & words with tap-to-reveal testing	📚 Comprehensive Tafsir Library Full surah commentaries from leading scholars	🎧 Audio Manager & Offline Recitations Download full surahs or entire Mushaf offline	🎨 Themes, Night Mode & Language 11 themes, dark mode, and multilingual support (Arabic, English, Indonesian)

✨ Key Features

🖌️ Pixel-Perfect QCF V2 Vector Engine

📐 Authentic Layout

Exactly 15 lines per page, matching the physical printed Mushaf — genuine glyphs, genuine stop signs.

⚡ Responsive Paging

Physics-driven bidirectional page navigation with adjacent-page prewarming for a responsive reading experience.

🚀 Instant Typography

All 604 page fonts pre-warmed in RAM — no zip extraction, no runtime layout overhead.

🎬 Quran Video Studio & Reels Maker (Creative Video Suite)

🎥 Multi-Aspect Studio Engine

9:16 Vertical Story/Reels — Tailored for Instagram Reels, TikTok & Shorts
1:1 Square Post — Designed for WhatsApp Status, Feed & Posts
16:9 Landscape — Built for YouTube & widescreen displays
Ayah Span Selector — Choose a consecutive verse range with seamless continuity

✨ Authentic Typography & Dynamic Media

Synchronized Recitation — Precise EveryAyah audio sync with authentic line-by-line Madani vector typography
Dual Media Backgrounds — Custom gallery images or animated video backgrounds (local or direct URL) with audio mixing
Adaptive Luminance Engine — Auto-adjusts text colors (pure white / deep black) with adjustable dimming
Hardware-Accelerated FFmpeg Export — Crisp, high-fidelity video rendering with instant gallery indexing

🎨 Verse Card Generator & Page Export

Custom Sharing Cards — High-resolution cards for single verses or verse ranges
Granular Controls — Include/exclude Tafsir and translations (English & Indonesian) independently
Full-Page Snapshot — Export the entire Mushaf page with Islamic border framing
11 Curated Themes — Instant gallery sync with Android media store indexing

🔍 Thematic & Deep Text Search

Topics Catalog — Aqeedah, Acts of Worship, Ethics, Stories of the Prophets, Social Conduct
Intelligent Engine — Prefix/suffix normalization, surah matching, in-page highlighting with breathing animations

🎧 Comprehensive Audio & Offline Manager

🎙️ Extensive Reciters — Murattal, Mujawwad, Teacher mode, English translations
▶️ Play-Once Mode — Auto-pause after one verse for focused memorization
⏰ Smart Sleep Timer — Custom durations for bedtime listening

📥 Offline Downloads — Full Surahs with real-time progress & instant cancellation
🔔 Background Service — Lockscreen controls, notification actions, network recovery

📚 Tafsir, Translation & Quran Vocabulary

Ghareeb Al-Quran — Offline lookup for difficult Quranic words, per verse
Grouped Tafsir Context — Smart detection of multi-verse commentary spans
Smart Selector — Fast, offline commentaries with upward-opening picker
Multilingual Translations — Clear, authenticated English (Saheeh International) and Indonesian (Kemenag) translations displayed alongside authentic Arabic commentaries

🧠 Interactive Memorization Test (Hifz Tool)

Word & Ayah Masking — Conceal text directly on the page with zero shifting
Tap-to-Reveal — Instant reveal with full access to verse options

🎨 11 Handcrafted Themes & Adaptive UI

Creamy • Parchment • Rose Gold • Mint • Olive • Ice Blue • Slate • Emerald • Burgundy • Pure White • OLED Dark

Multilingual Interface — Full native experience in Arabic (RTL), English (LTR), and Indonesian (Bahasa Indonesia LTR)
OLED Dark Mode — True black for Qiyam and night reading, saves battery
Adaptive Chrome — Status/nav bar contrast adapts automatically to theme
Flexible Reading — Switch between horizontal book paging and vertical scroll

🔒 100% Free, Private & Ad-Free

Built as a Sadaqa Jariya — no ads, no tracking, no analytics, no third-party SDKs. Fully offline-first once content is downloaded.

🛠️ Technical Stack

Layer	Technology
Framework	Flutter (Android, Windows, Web)
State Management	BLoC / Cubit
Architecture	Clean Architecture (Domain / Data / Presentation)
Video & Motion Engine	Custom Canvas Rasterizer + `ffmpeg_kit_flutter_new_min_gpl`
Audio Pipeline	`just_audio` + `audio_service` with MediaSession background sync
Database & Cache	SQLite (`sqflite`) with indexed word-level spatial lookup
Typography	604 QCF V2 vector font families, natively managed
Code Quality	Strict zero-lint policy, optimized frame rendering

☕ Support The Project

Tabattal is an ad-free, open-source passion project built as a Sadaqa Jariya to provide the purest Quran reading experience. If it benefits your daily recitation and study, consider supporting its development:

⭐ Star this repo to support the project

Made with dedication to the Book of Allah 🕌

Name		Name	Last commit message	Last commit date
.vscode		.vscode
android		android
assets		assets
docs		docs
lib		lib
server/video_export_service		server/video_export_service
test		test
web		web
windows		windows
.env.example		.env.example
.gitignore		.gitignore
.metadata		.metadata
LICENSE		LICENSE
PRIVACY_POLICY.md		PRIVACY_POLICY.md
README.md		README.md
analysis_options.yaml		analysis_options.yaml
build_and_export.ps1		build_and_export.ps1
devtools_options.yaml		devtools_options.yaml
l10n.yaml		l10n.yaml
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml
run_web.ps1		run_web.ps1

Navigation Menu

Uh oh!

Repository files navigation

The Purest, Most Precise Digital Mushaf Experience & Quran Video Studio

﴿ وَاذْكُرِ اسْمَ رَبِّكَ وَتَبَتَّلْ إِلَيْهِ تَبْتِيلًا ﴾

🌟 The Vision

⚠️ The Problem

✅ The Solution

📱 Showcase

✨ Key Features

🖌️ Pixel-Perfect QCF V2 Vector Engine

🎬 Quran Video Studio & Reels Maker (Creative Video Suite)

🎨 Verse Card Generator & Page Export

🔍 Thematic & Deep Text Search

🎧 Comprehensive Audio & Offline Manager

📚 Tafsir, Translation & Quran Vocabulary

🧠 Interactive Memorization Test (Hifz Tool)

🎨 11 Handcrafted Themes & Adaptive UI

🔒 100% Free, Private & Ad-Free

🛠️ Technical Stack

☕ Support The Project

⭐ Star this repo to support the project

About

Sponsor this project

Contributors

Languages

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

The Purest, Most Precise Digital Mushaf Experience & Quran Video Studio

﴿ وَاذْكُرِ اسْمَ رَبِّكَ وَتَبَتَّلْ إِلَيْهِ تَبْتِيلًا ﴾

🌟 The Vision

⚠️ The Problem

✅ The Solution

📱 Showcase

✨ Key Features

🖌️ Pixel-Perfect QCF V2 Vector Engine

🎬 Quran Video Studio & Reels Maker (Creative Video Suite)

🎨 Verse Card Generator & Page Export

🔍 Thematic & Deep Text Search

🎧 Comprehensive Audio & Offline Manager

📚 Tafsir, Translation & Quran Vocabulary

🧠 Interactive Memorization Test (Hifz Tool)

🎨 11 Handcrafted Themes & Adaptive UI

🔒 100% Free, Private & Ad-Free

🛠️ Technical Stack

☕ Support The Project

⭐ Star this repo to support the project

About

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

Contributors

Languages