Quran Video Generator

Create polished Quran recitation videos with a modern desktop interface, subtitle controls, and fast FFmpeg-based rendering.

✨ Highlights

• 🎬 Modern desktop UI with clean workflow tabs
• 🎯 Two generation modes: random batch + custom ayah ranges
• 🌍 Dual subtitle mode: Arabic + one selected language
• ⚙️ Quality controls: preset, CRF, bitrate, duration
• 📦 Distribution-ready output in dist/QuranVideoGenerator

📁 Project Layout

This repository is intentionally deep-cleaned and organized:

loki2/
├─ assets/
│  └─ icons/
│     └─ app_icon.ico
├─ docs/
│  └─ CLEANUP_REPORT.md
├─ scripts/
│  └─ README.md
├─ src/
│  ├─ app/
│  │  └─ gui_app.py
│  └─ core/
│     └─ quran_video_generator.py
├─ dist/  (ignored from git push)
│  └─ QuranVideoGenerator/
├─ gui_app.py                  # compatibility entrypoint
├─ quran_video_generator.py    # compatibility export
├─ requirements.txt
└─ README.md

🚀 Quick Start (Run Source)

1. Install dependencies:

pip install -r requirements.txt

2. Run the app:

python gui_app.py

📦 Run Prebuilt Version

Use the packaged build directly from:

• dist/QuranVideoGenerator/QuranVideoGenerator.exe
• or dist/QuranVideoGenerator/Start.bat

🧰 Requirements

• Windows (desktop app target)
• Python 3.10+ (if running from source)
• FFmpeg available via:
  • system PATH (ffmpeg command), or
  • local executable files bundled beside the app

🖥️ UI Overview

• Random: generate multiple videos in one run
• Custom: select exact surah + ayah range + reciter
• Settings: control quality, output paths, subtitle language

🔧 Technical Notes

• gui_app.py: desktop interface, settings/state, async generation flow
• quran_video_generator.py: core media generation logic and FFmpeg integration
• Progress callbacks are attached/detached per generation run to avoid stale state

📌 Distribution Notes

• The distributable folder is already prepared in dist/
• Keep the entire dist/QuranVideoGenerator folder together when sharing

🤝 Credits

• Quran text/audio API: alquran.cloud
• Media processing: FFmpeg