🚀 Quran Caption v3.4.0 — Advanced AI Translation & Major Update

This major update introduces a powerful new AI translation tool, automatic updates, and major improvements across performance, export, and workflow.

🤖 Advanced AI Translation Tool

A new advanced AI translation trimming tool is now available directly inside the software.

• Requires an OpenAI API key
• Very fast processing
• ~95% success rate on segments
• Low cost usage
• Delivers high-quality results, tested on full Quran translations

This tool significantly reduces manual work when aligning translations with subtitles.

🧩 Workflow & UX Improvements

• Added backup & restore system in Settings (full project recovery)
• Added option to export project data from homepage
• Added Ctrl + A shortcut to select all subtitles in Style tab
• Added “Remove all subtitles” option in Tools
• Added confirmation dialog when closing the app during export

✍️ Translation & Review Improvements

• Translation words are now always visible, even when manually editing text
• Visual highlighting of overlapping words in Arabic and English WBW segments
• Fixed a bug where trimming a word would reset the next subtitle’s status

🔄 Auto-Update System (feat. @Himmy504)

• Implemented automatic updates
• No more manual reinstall needed — updates are now done in one click. May Allah reward brother Fawwaz for this beautiful feature!

⚙️ Export & Performance Improvements

• Fixed a performance issue where hidden translations caused 5× slower frame capture

• Added advanced export settings:

  • CPU usage control (high / moderate / low)

• Fixed an issue where background videos were stretched incorrectly

• Fixed macOS issues with:

  • Project deserialization
  • Arabic text not displaying on some subtitles

🌍 Media & Integration

• Added support for downloading media from:

  • TikTok
  • Twitter
  • Instagram
  • SoundCloud
  • (in addition to YouTube)

🎨 UI Improvements

• Improved update modal:

  • Latest changelog now shown at the top
  • Fixed white-on-white text issues with some themes

🐛 Bug Fixes

• Fixed macOS Arabic rendering issues on certain subtitles
• Fixed background video scaling issues in export
• Fixed typos in Muhammad Hamidullah translation

🤖 AI Segmentation Enhancements

• Improved visibility and emphasis of Cloud AI Segmentation v2
• Added a changelog inside the software for AI segmentation updates
  → Stay informed about model improvements directly in the app

🧹 Codebase

• Full codebase refactor:

  • Fixed all ESLint and TypeScript errors
  • Improved maintainability and code quality

Hotfix — fixed a bug that made it impossible to select a surah in the subtitles editor. (oops)

🚀 Quran Caption v3.3.9 — Performance, UX & Workflow Improvements

This update focuses on improving usability, performance on large projects, and overall workflow reliability.

✨ New Features

• Added the ability to search by surah:verse (e.g. 2:255) in the Translations tab search bar.
  → Press Enter to jump directly to the verse.

• Added support to import a translation from a .txt file.

• Added the ability to apply a unique overlay style per video clip in the timeline.

• Added an export queue system:

  • Only one export runs at a time
  • Others are queued automatically

• Added an onboarding tour for new users:

  • Includes a test project
  • Guides through the main features of the software

• You can now open DevTools with F12 (useful for debugging).

• Export file path input is now editable:

  • If the destination folder does not exist, it will be created automatically.

⚡ Performance Improvements

• Major performance optimizations across tabs.
  → The software is now much smoother on large projects.

🎨 UI & UX Improvements

• Fixed an issue on small screens where predefined subtitles were not fully visible (no scrollbar).
• Fixed issues with light themes (unreadable text).
• When creating a project, reciters not in the official list but used in other projects are now suggested in autocomplete.

🐛 Bug Fixes

• Fixed a bug where looped videos did not appear on the last iteration.
• Fixed an issue where project name or reciter changes were not updated on the homepage.
• Fixed minor issues in the Spanish translation.

🛠️ Quran Caption v3.3.8 — Export Fixes & Workflow Improvements

This update fixes a regression introduced in the previous version and improves export debugging, translation workflow, and UI clarity.

🎬 Video Export Fixes

• Fixed a video export regression introduced in the previous update that caused issues with:

  • text scaling
  • background overlay rendering

🧠 AI Translation Improvements

• AI translation now skips subtitles that already have a confirmed reviewed status.

  • This significantly reduces processing time.
  • Ensures manually reviewed translations are never modified by the AI.

This is especially useful after partially fetching translations from other projects:
AI will now complete only the missing translations instead of reprocessing the entire verse.

🧩 Export Debugging Improvements

• Added the ability to copy export error messages directly.
• Export logs now include a full absolute file path to the log file for easier debugging.

🎨 New Styling Option (feat. @umairayub79)

• Added a new RTL text style for translations.

  • Useful for languages that require right-to-left text rendering.

⚙️ UI & Usability Improvements

• Added communication and support buttons inside the Settings panel.
• Added a clear error message when an unsupported audio format is added to the timeline.

🚀 Quran Caption v3.3.7 — Export Stability, Workflow Improvements & Community Features

This update improves export reliability, project loading performance, and introduces new ways for users to interact with the project directly from the software.

🎬 Video & Export Improvements

• Fixed an issue on macOS where video export could get stuck at 0%.

• Fixed out-of-memory errors when exporting long videos.

• Added video looping until audio ends (feat. @umairayub79):

  • Right-click a video clip in the timeline to enable the loop option.

• Improved exporter stability overall.

⚡ Performance Improvements

• Faster project loading on startup, improving overall launch performance.

🧩 Subtitle & Asset Improvements

• Fixed a bug where it was not possible to set timing for custom image clips.
• Added an informative tooltip for background style, reminding users that it only works when max-height style is enabled.

🌍 Translation Workflow Improvements

• Improved translation fetching logic:

  • Previously trimmed translations from other projects are now prioritized.

  • Projects are prioritized by recency, then by status:

    • reviewed / automatically trimmed
    • then fetched / AI trimmed.

• Improved recalculation of translation word indexes for QC1 projects.

