The Quran Caption Software

Quran Video Tool

Quran Caption

Documentation

Download and Installation

Clear guidance for using Quran Caption from setup to export, with the same visual language as the rest of the product site.

Index

Documentation home

Previous

Start of guide

Next

Getting Started

Download Quran Caption

Quran Caption is available for multiple platforms. Choose the appropriate version for your operating system:

🖥️

Windows

Windows 10/11 (x64)

Download .exe
🍎

macOS

macOS 10.15+

Apple Silicon (M1/M2/M3) Intel Processor
🐧

Linux

Ubuntu/Debian/AppImage

Download .AppImage Download .deb

🔄 Software Updates

Important: When updating Quran Caption, your data and projects are always preserved, even if the installer asks for permission to uninstall the previous version. All your data remains safe during the update process.

Installation Instructions

🖥️ Windows Installation

  1. Download the QuranCaption.Windows.exe file from the GitHub releases page
  2. Double-click the downloaded .exe file to launch the installer
  3. Note: It's normal if Windows shows a "Windows protected your PC" message since the software isn't digitally signed. Simply click "More info" then "Run anyway"
  4. Follow the installation wizard by clicking "Next" through the steps
  5. Complete the installation process
  6. Launch Quran Caption from the desktop shortcut or start menu

🍎 macOS Installation

  1. Download the appropriate .dmg file for your Mac:
    • QuranCaption.MacOS.dmg for Apple Silicon (M1/M2/M3)
    • QuranCaption.MacOS.Intel.dmg for Intel processors
  2. Double-click the .dmg file to mount the disk image
  3. Drag the Quran Caption app to your Applications folder
  4. Eject the disk image by right-clicking it and selecting "Eject"
  5. Navigate to Applications and double-click Quran Caption to launch it
  6. If prompted by macOS security (Gatekeeper), go to System Preferences → Security & Privacy and click "Open Anyway", or hold Control while clicking the app and select "Open"

🐧 Linux Installation

Option 1: AppImage (Universal)

  1. Download the QuranCaption.Linux.AppImage file
  2. Make the AppImage executable:
    chmod +x QuranCaption.Linux.AppImage
  3. Run the application:
    ./QuranCaption.Linux.AppImage

Option 2: Debian Package (.deb)

  1. Download the QuranCaption.Linux.deb file
  2. Install using dpkg:
    sudo dpkg -i QuranCaption.Linux.deb
  3. If there are dependency issues, fix them with:
    sudo apt-get install -f
  4. Launch from the applications menu or run qurancaption in terminal

⚠️ Troubleshooting Installation

Windows: If you see "Windows protected your PC", click "More info" then "Run anyway". This is normal for unsigned software.

macOS: If the app won't open due to security restrictions, try holding Control while clicking the app and select "Open", or go to System Preferences → Security & Privacy.

Linux: For AppImage, ensure you have execution permissions. For .deb packages, make sure you have administrator privileges.

First Launch

When you first launch Quran Caption, you'll see the welcome screen with options to:

  • Create a new project
  • Import a project

If you had Quran Caption 2 installed, your existing projects will be automatically detected and you will be asked if you want to import them into Quran Caption 3.

Quran Caption welcome screen showing project options

✅ Installation Complete!

Congratulations! Quran Caption is now installed and ready to use. Continue to Getting Started to create your first project.

Next chapter

Getting Started

east