Skip to content

A one-click Quran reels video creator. It automatically imports recitations and text and formats them with natural backgrounds using Python and MoviePy. It also features an automatic Quran reel generator using Python, Flask, and MoviePy. The tool imports recitations and Uthmani script to create beautiful vertical videos.

License

Notifications You must be signed in to change notification settings

EslamSad3/Quran-Reels-Generator

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📖 Quran Reels Generator | أداة عمل ريلز القرآن الكريم

English | العربية


🇪🇬 اللغة العربية

أداة ذكية ومؤتمتة تتيح لك إنشاء مقاطع فيديو قصيرة (Reels/Shorts) للقرآن الكريم بجودة عالية وبضغطة زر واحدة. تقوم الأداة بدمج التلاوة العطرة مع النص القرآني بالرسم العثماني فوق خلفيات طبيعية خلابة.

🚀 المميزات

  • أتمتة كاملة: جلب النصوص والتسجيلات الصوتية تلقائياً من الإنترنت.
  • تنوع القراء: دعم لأكثر من 10 قراء من مشاهير العالم الإسلامي.
  • خلفيات ديناميكية: اختيار عشوائي لمقاطع فيديو طبيعية لضمان عدم التكرار.
  • تنسيق ذكي: ضبط تلقائي لحجم الخط وتوزيعه ليناسب شاشات الجوال.
  • دعم اللغة العربية: معالجة النصوص العربية وعرضها بشكل صحيح ومشكول.

⚙️ كيف تعمل الأداة؟

تعمل الأداة من خلال دورة حياة برمجية منظمة:

  1. الواجهة (UI): واجهة ويب بسيطة مبنية بـ HTML/JS للتفاعل مع المستخدم.
  2. الخادم (Backend): مبني باستخدام Flask لاستقبال الطلبات ومعالجتها.
  3. البيانات: يتم جلب النص العثماني من api.alquran.cloud والصوت من everyayah.com.
  4. المعالجة الصوتية: استخدام مكتبة pydub لقص الصمت في بداية ونهاية كل آية لضمان التزامن المثالي.
  5. المونتاج الآلي: استخدام محرك MoviePy لتركيب طبقات الفيديو (خلفية + نص + صوت) وتنسيقها.
  6. التصدير: إنتاج فيديو نهائي بصيغة MP4 وبأبعاد طولية مناسبة لمنصات التواصل الاجتماعي.

🛠️ المتطلبات التقنية

لتشغيل المشروع يدوياً، يجب توفر:

  • Python 3.10+: لغة البرمجة الأساسية.
  • FFmpeg: المحرك المسؤول عن معالجة الفيديو والصوت (ضروري جداً).
  • ImageMagick: الأداة المسؤولة عن تحويل النصوص إلى صور لدمجها في الفيديو.
    • تنبيه: عند تثبيت ImageMagick على Windows، تأكد من تفعيل خيار "Install legacy utilities (e.g. convert)".

📥 طريقة التشغيل اليدوي

  1. قم بتحميل المستودع وفك الضغط عنه.
  2. افتح نافذة الأوامر (Terminal) في مجلد المشروع.
  3. قم بتثبيت المكتبات اللازمة:
    pip install -r requirements.txt
  4. ابدأ تشغيل الأداة:
    python main.py
  5. سيفتح المتصفح تلقائياً على الرابط http://localhost:5000.

المشروع لأهداف تعليمية فقط وجميع الحقوق محفوظة لأصحابها

🇬🇧 English

An automated, intelligent tool designed to allow you to generate high-quality Quran Reels/Shorts with a single click, combining beautiful recitations with Uthmani script overlays on stunning nature backgrounds.

🚀 Features

  • Full Automation: Automatically fetches Quranic text and audio from the web.
  • Reciter Variety: Supports over 10 world-renowned reciters.
  • Dynamic Backgrounds: Randomly selects nature videos to ensure unique content.
  • Smart Formatting: Auto-adjusts font size and alignment for mobile screens.
  • Arabic Support: Perfectly handles and renders Arabic diacritics (Tashkeel).

⚙️ How It Works

The tool follows a structured workflow:

  1. UI: A sleek web interface built with HTML/JS for user interaction.
  2. Backend: Built with Flask to handle requests and manage the logic.
  3. Data Sourcing: Fetches Uthmani text via api.alquran.cloud and audio from everyayah.com.
  4. Audio Processing: Uses pydub to trim silence at the beginning and end of each verse for perfect synchronization.
  5. Auto-Editing: Utilizes the MoviePy engine to composite video layers (Background + Text + Audio).
  6. Exporting: Outputs a final MP4 video in vertical orientation (9:16), ready for TikTok, Instagram, and YouTube.

🛠️ Technical Requirements

For manual execution, you need:

  • Python 3.10+: The core programming language.
  • FFmpeg: The engine responsible for audio/video encoding (Essential).
  • ImageMagick: Responsible for rendering text into video frames.
    • Note: During ImageMagick installation on Windows, ensure you check "Install legacy utilities (e.g. convert)".

📥 Manual Execution Guide

  1. Download and extract the repository.
  2. Open a terminal/command prompt in the project folder.
  3. Install dependencies:
    pip install -r requirements.txt
  4. Run the application:
    python main.py
  5. The browser will automatically open at http://localhost:5000.

📞 Support | الدعم

Developed by Arabian AI School


🎥 Tutorial & Download | روابط الشرح والتحميل

© المشروع لأهداف تعليمية فقط وجميع الحقوق محفوظة لأصحابها

About

A one-click Quran reels video creator. It automatically imports recitations and text and formats them with natural backgrounds using Python and MoviePy. It also features an automatic Quran reel generator using Python, Flask, and MoviePy. The tool imports recitations and Uthmani script to create beautiful vertical videos.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • HTML 50.9%
  • Shell 26.0%
  • Python 23.1%