💬 Community & Feedback

• Added a new Donation modal.

• Added options inside the software to:

  • Leave a review
  • Report a bug
  • Request a feature

🐛 Bug Fixes

• Fixed an issue where shortcut settings were not being saved.

🚀 Quran Caption v3.3.6 — AI Progress, Review Tools & Stability Improvements

This update improves AI segmentation feedback, subtitle review tools, and overall UI consistency.

🤖 AI Segmentation Improvements

• Implemented a progress bar for AI segmentation (Cloud + Local V2).

  • Based on estimated remaining time.
  • Note: accuracy may vary depending on local hardware performance.

• Fixed incorrect missing-word detection after AI segmentation when switching surahs mid-recitation.

• The warning “Local V2 uses private HF models…” now only appears when no Hugging Face token is set.

🔍 Translation & Review Enhancements

• Added a “Show overlapping subtitles” filter in the Translations tab.

  • Displays subtitles that share overlapping words with the previous one.
  • Shows both subtitles for proper context.
  • Especially useful to review AI translation trimming on overlapping words.

• Fixed a bug where applying filters in the Translations tab did not properly refresh translations, causing inconsistencies between Arabic subtitles and translations.

🎨 Styling & UI Improvements

• Predefined subtitles can now be styled individually like normal subtitles.

• Added a new global Overlay sub-style:

  • Control fade percentage vs non-fade percentage.
  • Higher value = fade occupies more space.

• Fixed Light/Sepia theme issues affecting:

  • WBW tooltips (white-on-white / black-on-black)
  • Other UI areas.

• Fixed layout issue in the Style tab where
  “Press ctrl+left click…” took too much space on small screens.

• Fixed bug where re-selecting an already selected verse in Style tab did not properly toggle (toggle now works correctly).

🐛 Bug Fixes

• Attempted fix for an issue where the first subtitle did not appear during video export for some users.

🚀 Quran Caption v3.3.5 — Predefined Texts, Styling & Stability Improvements

This update introduces new predefined texts, improves styling consistency, and fixes several important issues.

✨ New Predefined Texts

Five new predefined texts have been added to the software:

• Ameen — آمين
• Takbir — الله أكبر
• Tahmeed — سمع الله لمن حمده
• Tasleem — السلام عليكم ورحمة الله
• Sadaqa — صدق الله العظيم

These texts:

• Can be assigned to custom shortcuts in Settings (like Basmala and Istiʿādha).
• Include translations in the main supported languages.
• Are now also detected automatically by AI segmentation when present in the recitation (feat @Hetchy).

🎨 Styling & Visual Enhancements

Decorative Parentheses Upgrade

• Decorative parentheses now use the QPC2_BSML font.
• Includes 9 different decorative variants.
• Ensures more consistent rendering across systems.

Overlay Fade Improvements

Added new background overlay fade types:

• Uniform
• Fade from top
• Fade from bottom
• Center fade

Includes intensity control, allowing you to darken only the subtitle area instead of the entire video.

Theme & Style Consistency

• Newly introduced styles are now automatically added:

  • When opening older projects
  • When importing style files from previous versions

• Fixed several theme-related issues (white-on-white text, unreadable combinations, etc.).

✍️ Editing & Workflow Improvements

• Separated editing shortcuts from custom text insertion shortcuts (small UI improvement).

• You can now manually insert line breaks in subtitles using \n.

• Multi-selection behavior improved:

  • Use Ctrl + Click to select multiple subtitles.
  • A simple click now deselects the previously selected subtitle.

🧩 Asset Handling Improvements

• When deleting an asset, the prompt
  “Do you also want to delete it from disk?”
  now appears only for assets downloaded directly through the app
  (MP3Quran or YouTube downloader).

🐛 Bug Fixes

• Fixed local AI segmentation v2 on macOS.

• Fixed a regression in automatic translation trimming:

  • Subtitles marked as “automatically trimmed” now properly re-trim when context changes.

• Fixed various theme-related rendering issues.

🚀 Quran Caption v3.3.4 — New AI Segmentation & Major Enhancements

This update introduces a brand-new AI segmentation engine along with workflow improvements, new creative features, and important fixes.

🤖 New AI Segmentation (ft. @Hetchy)

A major upgrade to the AI segmentation system:

• Unlimited cloud usage
• Faster segmentation
• Better performance with low-quality audio
• More customization options
• New Local v2 engine available
• Legacy Local v1 still supported

The auto-segmentation wizard has also been refactored for improved clarity and UI consistency.

🖼️ New Feature — Image Linked to Subtitle

• You can now link an image to a subtitle.
  → The image will be displayed full screen during the subtitle’s appearance time.
  → Right-click a subtitle in the timeline → Link Image

✍️ Subtitles & Editing Improvements

• Improved T shortcut behavior:

  • Adds a custom text from the end of the last subtitle to the cursor,
  • OR from the cursor position to +3 seconds by default

• Fixed timeline navigation:

  • When navigating with arrows while paused, the timeline now properly follows the cursor.
  • Navigation between subtitles via control bar now always keeps the cursor visible.

• Added “To Review” project status

• Improved overall UI consistency

📖 New Translation

• Added Saheeh International v2 translation (from Tarteel.com — same version as quran.com)

🐛 Bug Fixes

• Fixed download failures for certain mp3quran recitations
• Fixed several ffmpeg/ffprobe issues for macOS users
• Fixed a bug where the video background did not fully cover the exported video
  (black borders were appearing on the sides)
• Removed a duplicated reciter name (Saad Al-Ghamdi)

🤖 Quran Caption v3.3.3 — AI Translation Improvements & Stability

✨ Improvements

🧠 AI Translation

• Rewrote the AI translation prompt with stricter rules and deterministic tie-breakers.
  → Improves consistency and accuracy, especially when resuming a sentence in the middle of a verse.

🖥️ UI & Stability

• Added a max-height constraint to the auto-segmentation modal to prevent it from overflowing the screen.
• Errors occurring during Python dependency downloads are now sent to PostHog for better debugging and faster issue resolution.

🧹 Cleanup

• Removed the unused local WBW (word-by-word) feature.
  → This simplifies the setup and prevents Python package installation issues for some users.

🎨 Quran Caption v3.3.2 — Keyboard-First Editing & UI Improvements

This update focuses on reducing mouse usage when reviewing subtitled videos, making the workflow faster and more keyboard-driven.

✨ New Features

• Added a new shortcut N
  • Similar to M, but instead of setting the end of the current subtitle to the cursor position, it sets the start of the current subtitle to the cursor position.

⌨️ Subtitle Editing Workflow Improvements

• Fast subtitle type switching while editing:

  • When editing a subtitle, pressing S, I, or B will instantly convert the current subtitle into:
    • Silence
    • Istiʿādha
    • Basmala
  • If words are selected and Enter is pressed, the subtitle is converted into a verse or partial verse.

• Improved D shortcut behavior:

  • After splitting a subtitle, the left clip is edited first, then the right clip automatically enters edit mode.
  • The D shortcut now works on any subtitle clip, including silence, basmala, and istiʿādha clips.

🎨 Themes & Appearance (ft. @Himmy504)

• Fixed an issue where the selected theme did not persist between sessions.
• Added a theme intensity slider, allowing fine control over theme colors.
• Replaced the Industrial Steel theme with Inverted Minimalist Zen.
• Themes are now grouped into three categories:
  • Light
  • Sepia
  • Dark
• Simplified theme names for better clarity.

🧩 UI Improvements

• Added skeleton loaders during project loading for a smoother visual experience.

🐛 Bug Fixes

• Fixed an issue where a subtitle could be unexpectedly selected after resizing it with the mouse.

🚀 Quran Caption v3.3.1 — Performance, Waveforms & Workflow Improvements

This update focuses on performance, editing workflow, and audio handling, with major contributions from @sherifcodeur.
May Allah reward him greatly for his work.

🎨 UI & Customization (ft. @sherifcodeur)

• Added 9 built-in themes (dark, light, sepia, etc.), configurable from Settings.

📦 Export & Monitoring Improvements

• All exports (not only videos) are now listed in the Export Monitor.
• The file explorer no longer opens automatically after exports.
• Fixed multiple export issues on macOS and Linux.
• Added official support for macOS Intel builds.

🌊 Audio Waveform Improvements (ft. @sherifcodeur)

• Faster waveform generation for audio files.
• Waveforms are now cached across tabs, significantly improving performance.
• Added an option in Tools to force waveform regeneration when needed.

🤖 Automatic Segmentation Improvements

• Added a new option in the automatic segmentation modal:

  • You can now slightly extend subtitles before silence, allowing them to remain visible a bit longer on screen for better readability.

🎧 Subtitles & Timeline Enhancements (ft. @sherifcodeur)

• Clicking a subtitle in the subtitle list now automatically moves the timeline cursor to that subtitle.

• Added a filter to show only subtitles containing N words.

• Improved shortcut I:

  • Now scrolls the timeline back to the beginning and moves the cursor to start.

🤖 MP3Quran & Subtitle Automation (ft. @sherifcodeur)

• Added support for automatic subtitle timing from the MP3Quran API for supported reciters.

  • Subtitles can now be generated directly from official recitation timings.

🎬 Playback & Editing Stability

• Improved performance and crash prevention when changing playback speed while editing subtitles.
• Fixed a bug where the Settings modal could open multiple times if clicked rapidly.

📊 Analytics

• Fixed analytics configuration so telemetry data is now properly received.

🚀 Quran Caption v3.3.0 — Major Update

This is a major release, made possible thanks to the recent contributions of many brothers to the project. May Allah greatly reward them for their efforts and the work they have put into this software.

🌟 New Features

🤖 Automatic Video Segmentation (AI) (ft. @Hetchy)

• Automatic subtitle generation from video files using AI.

• Two available modes:

  • Cloud segmentation → fast but limited
  • Local segmentation → requires a good GPU, but fully offline

• Automatically subtitles your recitation in minutes.

• Segments that are uncertain or incomplete are clearly marked for manual review in the editor.

📁 Flexible Export Paths

• You can now choose custom export folders for:

  • Videos
  • Subtitles
  • YouTube chapters
  • Project data

🎧 Recitation Download & Asset Management (ft. @sherifcodeur)

• New section to download recitations directly from the app:

  • Any surah
  • From a wide selection of reciters

• Added the ability to re-download previously fetched assets (from YouTube or mp3quran) if they are missing from disk.

✂️ Subtitle & Timeline Enhancements

• New context menu option to split a subtitle at the cursor position (ft. @sherifcodeur).

• New shortcut D to split subtitles instantly (ft. @sherifcodeur).

• New shortcut I to jump back to the start of the video (ft. @sherifcodeur).

• Improved shortcut behavior:

  • M (set end of subtitle to cursor):

    • Works anywhere as long as a subtitle is under the cursor.
    • Otherwise applies to the last added subtitle.

  • E (edit current subtitle):

    • Same improved behavior as above.

• In the Subtitles Editor, the currently playing subtitle is now automatically highlighted and scrolled into view.

• Added two navigation buttons next to Play/Pause to move between subtitles more easily.

🛠️ Audio Tools (ft. @sherifcodeur)

• Added two tools accessible from the Tools icon in the header:

  • Trim an audio file directly inside the app.
  • Shift all subtitles of a project by a given offset.

🐛 Bug Fixes

• Fixed a delay when clicking “Open Asset Directory” before the file explorer opened (ft. @sherifcodeur).
• Fixed video export issues on macOS and Linux (ft. @ismael333).
• Fixed a bug where the context menu remained stuck on screen when switching tabs (ft. @sherifcodeur).
• Fixed a font rendering issue affecting verse 2:181.

📊 Analytics

• Added advanced internal analytics (developer-only):

  • Collects anonymized data such as included verses, export modes, etc.
  • Used strictly for analytical and improvement purposes.

✨ Quran Caption v3.2.7

🆕 New Features

• Added Backspace support to delete the currently selected subtitle ⌫
• Added “Enable Italic” option for text styling ✍️

🛠️ Quran Caption v3.2.6 — Stability & Custom Image Improvements

🛡️ Improvements

• Added protection against forbidden Windows path characters
  → You can no longer create a project if the project name or the reciter name contains characters not allowed by Windows, preventing export errors.

🎨 Custom Image Enhancements

• Added opacity control for custom images.
• Added “above overlay” option: choose whether the custom image should appear above or below the background overlay.

🎬 Export Improvements

• Reduced the gap between concatenated videos, making transitions much less noticeable during final export.

🚀 Quran Caption v3.2.5 — Official macOS & Linux Support

🧩 New Platform Support

• Official macOS and Linux support — thanks to brother @yshalsager for the contribution.
  → On macOS and Linux, you must have ffmpeg and ffprobe installed in your system PATH.

✨ Improvements

• Custom images are now rendered beneath the text, ensuring proper layering and readability.

🛠️ Quran Caption v3.2.4 — Bug Fixes

🐛 Fixes

• Fixed the calculation of start and end word indexes when fetching subtitles from QC2 projects.
• The subtitle background is now always displayed, even during silence segments.

🛠️ Quran Caption v3.2.3 — Stability Update

🔧 Changes

• 🧩 Removed the predefined styles feature temporarily due to stability issues.
  → It may be reintroduced in a future update after further improvements.

🐛 Bug Fixes

• Fixed Chromium’s download manager not appearing correctly.
• 🎞️ Updated YT-DLP to the latest version — fixes the issue preventing online video downloads.

🚀 Quran Caption v3.2.2 — Predefined Styles & Quality-of-Life Updates

✨ New Features

• Predefined Styles Management 🎨

  • You can now create, apply, and delete predefined styles within your project.
  • When creating a new project, you can choose to copy a style from an existing project directly from the creation modal.
  • Multiple styles can be saved and selected between sessions — your choice persists automatically.

• New Help Video Integration 🎥

  • The new tutorial video is now accessible from two key places:

    • When hovering over the question mark icon in the Subtitles Editor tab.
    • When clicking the question mark icon in the title bar.

• Translation Filters Update 🔍

  • Added two new filter buttons in the Translations tab:

    • Show All → enables all filters.
    • Show Fetched → shows only fetched verses.

🧩 Fixes & Improvements

• YouTube Subtitle Sync Fix ⏱️

  • Fixed subtitle sync issues in exported YouTube captions — timing now correctly accounts for the currently selected segment in the timeline.

🚀 Quran Caption v3.2.0 — New Features & Improvements

✨ New Features

• Added recent translations list — translations used in the last 10 opened projects are now displayed at the top for quick selection.
• Added a Play/Pause button in the Subtitles Editor, located at the top-right of the video preview 🎬
• Press Escape to cancel subtitle editing instantly ⌨️
• Added Wolof Translation

🔧 Improvements

• Translation fetches from older projects now attempt to restore word indices, even from QC1 projects, instead of defaulting to brute force.
• Holding CTRL while clicking the Fetch button will now only fetch translations from QC2 projects.
• Updated the color of the "To Translate" status to be slightly darker for better differentiation from "To Caption".

🛠️ Quran Caption v3.1.9 — Bug Fix Release

🐛 Bug Fixes

• Fixed an issue that prevented certain videos from being exported successfully 🎥
• Corrected the Spanish translation Muhammad Isa Garcia which was missing punctuation marks ✍️

⚠️ Quran Caption v3.1.8 — Important Update

This update is highly recommended for all users, as it fixes major issues that caused timing offsets in long videos.

✨ New Features

• Added a search filter in the Translations tab 🔍
  → Quickly find any translation without scrolling through the entire list.

🐛 Bug Fixes

• Fixed a major bug causing offsets in long videos ⏱️
  → Ensures subtitle timing is accurate during export.
• Fixed background blur style not being applied on exported videos 🎨
  → Now both video and image backgrounds can have a blur effect.
• Fixed YouTube chapter formatting per verse
  → Previously, timings were mixed up due to the ss:vv format.

Quran Caption v3.1.7

✨ New Features

• Added fade effect to verse numbers: they now appear and disappear along with the subtitle (important for proper video export).
• Added instructions in the Export Monitor for the "Cannot allocate memory" error. Users will now see direct guidance (e.g., lowering chunk size) without needing to ask on Discord.
• Added software version tracking in telemetry, making it easier to identify which version users report bugs from.
• Added Spanish translation (Muhammad Isa Garcia) with punctuation, based on user requests.

🐛 Bug Fixes

• Fixed all issues related to surah numbers:

  • Exporting a video with multiple surahs and surah calligraphy enabled no longer causes rendering bugs.
  • Fixed multiple related bugs with multi-surah exports.

Quran Caption v3.1.6

✨ Improvements

• Changed the "Set End To Previous" shortcut (default X) to "Set Start To Previous", making it more logical and practical.
• Added progressive text shrinking to automatically choose the best font size for phone videos.

🐛 Bug Fixes

• Fixed a visual glitch in the subtitle list inside the Subtitles Editor.
• Fixed an issue where the video cursor kept playing without being able to pause when no video/audio was loaded.
• Fixed a bug where setting max-height with top or bottom text alignment caused the text to shrink infinitely.

Quran Caption v3.1.5

🚀 New Features

• Discord Presence integration: A simple yet powerful way to promote Quran Caption just by using it!
  Your Discord status will now display the project you are currently working on.

🐛 Bug Fixes

• Fixed an issue where the "Show Arabic" toggle on the surah name had no effect.
• Fixed an error message that appeared when editing an individual subtitle.
• Fixed several minor bugs.
• Fixed an issue where the video preview no longer appeared in the Subtitles Editor.

🐧 Linux & 🍎 macOS

• Fixed an issue where Tauri did not have access to assets.
• Fixed a bug where FFMPEG/FFPROBE was not detected by YT-DLP.
• Fixed a bug where FFMPEG/FFPROBE was not found during video export due to the working directory.
• Fixed a crash when exporting videos with images having different FPS on Linux.

📦 Improvements

• Added the license file (Attribution-NonCommercial 4.0 International).
• Added metadata in cargo.toml so the software no longer needs to be uninstalled before updating, and Windows now shows the correct description of the app.

🚀 Quran Caption v3.1.4

✨ New Features

• Added a new type of custom clip: custom images 🖼️
  → You can now display your logo or any image on the video, just like custom text.
• Added horizontal drag support in the video preview 🎯
  → Move texts, images, and other elements directly with your cursor (both vertically & horizontally), without relying only on sliders.

⚙️ Improvements

• Added the option to use a custom chunk size during export 🧩
  → Useful for PCs with limited RAM to prevent crashes and optimize performance.
• Export monitor now includes logs displayed directly in the panel, along with the file path to the log 🪵
  → Makes debugging faster and more accessible.

🚀 Quran Caption v3.1.3

✨ New Features

• Added Neon effect for subtitles, similar to Glow but with a more vibrant style.

• Subtitles list panel added to the right side of the Subtitles Editor:

  • Displays all subtitles of the video.
  • Allows direct editing by clicking on a subtitle from the list.

🛠️ Improvements

• Complete redesign of the AI-assisted translation prompt → now shorter and produces near-perfect results.
• Screenshot capturing during export optimized to avoid redundancy, making the first part of video export twice as fast.

🐛 Fixes

• Fixed an issue where some translations were placed under the wrong edition in the Translation Editor.
• Fixed a bug where the AI omitted punctuation marks when trimming translations.
• Fixed crashes caused by certain background videos during export.

🚀 Quran Caption v3.1.2

✨ New Features

• Added <min-range> and <max-range> tags to customize "Latin Surah Name" or "Verse Number" text, allowing display of the verse range for the selected export segment. Great for TikTok format !

• Translation page redesigned:

  • Subtitles are now grouped by verse when multiple subtitles belong to the same verse.
  • If a subtitle requires review and is in a group, the entire group is displayed.

🛠️ Improvements

• Export performance optimized: ensures the subtitle is fully displayed for frame capture, taking only the necessary time instead of an arbitrary duration.
• Elements hidden on-screen while anti-collision and max-height adjustments are in progress to prevent visual jumps.
• Automatic duplication of translations when the same subtitle occurs consecutively N times.
• Start and end positions of the previous subtitle’s translation are only set if it is not brute force.

🐛 Fixes

• Fixed a bug where the verse number of the translation was incorrectly displayed when "Verse Number Position" is set to after.
• Temporary video image folder is now properly deleted when export is canceled.
• Fixed fade durations: exported video fades now match the preview.
• Fixed a bug where subtitles in the Translation tab did not refresh properly when hiding/showing an edition.

🚀 Quran Caption v3.1.1

✨ Improvements

• Added shortcut T in the subtitle editor → quickly insert a custom text between the last subtitle and the current cursor position.

• New font for Surah names, fixing the glow effect issue.

• Automatic codec selection for Intel PCs:

  • If available → NVENC is used.
  • Otherwise → fallback to libx264.

• After updating a subtitle, the next word is now automatically selected, making editing faster.

🐛 Fixes

• Fixed a bug where the wrong translation could appear under a subtitle in the Translation tab.
• Fixed an issue where the English word-by-word translation of the current subtitle was displayed incorrectly.
• Translation editor: clicking on a selected word now trims the translation to end at that word. Clicking again resets the start cursor on it.

I am pleased to announce, after months of hard work, that Quran Caption 3 is now officially available to the public.

With its brand-new interface, refined algorithms, and hundreds of customization options, Quran Caption 3 makes it simple and fast to create unique Quran recitation videos — easily shareable on platforms like YouTube, TikTok, and Instagram.

Quran Caption is the result of countless hours of coding, debugging, and testing — but above all, it is the fruit of the continuous support and collaboration of the Discord community. I sincerely thank everyone who helped bring this project to life, and I pray that Allah grants them ḥasanāt for every video generated and viewed through this software.

🌙 Don’t wait any longer — download Quran Caption 3 today!

Official website: https://qurancaption.com
Discord server: https://discord.gg/Hxfqq2QA2J
YouTube Channel: @qurancaption

Bug fix
Using a new API to retrieve word-by-word English translations or phonetics of the Quran.

✨ New Features

• 🧠 Smart subtitle collision protection: When multiple subtitles overlap, the lowest one now shifts downward automatically to avoid collisions.
  🔁 This feature is disabled if "Fit in one line" is enabled — you can use one or the other, not both.
• 🔧 Custom line spacing: You can now fine-tune the vertical spacing between lines in your subtitles for better readability and style.

🐛 Bug Fixes

• ✍️ Fixed an issue where custom text could not be added.
• 📝 Fixed a bug where the project name wasn’t properly updated during renaming.
• 🌍 Fixed an export issue affecting projects that used non-Latin characters in asset or project names.

💡 Enhancement

• 🚨 Error messages are now shown in dialog boxes to ensure they're clearly visible and easy to understand.

Patch Notes

New Features:

• Added a feature to the export page that allows exporting one video per ayah.
• Added Saeed Sato translation to the available translations.
• Added an option in the export page to force vertical format, even if the video is originally horizontal (adds black bands to top and bottom).

Bug Fixes:

• Fixed a bug on small-screen devices that made some buttons unreachable.
• Fixed a bug displaying background videos during export in portrait mode.
• Fixed a bug with qpc v2 font format.
• Fixed a bug when importing vertical videos.

Enhancements:

• Added warning messages when multiple audio or video clips are added, informing the user that only the first one will be used.
• Added more explicit warning messages throughout the application.

Small update to finalize the issues of v4.4:

• I'm permanently removing the watermark from exported videos.
• Switching the AI to Gemini, currently the best for the tasks required.
• Fixing and preventing bugs related to excessively long file names.
• Resolving a bug in export when the audio is shorter than the video subtitles.

I am thrilled to introduce the latest version of Quran Caption, bringing you a host of new features, enhancements, and bug fixes to make your video creation process smoother and more efficient!

Major Updates

Integrated Video Export 🎥

• Say goodbye to external tools! You can now export your videos directly from Quran Caption using the new "Export" tab. Explore a range of parameters and customization options to perfect your final video. ✨

Portrait Mode Support 📱

• Tailor your videos for social media platforms like TikTok and Instagram by selecting the portrait mode option in your global video settings or export settings. 🌟

Enhanced AI-Assisted Translation 🤖

• Translate all your project's subtitles with improved accuracy using AI. Find the "AI Translation" button next to each edition name in the upper part of the "Translations" page. 💬

Resolved Layout Issues 🖥️

• Enjoy consistent video layouts regardless of your screen size or window mode. All videos are now standardized to 16:9 (or 9:16 for portrait), ensuring elements are correctly positioned without any scaling or shifting issues, even when importing portrait-format videos. 📏

Performance Boost ⚡

• Experience smoother performance even when handling lengthy audio or video files, with no more lags or slowdowns. 🚀

New Features

• Background Video Translation Y Parameter : Fine-tune the vertical positioning of your background video for optimal visual alignment.
• Quick Speed Control : Use the PageUp and PageDown keys to instantly set your video to 2x speed from any page.
• Default Download Folder : A default directory is now defined for downloading YouTube audio and video.
• Favorite Translations : Access your favorite translations more easily on the translation addition page.

Bug Fixes 🐞

• Corrected the display of verse ranges on the home page.
• Fixed the context menu issue in the timeline, ensuring it appears correctly on the second right-click on a clip.
• Ensured that missing assets can be re-downloaded from YouTube without hindrance.
• Resolved the word-by-word translation display issue for verses beyond number 114 in longer surahs.

We hope these updates enhance your Quran Caption experience. Thank you for your continued support and feedback! 🙌

✨ New Features & Enhancements

📚 Expanded Text Support

Quran Caption now supports a broader range of content beyond Quranic text. You can add matn, sharh, mukhtasar, poetry, qasidah, and more. Users can also customize how these texts are displayed on screen through new configuration options available in the subtitle language settings.

🤖 AI-Assisted Text Import

An integrated AI feature now simplifies the process of importing texts with translations. Simply paste your content — such as a poem alongside its translation — and the software will automatically segment and format the verses with their corresponding translations.

🖼 User Interface Improvements

• The source of surah name images has been updated to provide a more polished and visually appealing experience.
• New fullscreen control buttons have been added, allowing users to toggle fullscreen mode without relying on the F11 key (use the Escape key to exit).

🧾 Subtitle System Updates

• The QPCV2 format is now supported for Arabic text export in subtitles.
• A new keyboard shortcut (C) has been introduced in the Subtitles Editor to quickly select text from the current cursor position to the end of the verse.
• The Saheeh International English translation has been added as a selectable option.

🐞 Bug Fixes

• Resolved several macOS-related issues, particularly those affecting file path detection. Quran Caption should now run correctly on macOS systems.
• Fixed a bug preventing video or audio files with uppercase extensions (e.g., .MP4) from being added.
• Addressed an issue where keyboard inputs were not recognized when Caps Lock was enabled.

🔮 Coming Soon

A new video export feature is currently under development, which would allow users to generate final video outputs directly from Quran Caption — without relying on OBS. This will be compatible with projects that use a flat background (image or solid color), which represents a majority of typical use cases. I am actively working to make this functionality available in a future update.

✨ New Video Customization Option

You can now display the name of the Surah being recited in the video — in Arabic and (optionally) in Latin characters.
This option is available in the general video settings.

🎨 New App Icon

The software now has a brand-new identity. If you already had it installed, the new icon might take some time to update depending on your system.

🤖 AI-Powered Auto-Translation Option

A new button has been added to the Translations tab that lets the AI help you complete partial verse translations.
It works by using an existing translation you've already added and trimming it to match the correct Arabic segment — the AI does not generate new translations by itself.

🐞 Bug Fixes

• Fixed a bug that prevented renaming projects
• Minor bug fixes and stability improvements

Added support for MacOS.

Minor bugs fixed.

Bug fixes:

• Fixed an issue where users were unable to play the video or move the cursor after it went beyond the audio/video timeline boundaries.
• Corrected a bug in four translations where punctuation marks were not displayed:
  • English: Dr. Mustafa Khattab (The Clear Quran - Allah edition)
  • French: Muhammad Hamidullah (the first one)
  • Italian: Hamza Roberto Piccardo
  • Indonesian: Sofian S. Siregar

Bug fix :

• Fixed a problem that caused Arabic text styles to no longer import when importing a style file.

Metadata files added

New features:

• Can now select the maximum number of lines to be displayed in the Make text fit in N lines option.
• Added colors to different statuses
• Sort settings are saved when leaving and returning to home page

Bug fixes

• Migration was not performed correctly with the new options and the import of the existing subtitle options file.
• Existing translations will now be fetched only if it's exactly the same translation reference, not just the language that matches.

New Features:

• Added a button to temporarily speed up the video. By default, this feature is activated using the PageDown and PageUp keys. Hold them down to play the video or audio at double speed.
• Implemented automatic saving: the project will now be saved every 10 seconds.
• Added a new global subtitle customization option, allowing a glowing effect to be applied to all subtitles at once.
• Introduced a checkbox in the language-specific customization settings that automatically adjusts text size to fit within a chosen number of lines (N lines) by scaling the font size accordingly.

Bug Fixes:

• Fixed an issue where the current video speed was not displayed correctly.
• Resolved other minor bugs.

Add a button to filter and order projects on the home page.

It is now possible to order your projects according to :

• Date of last update
• Creation date
• Project name
• Duration

And filter them by status (to be exported, translated, ...)

Complete Rework of the Home Page

• Linear project layout
• Addition of important information on the homepage (percentage of captioning, percentage of translation, verses present in the project, the reciter's name...)
• Added status for each project (To caption, to translate, to record...)

New Feature:

• Addition of a progress bar for translated subtitles/total subtitles

Bug fixes:

• Corrected an incorrectly encoded character in verse 2:129.

New features:

• Added a separation between each verse instead of between each subtitle on the translation edit page.
• Added a button to re-download assets from YouTube if they have been deleted.

New feature :
Add a parameter in the video's general settings to display a subscription button at a certain time and place.

Bug fix :
Fixed a bug preventing old projects from opening correctly.

Bug fix :
Fixed a bug that displayed a glow effect on subtitles that didn't have one.

Bug fixes :
Fixed a bug that caused the software to freeze when editing the individual style of a subtitle in certain cases.
Changed the way individual subtitles are managed.

Note :
The problem of glow stopping abruptly when switching from a subtitle with effect to a subtitle without effect persists. If anyone has any ideas on how to counter this, please let me know.

Major Update! V2.9 🎉

🚀 New Features:

• Edit Validated Subtitles:
  You can now edit a validated subtitle directly by clicking on it in the timeline on the subtitle editing page or by clicking the "Edit Subtitle" button.

• Custom Styling for Subtitles:
  Each subtitle can now have individual customization options, including:

  • A glowing effect with adjustable intensity and color.
  • Bold, italic, or underlined text styling.
    These options are available through the Individual Subtitle Settings dropdown item or via the context menu.

• Context Menu:
  Right-clicking a subtitle in the timeline on the Video Editor page now opens a context menu with useful options.

• Precise Cursor Placement:
  Clicking a subtitle on the timeline places the cursor as close as possible to the beginning of that subtitle.

• Subtitle Audio Playback:
  Play a subtitle's audio by clicking the play button next to it.

• Improved Performance Shortcut:
  The Best Performance mode is now activated with F1 (previously F6).

• Direct Navigation via Time Stamps:
  Clicking on displayed time durations in the pages navigates you directly to the selected time.

• Multiline Creator Text:
  The Creator Text field now supports multiline text.

• New Shortcuts for Easier Subtitle Editing:

  • E: Edit the last added subtitle.
  • R: Set the index of the first selected word to match the last one.
  • M: Change the end of the last added subtitle to the current cursor position.

• Subtitle Progress Indicator:
  A percentage indicator now shows how much of the video has been subtitled, visible in the Subtitles Editor page.

• New Project Storage Method:
  Previously, projects were stored using localStorage, which had a size limit of 5MB. Now, projects are saved as physical files in the localStorage folder. This removes size restrictions, allowing you to manage an unlimited number of projects.

🐞 Bug Fixes:

• Smooth Timeline Scrolling:
  The timeline now scrolls automatically to follow the cursor, regardless of zoom level, when the video is playing.

• Improved Handling of Long Recitations:
  Fewer bugs on long recitations by limiting the number of divs generated for the timeline.

Developing this software takes a lot of time and effort. If you enjoy using it, consider making a donation to support my work! ❤️

Bug fix :

• Corrected a bug where transliteration was not displayed correctly

New feature :

• Ability to change video speed while editing subtitles

Added telemetry and different colors for subtitles in the timeline.

If you have version 2.6, this update is mandatory. There are some bugs in version 2.6. Sorry for the inconvenience.

New feature :

• Added option to add custom text, such as to warn of a recitation error
  Press t to add a clip with custom text in the subtitle editor.
• Updated yt-dlp.exe

New Feature:

• Added a button in the Subtitles Editor to show the transliteration below each Arabic word of a verse.

Minor Changes:

• Added the online documentation link in various places.
• Updated the OBS recording instructions.
• Added tooltips to the four buttons in the main header.

The API used to retrieve the word-for-word translation of the verses has been modified, changing the word separator to two horizontal bars.
I've modified the code accordingly to solve the problem of incorrect translations.

Added an export option for youtube chapters on the export page.
The generated file looks like this :

00:00:00 - An-Naba
00:04:19 - An-Nazi'at
00:07:52 - 'Abasa
00:10:56 - At-Takwir
00:12:55 - Al-Infitar
00:14:32 - Al-Mutaffifin
00:18:45 - Al-Inshiqaq
00:21:20 - Al-Buruj
00:23:37 - At-Tariq

Bug Fix: Unable to Save After Your Projects Reach a Certain Storage Size

I have completely changed the way projects are stored to offer unlimited storage capacity. Previously, projects were limited to a total of 10 megabytes due to localstorage constraints.

Fixed bugs :

• Fixed bug with the audio track containing a black video clip.
• Fixed bug with relocating audio asset.
• Fixed timeline total duration.

New feature:
Added a button on the export page to export your project's subtitles in SRT, VTT, and JSON formats.

Bug fix:
Fixed a bug where downloading audio from a youtube link would not work if the client did not have ffmpeg installed on his machine.

Bug fix :

• Fixed a bug that caused justified text too small to be on two lines to end up in the middle rather than left/right.

New features :

• Added a “Check for collision” button at the end of the subtitle settings, which will check whether, with the current settings, two subtitles will collide.
• Added a new option when clicking on the name of an added translation to see if you want to reset its texts.
• When adding a new translation, the software automatically searches other projects to see if the translation has already been written, thus saving time for the user.

Bugs fixed:

• Fixed a bug that prevented the preview from playing when no video was in the Background video track.
• Fixed a bug that did not display the background image correctly.
• Fixed a bug that displayed the wrong message when activating “High performance” mode
• Fixed a bug that would not display an image added to the Background Video track.

Bug fix:

• Fix all previous synchronization issues. Be sure to import video and audio with a constant bitrate (CBR)!

New feature:

• Added Best Performance mode by pressing F6. This mode will hide resource-intensive elements in the timeline, allowing you to concentrate on subtitle selection.

Bug Fix:
Fixed a bug that caused some manually completed subtitles to be reset.

New Feature:
Added an alignment parameter for subtitles with the following options: start, center, end, and justify.

Changes:
The left and right arrow keys will now move forward/backward by two seconds instead of three.

Bug fix :

• Fixed a bug that caused subtitles to display incorrectly when there was only one background image.

New feature :

• Addition of a search bar on the main page, to search for a project by name

Reinitizing subtitle translations:
When you reinitialize a translation of a subtitle trimmed by the software, it's because the software initially trimmed it incorrectly. As a result, all translations of the same verse following this subtitle will also be reinitialized.

Image as background :
Added an option in the global subtitle settings, under the Subtitle Background section, to set an image as background.

Bug fix:
Fixed a bug that prevented subtitles from being displayed if there was no video or image in the background.

Name of backup file:
The name of the generated backup file now also includes the backup date.

Add assets from youtube:

• Add a button in the Assets Manager tab to download a video or audio file from youtube and import it directly into the project.

Features:

• Audio can be played even if there is no video in the Video Track (a black screen will be displayed, which can be modified from the general Background settings).

Bug fixes:

• Fixed a bug that caused the player to behave strangely when an asset used in the timeline was deleted from the Assets Manager tab.
• The continuity of the first two videos seems to work, but not beyond. Use at your own risk!

General :

• Display release notes when one is available
• The basic duration of an image is 2 hours. It is not yet possible to switch between different visual elements when the video is playing.

Asset :

• When a video, sound or image has been moved, the asset will appear in the timeline with a small warning symbol.
• A button in the Assets Manager tab has been added to relocate the asset.

Bug fix:

• Fixed a bug where images were not displayed when added to the timeline.

Fixed Backup:

• Corrected the backup restoration process to replace projects correctly.

New features in Translations Editor:

• Added a button to automatically trim subtitles based on work already completed in other projects.
• Changed checkboxes to radio buttons in the translation parameters, and introduced more explicit names.
• Added a radio button in the translation parameters to display only subtitles that have never been modified and require modification.
• Added a new background colour for translations, red, to indicate that a translation needs to be reviewed and has not yet been reviewed.

Backup and restore all your projects :

• Added two buttons on the main menu to export all your projects to a file in .qcb format, and another button to import this file and restore all the projects in it.

Option of displaying word-by-word translations of verse words in the subtitle editor :

• Added a checkbox in the bottom left-hand corner of the word selector to display the English translation of each Arabic word in the verse.

Add a button to rename a project :
On the main menu, when hovering over a project, a button represented by a pen has been added. When pressed, a dialog box asks for the project's new name.

• Some bug fixes
• The scroll position in the timeline is saved when you navigate between tabs

New hotkey:

• Added v key to select entire verse in word selector

Bug fixes:

• Fixed a bug where automatic scrolling was too slow
• Fixed a bug that prevented the code from finding the word-by-word translation in the API's JSON response
• Fixed a bug where automatic translations would not work in some cases
• More...

Project name change:
Change of project name from QuranCaption 2 to Quran Caption. Few of you actually knew the first version, so mentioning that it's a V2 isn't necessary.

Fix auto-scroll problem:
I hadn't taken the timelime zoom into account when calculating the automatic scrolling of the timelime when the video plays. From now on, the position of the cursor when the video is playing and the scrolling of the timeline work correctly.

Automatic translation features:
When you edit an existing translation because the narrator has only pronounced certain words in a verse and not the whole verse, the translation of the following verses will be automatic to make your work easier. Please note that pressing Enter after trimming your first translation is necessary for trimming to take place. Similarly, when you crop a translation and the same words are repeated in the next subtitle, the translation will be duplicated. You can always go back using the button to the right of the input.

And more:

• As OBS takes a little time to start recording, a 700ms waiting time has been added after pressing CTRL+K to play the video, to synchronize the start of recording with the start of the video.
• Bug fixes

Full Changelog: v0.3...v0.4

Improved synchronization during playback:
Cursor position is now defined by the moment of the video, and is not calculated manually. This used to cause delays between subtitle display and video sound.

Subtitle display correction:
The text is now trimed

Full-Screen Preview:
From the video editing page, and also from the Export page, the Full Screen Preview mode can be accessed by pressing F11.

Automatic timeline scrolling:
When the video preview is playing, the timeline will automatically advance to leave the cursor in the same place.

And more:

• Added the ability to scroll in the timeline to access a key moment in the video on the export page.
• Color changes for certain elements
• The playback bar is hidden in full-screen mode in the export page.
• Bug fixes

Full Changelog: v0.2...v0.3

v0.2 is already here!

Credits added:

• Added my credits to the homepage, and a way to make donations.

Improved synchronization:

• The previous method caused subtitles to be delayed in relation to the video. Now, they are perfectly synchronized as the user places them.

Home page improvement:

• Added some new styles to the homepage. The most recently opened projects now show up first.

Bug fixes:

• Requests wouldn’t work because of Tauri’s security settings. Fixed many other minor bugs.

Full Changelog: v0.1...v0.2

V0.1 - New Version!

• Update Notifier:
  When a new version of QuranCaption 2 is released, you will be notified when the software is launched.

• Export Subtitles Settings:
  Two buttons have been added to the Subtitle settings tab, allowing you to export and import subtitles, so you don't have to redo them every time. Import does not take into account the ID of the translation, only its language. Therefore, it is not necessary to have chosen the same translation for the import to work.

• Show Verse Number:
  Adds an option in the subtitle settings to display the verse number in the subtitles on the video, whether in Arabic or for translations.

• Bug Fixes

Full Changelog: first-release...v0.1

It's finally here!

The first version of QuranCaption 2 is now available to the general public!

May Allah accept our work and bless all those who use, watch, or listen to the videos it generates.