Quran Caption v3.6.71

This major update adds seven new Quran riwayat, expands batch processing with AI-powered actions, introduces meaning-aware subtitle splitting, improves video transitions, and adds more flexible export range selection.

Quran Riwayat

• Added seven KFGQPC riwayat with their dedicated Quran text, fonts, mappings, and verse numbering:

  • Warsh
  • Qalun
  • Shu'bah
  • Duri
  • Susi
  • Bazzi
  • Qunbul

  They can now be selected directly from Arabic → Riwayah.

  Quran Caption can therefore render projects using the proper text and typography for each supported riwayah instead of relying only on the default Hafs text.

i.e., in Warsh, verse 7 of Al-Fatiha is considered two separate verses.

AI Subtitle Splitting

• Added meaning-aware AI subtitle splitting

  Subtitles exceeding a selected word limit can now be split using AI while trying to preserve meaningful phrases instead of cutting purely based on word count.

Batch Processing

• AI subtitle splitting and AI translation trimming can now be run across all projects in a batch.

• Added persistent statuses to batch cards

  Batches can now have statuses such as exported, to translate, etc., just like regular projects.

• Added homepage filters to display:

  • projects only
  • batches only
  • both

• Batch project navigation is now always available from the title bar, even when there is no remaining review step.

• The currently active editor tab is preserved when navigating between projects in a batch.

• Moved the Create Batch button above the project list for easier access.

• The QuranReflect panel is no longer shown after every individual video during batch export.

Video Transitions

• Improved crossfade editing directly from the timeline

  Video clips can now overlap when using a crossfade transition.

  The duration of each crossfade is automatically determined by the actual overlap between the two clips.

• Fixed video overlaps remaining when switching from Crossfade to Fade Through Black.

• Added clearer explanations for Crossfade and Fade Through Black behavior.

Timeline

• Added Y shortcut for quick subtitle merging

  Pressing Y toggles the nearest merge/split point around the timeline cursor.

Export

• Added verse-range selection for exports

  In addition to selecting an export range using timestamps, you can now select the start and end verses with a dual verse slider.

• Fixed exports at very small resolutions

  Quran Caption now automatically falls back to libx264 when the selected dimensions are below the minimum supported by H.264 NVENC.

• Verse numbers now remain visible between subtitle splits belonging to the same ayah instead of fading out and appearing again.

Translations

• Faster translation fetching from existing projects

  Source projects are now loaded concurrently and reused instead of being repeatedly loaded.

• Updated batch projects are now included when searching for reusable translations.

• Fetching translations from another project now only retrieves the translation text

  Individual word styles and WBW mappings from the source project are no longer copied unintentionally.

Quran Caption v3.6.62

This update improves manual subtitle creation, expands the QuranReflect workflow, adds in-app announcements, and improves analytics and small-screen usability.

Manual Subtitles

• Added persistent collapsible controls for manual captioning on desktop

  Users who do not know or use keyboard shortcuts can now add and edit subtitles directly through visible controls.

• Added help explanations for these manual controls

  More details are available through the help icon.

QuranReflect

• Added direct links after saving a reflection

  After successfully saving or publishing a reflection, Quran Caption now lets you directly open:

  • the saved Quran.com note
  • the published QuranReflect post

• Added a “Do not show again” option for the reflection pop-up

  Users can now permanently dismiss the reflection prompt if they do not want to see it again.

Announcements

• Added admin-managed launch messages

  Important announcements can now be displayed directly inside Quran Caption when the app starts.

Subtitles UI

• Fixed the surah picker remaining focused after selecting a surah.

• Fixed the ayah picker overflowing on narrow screens.

Analytics

• Expanded anonymous product analytics across desktop workflows, exports, AI features, and editing actions.

  This gives better insight into how Quran Caption is used while keeping collected data more limited and privacy-conscious.

Quran Caption v3.6.61

This update adds direct media trimming in the timeline, introduces post-export QuranReflect integration, and improves segmentation and onboarding behavior.

Timeline & Video Editing

• Added non-destructive media trimming directly from the timeline

  You can now trim video clips from the timeline itself without modifying the original media.

• Video and audio clips can now be moved freely within the timeline

• Fixed preview behavior so the video clears immediately when the cursor leaves all video clips

QuranReflect Integration

• Added post-export reflection workflow

  After exporting a video, Quran Caption can now prompt you to reflect on the verses you just worked with.

  You can then:

  • save the reflection privately as a note on Quran.com
  • publish it publicly on QuranReflect

• Removed Quran.com theme synchronization

AI Segmentation

• Subtitle replacement is now selected by default when running segmentation on a project that already contains subtitles

Onboarding

• Updated the desktop tutorial text to match the current editor controls.

Quran Caption v3.6.58

Hotfix

• Fixed recent FFmpeg export errors that could cause video exports to fail.

Quran Caption v3.6.57

This update adds a new recommended local AI segmenter, makes audio playback and seeking nearly instant, introduces subtitle re-alignment for new audio, and improves WBW editing and subtitle styling workflows.

AI Segmentation

• Added a new 100% local FastConformer segmenter (by an anonymous Brother -- don't forget him in your du'as)

  It provides very strong segmentation accuracy while running entirely locally.

• Added subtitle re-alignment to new audio

  When a project already contains subtitles, you can now choose between:

  • replacing the existing subtitles
  • re-aligning them to the new audio

  Re-alignment preserves existing translations and individual subtitle styles instead of forcing you to recreate them.

  This requires both audio files to contain the same recited verses and also handles repeated verses.

Preview & Playback

• Reworked audio playback using a persistent native Rodio player

  Playback and seeking are now nearly instant.

  Actions such as:

  • pressing Space to play/pause
  • seeking backward or forward

  no longer have the noticeable delay they had before.

Word-by-Word

• Added W shortcut

  Press W to refetch WBW timestamps for the subtitle currently under the timeline cursor.

• Fixed incorrect WBW translation highlighting after an em dash.

Subtitle Editing

• Added Delete shortcut

  Press Delete to remove the subtitle currently under the timeline cursor.

• Added per-subtitle font overrides

  You can now change the font of an individual subtitle without changing the font used by the rest of the project.

  This works with both QPC glyph and Uthmani text rendering.

Export

• Fixed FFmpeg padding failures when using very high background zoom values.

Tutorial

• Updated the tutorial project to demonstrate more commonly used features.

• Hidden the donation progress panel during onboarding to keep the tutorial interface cleaner.

Quran Caption v3.6.54

This update focuses on batch review reliability, export correctness, and better handling of repeated WBW references during segmentation.

Batch Processing

• Added a button to delete the project currently opened in the batch review workflow

• Project selections are now preserved correctly across the batch workflow

Export

• Fixed duplicated frame handling during export

  Quran Caption now uses the generated screenshot indexes as the duplication source, preventing incorrect frame reuse and export error.

Segmentation

• Improved subtitle splitting when WBW word references repeat

Quran Caption v3.6.53

This update introduces a major new overlay fade system, expands WBW visual effects, and improves batch import reliability, shortcuts, and YouTube integration.

Overlay Styles

• Added 11 new fade shapes for overlays

  You can now create much more advanced fade effects with:

  • multiple fade shapes
  • shape inversion
  • custom fade curves
  • adjustable softness
  • custom positioning
  • radial size controls

  These effects are supported consistently in both preview and video export.

Word-by-Word Styles

• Added a Persist Effect option for opacity and other compatible WBW effects

  Effects applied to the currently recited word can now remain visible after the word has been recited.

• Fixed current-word opacity for verse numbers

  When the final word of a subtitle is recited, the verse number now correctly receives the current-word opacity effect as well.

Batch Processing

• Batch names are now preserved when importing a CSV file

• Segmentation JSON imports now respect the project's saved silence and subtitle-extension settings

• Fixed a shortcut-related crash that could happen while recreating batches

Shortcuts

• Fixed cases where shortcut names and descriptions could appear empty because of missing production translations

  Quran Caption now falls back to the saved shortcut information when needed.

YouTube Integration

• Improved contrast and readability of the YouTube integration across themes.

Quran Caption v3.6.52

This update improves Quran Universal Audio downloads and WBW timestamp computation, adds direct YouTube uploads, restores compatibility with legacy styles, and introduces more control over video frame layering.

Video Frame

• Added Display Above Frame style option

  You can now choose whether on-screen elements should appear above the video frame border instead of being clipped or covered by it.

YouTube Upload

• Added direct YouTube upload

  Exported videos can now be uploaded to YouTube directly from Quran Caption.

Recitation Downloads (by @Hetchy)

• Major improvements to Quran Universal Audio downloads by @Hetchy

  Recitation downloads are now much more reliable, especially for large surahs and long recitations.

• Added real-time download progress

• Downloads now continue properly when switching tabs, projects, or unfocusing Quran Caption

• Identical recitations can now reuse previously downloaded audio instead of downloading it again

• Applying downloaded segmentation is now significantly faster, especially on long surahs

• Improved handling of full-surah downloads to better preserve recitation intros and endings

Word-by-Word Timing (by @Hetchy)

• Improved WBW timestamp computation by @Hetchy

  WBW computation now continues in the background when switching tabs or windows, with a notification when it finishes.

• Fixed WBW timestamp computation for subtitles created from multi-verse segments

  This fixes cases where some split subtitles could end up without WBW timings.

Batch Processing

• Cloud segmentation requests are now spaced by two minutes during batch processing

  This helps avoid sending too many segmentation requests at once.

Styles

• Fixed compatibility with legacy presets

  Older Quran Caption styles that stopped working after recent style system changes should now work correctly again.

Quran Caption v3.6.51

This update adds timeline volume control, advanced background media framing, rounded video frames, and several export and waveform improvements.

Audio

• Added timeline volume control

  You can now increase or decrease the final video volume directly from the timeline.

  Volume can be adjusted up to 200%.

Background Media

• Added advanced background media framing controls

  Enable Fill Frame in Video → General to unlock these controls.

  You can now:

  • fill the entire frame even when the media has a different aspect ratio
  • zoom in or out
  • reposition the media horizontally and vertically
  • fine-tune how the background fits inside the video

Video Frame

• Added rounded video frame styling

  You can now add large borders around the video on all sides and round the corners. You can also make the edges of the framed video to blend more smoothly.

Export

• Improved the default filename field

  The default filename is now automatically filled when the field receives focus, making it easier to edit before exporting.

Timeline

• Fixed an issue where audio waveforms would not always appear correctly in the timeline.

Quran Caption v3.6.40

This update expands the batch workflow, adds custom export skip ranges, improves export configuration, and introduces several subtitle and preview improvements.

Batch Workflow

• Added YouTube chapter export for batch projects

  You can now generate YouTube chapters directly for projects processed through the batch workflow.

• Added segmentation JSON import from CSV

  A segmentation JSON file from brother @Hetchy's Universal Quran Aligner can now be referenced directly inside the batch CSV. When provided, the project subtitles are imported automatically without requiring AI segmentation.

• Added a downloadable batch CSV template

  This makes it easier to prepare a correctly formatted file for batch project creation.

• Added batch subtitle JSON export

  Project subtitles can now be exported as JSON directly from the batch workflow.

• Added a dissolve batch action

• Fixed several cases where completed batch projects were incorrectly considered not ready.

Export

• Added custom skip ranges

  You can now define specific sections inside the selected export range that should be excluded from the final video.

  This is useful for removing unwanted silences, speech, mistakes, or other sections without modifying the project timeline.

• Added a customizable default video filename format

  The default export filename format can now be configured directly in the software settings.

• Made the export range summary more compact.

Subtitle Styles

• Added a new-line option for Arabic verse numbers

  When enabled, the verse number will always appear on a separate line after the Arabic text.

Preview

• Added a warning when subtitle anti-collision is enabled

  The warning explains possible side effects and provides suggestions for adjusting the layout.

  Once dismissed, it will remain permanently hidden.

Quran Caption v3.6.36

This update introduces batch project creation, faster AI translation workflows, improved WBW timestamp processing, new subtitle background styles, and several export and editor improvements.

Batch Import

• Added batch project creation from CSV

  You can now create and process a large number of projects through a single batch workflow.

  The batch system can:

  • create projects from the audio sources listed in the CSV
  • import audio automatically
  • run AI segmentation across all projects
  • fetch translations for all projects
  • run AI translation trimming in batch
  • apply a shared style to every video
  • apply a shared background to every project
  • review segmentation and translations while quickly navigating between projects

  This is especially useful for producing complete surah collections or large video series with a consistent visual style.

Word-by-Word Timing

• Optimized WBW timestamp requests (by @Hetchy)

  When recomputing timestamps for a single subtitle, Quran Caption now sends only the relevant section of the audio instead of the entire file.

  This makes timestamp alignment significantly faster and more efficient.

• Improved WBW updates when resizing silence clips

  Resizing a silence clip now refreshes the WBW timestamps of the adjacent subtitles.

AI Translation

• Added parallel batch processing with three workers

  Up to three AI translation tasks can now run at the same time during batch processing.

• Added reasoning display for supported reasoning models

  When a reasoning model is used, its reasoning output can now be displayed during processing.

• Fixed the default DeepSeek AI model.

Subtitle Styles

• Added per-line subtitle backgrounds

  Arabic and translation lines can now have their own background directly behind the text.

  The same style is also available for WBW highlighting, allowing the background to follow the currently recited word or line.

• Fixed repeated words not being highlighted again inside merged clips.

• Fixed the Surah name outline not appearing on Arabic text when the Latin name was disabled.

• Style subnavigation now restores the previously active nested category.

Export

• Preserved background quality when using the Balanced performance profile.

• Added progress display for static background processing

  Progress now correctly moves from 0% to 100% instead of remaining stuck at 0% when video looping is enabled.

• Skipped unnecessary background looping when it is not required.

• YouTube chapters now remain aligned with recitation-only cuts.

Quran Caption v3.6.21

This update improves subtitle import, project navigation, style organization, and asset workflow.

Subtitles

• Added drag-and-drop support for Aligner JSON files

  You can now drop a JSON file from Hetchy’s Universal Quran Aligner directly into the Subtitles tab to apply its subtitles to the project.

Home

• Added collapsible project explorer

  The homepage now includes a button to collapse or expand the project explorer.

  This gives more room to the project list when needed.

Styles

• Added on-screen element subnavigation

  Style sections are now better organized with subcategories for elements such as:

  • surah name
  • reciter name
  • verse number
  • Ayah container

  This makes the style editor easier to navigate.

• Custom elements are now labeled from their content

  This makes it easier to identify which custom element you are editing.

• Added custom element subnavigation

  Custom text and custom elements now have clearer navigation inside the style editor.

• Moved shadow effects into Visual Effects

  Shadow-related settings are now grouped in a more logical place.

• Shared vertical text alignment controls

  Vertical alignment controls are now reused more consistently across style sections.

Assets

• Improved audio asset workflow

  Audio files are now added directly to the timeline instead of opening a context menu with only one option.

Quran Caption v3.6.20

This update adds recitation-only video export, improves asset management in the video editor, and fixes several modal layering issues.

Export

• Added recitation-only video export

  A new option is available in Export → Advanced Settings.

  When enabled, Quran Caption exports only the Quran recitation parts of the project and skips non-recitation sections such as:

  • takbir
  • taslim
  • long silences

  This is especially useful when working with recordings from salah, where the audio may contain parts outside of the actual Quran recitation.

Project Assets

• Reworked the project assets section in the video editor

  The assets UI is now cleaner and easier to use.

• Added the ability to add multiple assets to the timeline at once

  You can now select multiple assets using:

  • Ctrl + Left Click
  • Select All

  Then add them to the timeline together.

• Quran Caption now remembers your response to the dimension prompt

  If you already answered the prompt once, it will not ask you again unnecessarily.

Settings

• Fixed settings modal layering

  The settings modal now correctly appears above other dialogs.

AI Translation

• Fixed AI translation modal layering issue

  This fixes a z-index problem where a vertical bar could appear above the modal.

Quran Caption v3.6.14

Hotfix

• Fixed an issue introduced in v3.6.13 that prevented the update modal from working correctly

UI

• Improved WBW text contrast in light themes

  Word-by-Word text should now be easier to read when using a light theme.

Quran Caption v3.6.13

This update improves the style editor, adds resizable panels, adds local font importing with font previews, and fixes several export and preview issues.

Style Editor

• Fully reworked the video style editor UI

  The style interface is now much easier to navigate.

  Styles are now better organized into categories, unnecessary options are hidden when not needed, and assigning styles to your video should feel much clearer.

Editor Layout

• Added resizable panels and timeline

  You can now resize the main parts of the editor using the cursor, including:

  • left panel
  • right panel
  • timeline
  • editor sections across different tabs

  This makes it easier to adapt the interface to your screen size and preferred workflow.

Fonts

• Added local font file importing

  You can now import font files directly into Quran Caption, such as:

  • .ttf
  • .otf
  • other supported font formats

  This means you no longer need to install the font on your computer before using it in a project.

• Added font preview picker

  The font family selector now shows a preview of each font, making it easier to choose the right style visually.

Update Modal

• Added a blinking update icon in the title bar

  After closing the update modal, you can now reopen it from the title bar when an update is available.

Export

• Fixed Arabic subtitle export when using Plain Arabic Text

  Subtitle exports now correctly respect the selected Arabic format instead of always exporting glyphs.

Preview

• Fixed an issue where the timeline cursor could keep moving after pausing the preview.

Quran Caption v3.6.0

This update improves Word-by-Word styling, fixes several WBW rendering issues, and adds small workflow improvements for custom clips and images.

Word-by-Word Styling

• Added current word opacity style

  You can now control the opacity of the word currently being recited.

• Added custom CSS style for the current word

  This allows you to apply any custom CSS styling to the currently recited word, giving much more freedom for advanced WBW effects.

Word-by-Word Rendering

• Fixed an issue where some verses would not display when WBW highlighting was enabled

  Arabic WBW timings are now deduplicated properly before rendering.

• Fixed QPC glyph mapping for Surah 13, Verse 37

  This fixes an issue where glyphs could become misaligned from a certain word in the verse.

Export

• Added retry logic when frame capture fails because of a layout timeout

  This fixes cases where some subtitles were not captured properly during export after a temporary rendering failure.

Custom Clips and Styles

• Added the ability to delete custom clips directly from the Styles sections

  Custom text and custom clips can now be removed using a delete icon from their style section.

Timeline

• Fixed the label shown when removing a custom image

  It now correctly says Remove custom image instead of Remove custom text.

Quran Caption v3.5.93

Hotfix

• Reverted the export completion timing fix from v3.5.91

  The change was causing issues on macOS, so it has been reverted for now.

Hotfix

• Fixed an issue where some subtitles could be exported or displayed in the wrong order

Quran Caption v3.5.91

This update adds a new Minimal Quran mushaf, improves timed background containers, fixes export issues with “show only current word” mode, and improves stability around export performance settings.

Mushaf

• Added Minimal Quran mushaf

  This mushaf keeps the Arabic text but uses fewer vowels and symbols.

  It can be better suited for certain Arabic fonts where the fully detailed Quran text may be harder to render cleanly.

Word-by-Word Export

• Fixed export issues when using “show only current word” for Arabic WBW

  This fixes multiple problems that could happen during export, such as:

  • translation text being cut
  • styles not being preserved correctly
  • incorrect rendering behavior when exporting with this option enabled

Translations Editor

• Added Arabic verse number display at the end of each verse

  This makes it easier to identify and navigate verses while editing translations.

Background Containers

• Added timing support for background containers

  Background containers now have an “always show” style option, allowing them to appear or disappear only during specific parts of the video.

Export

• Export performance profile is now stored globally

  The default profile is now balanced instead of fastest.

• Fixed export completion timing

  Quran Caption now waits properly for frame capture to finish before completing the export.

  If your computer cannot handle the selected number of parallel workers, you will now get a clear error message asking you to lower the worker count.

Settings

• Reordered advanced settings for a cleaner and more logical layout.

Arabic Rendering

• Fixed justified Arabic text alignment

  Justified Arabic text is now correctly aligned as RTL instead of LTR.

Quran Caption v3.5.83

This update focuses on export stability, WBW translation improvements, ayah container timing, segmentation fixes, and better compatibility with older projects.

Export

• Fixed an export issue when opening older projects

  Older projects could fail during video export because of the newly introduced video transition style.

• Improved default video filename sanitization

  Export now works even when the reciter name contains characters that are not allowed in Windows filenames.

AI

• Optimized WBW mapping JSON sent to AI providers

  The previous JSON structure used very long variable names, which could consume a lot of tokens and quickly increase AI costs.

  The new compact format reduces token usage and makes AI-assisted WBW translation matching cheaper.

• Fixed the default Gemini model in AI preset settings.

Word-by-Word

• Added “show only current word style” mode

• Fixed WBW timestamp alignment after verse splitting

  This fixes an issue where, when the reciter performed wasl, WBW timestamps after the first split subtitle could be misaligned.

• Fixed WBW mode being kept incorrectly when editing translations.

• Fixed the WBW quick editor mode not being preserved in the timeline.

Translations

• Improved translation word matching

  Trailing punctuation is now included in the matched range.

• Added Bengali surah name translations.

Ayah Container

• Added timing control for ayah containers

  Ayah containers can now be displayed only between a specific start and end time.

Modals

• Fixed AI style modal placement

  The modal is now mounted globally instead of only inside the timeline, preventing it from opening in an inaccessible area.

Quran Caption v3.5.71

This update adds Quran Universal Audio integration, new styling options, track reordering, H.265 export, Indonesian localization, and several workflow improvements.

Quran Universal Audio integration (by @Hetchy)

• Added QUA integration
  Quran Caption now integrates with Quran Universal Audio by @Hetchy.

  May Allah greatly reward @Hetchy for his incredible work.

• This replaces the old mp3quran recitation import workflow.

• You now have access to a much larger and better reciter library.

• Many recitations already include verified subtitles with WBW timestamps.

• You can now import only a selected verse range instead of importing the full surah.

Localization

• Added Indonesian language support to the local interface translations.

Export

• Added H.265 video codec option

  This can produce smaller video files, but export will be slower.

  It can be enabled in Advanced Export Settings.

• Added fallback to PNG when TGA temporary files cause disk space issues

  This fixes cases where the OS reported “not enough disk space” even when enough space was available.

Timeline

• Added track reordering

  You can now move tracks up or down depending on your preferred timeline organization.

Video clips

• Added clip transition styles

  Available transition types include:

  • fade to black
  • crossfade

Word-by-Word

• Added new WBW style: reveal word styles on recitation

  This allows word styles to appear progressively as the words are being recited.

Styles

• Added a second surah calligraphy style option

  This new calligraphy style does not include the “Surah” prefix.

• Added support for explicit surah translations in surah name styles

  Example placeholders:

  • <translation-fr>
  • <translation-zh-hant>

• Added the ability to import a custom ayah container image

• Fixed an issue where no translation could be selected by default in the Styles → Translation dropdown

  The first translation is now selected automatically when needed.

AI settings

• Changed the default Gemini model in predefined AI endpoint settings to 3.1-flash-lite.

Translations

• Fixed RTL direction support in the translation word selector.

UI

• Improved the donation/support banner.

• Improved red alert contrast in themes.

Quran Caption v3.5.61

Hotfix

• Reverted the new local Surah Splitter AI segmentation change introduced in v3.5.60

• Fixed an issue where Arabic words and translations could be repeated when merging subtitles

Quran Caption v3.5.60

This major update introduces full undo and redo support, automatic WBW timestamp realignment, translation word highlighting, built-in stock media search, a new local segmentation model, and major performance improvements for large projects.

Undo and Redo

• Added undo and redo support across the software

  You can now reverse or restore changes using:

  • Ctrl + Z to undo
  • Ctrl + Shift + Z or Ctrl + Y to redo

  This applies to editing actions throughout Quran Caption and makes experimentation much safer.

Word-by-Word Timing

• Added on-demand and automatic WBW timestamp alignment
  Contribution by @Hetchy

  When the start or end time of a subtitle clip is changed in the timeline, its word-by-word timestamps are now automatically fetched and realigned.

  This avoids having to manually regenerate WBW timing after every subtitle adjustment.

• Added a glow style for the word currently being recited

• Added manual line-break styling for Arabic WBW text

  This allows you to force a new line before a specific Arabic word.

• Updated the Quran Multi-Aligner data download URLs for local Quran Universal Aligner segmentation

Word-by-Word Translation Highlighting

• Added WBW highlighting for translations

  In addition to highlighting the current Arabic word, Quran Caption can now highlight its corresponding word or expression inside the translation.

• Added AI-assisted Arabic-to-translation word matching

  The AI can identify which translated words correspond to each Arabic word, reducing the amount of manual setup required.

• CJK translations can now be styled character by character

  This improves individual styling support for Chinese, Japanese, and Korean text.

• Fixed unwanted spaces in merged Chinese translations

AI Segmentation

• Added a new ONNX-based Surah Splitter

  This provides a better local model for automatic Quran recitation segmentation.

• Segmentation results now display clearer review counts, including:

  • low-confidence subtitles
  • subtitles with missing coverage

  This makes it easier to understand how much manual review is still required.

Stock Images and Videos

• Added built-in Pexels and Pixabay search

  You can now search for and import stock videos or images directly from the editor without downloading them manually outside Quran Caption.

Performance

• Reduced preview and timeline lag, especially on long surahs and large projects

  Calculations that have already been completed are now reused instead of being unnecessarily repeated.

  This significantly improves editor responsiveness.

Translations

• Added numeral style customization for verse numbers

  Verse numbers can now use different numeral systems, including:

  • Western Arabic numerals
  • Persian numerals
  • Urdu numerals
  • Hindi numerals

• Added max-line support for translations

  Translation text can now automatically shrink to remain within a chosen maximum number of lines.

• Added manual line-break styling for translation text

  This allows you to force a new line before a specific word in the translation.

• Removed AI translation telemetry consent and related translation data collection

Surah Information

• Added Traditional Chinese and Simplified Chinese translations for surah names

Export

• Increased export clarity by improving the descriptions of the available performance profiles

• Fixed the Export Monitor displaying four steps when the new export pipeline only uses three

• Background processing cache is now separated by export profile

  Changing the export quality or performance profile will no longer reuse an incompatible cached background from a previous export.

• Added runtime frame-capture logs

  These logs provide more information about what is happening during export and make debugging easier.

• Subtitle and YouTube chapter exports can now be given a custom filename, just like video exports

Community Styles

• Community styles are now sorted by number of downloads by default

  This makes the most popular styles easier to discover.

Search

• Added a clear button to search fields on the homepage and inside the editor

  This allows the current search to be reset with one click.

Timeline and Preview

• Fixed background images disappearing from the timeline

Homepage

• Added a support progress bar

Interface and Localization

• Added the previously missing labels for the vertical and horizontal position of verse numbers

Hotfix — Fixed an issue where subtitle text could appear differently from one frame to another.

Quran Caption v3.5.40

This update brings a major export pipeline rewrite, much faster video generation, and full interface localization.

Video Export

The video export pipeline has been completely reworked.

Exports are now approximately 3 to 5 times faster.

Main improvements:

• The frame capture step now uses 4 parallel workers
• Background preprocessing is skipped when no blur is applied
• The video creation step is significantly faster
• Batch size has been removed
• RAM usage is now fully controlled by the new export system
• The final merging step is no longer required

This makes exports faster, more stable, and safer for long or complex projects.

Localization

Quran Caption is now available in:

• English
• French
• Spanish
• German
• Chinese

The interface language can be changed from Settings.

Media

• CBR conversion is no longer performed automatically after downloading an asset

Bug Fixes

• Fixed a macOS export issue where Chinese text could be duplicated in the exported video

• Fixed an issue where some subtitles were missing their fade transition

Quran Caption v3.5.30

Styles

• Added new Ayah Banners made by @isaglace on Discord

YouTube Chapters Export

• Added customizable YouTube chapter format

  You can now customize how exported YouTube chapters are written using placeholders such as:

  • <timestamp>
  • <verse-arabic>
  • <verse-translation>
  • <surah-translation>
  • ...
    This gives more control over how chapters appear in YouTube.

Notifications

• Added completion notifications

  You can now receive Windows notifications with a sound when:

  • video export finishes
  • AI segmentation finishes
  • AI translation trimming finishes
    This can be disabled in Settings.

Translations

• Improved fetching translations from older projects

  When translations are fetched from older projects, Quran Caption now automatically checks them for possible inconsistencies.

• Rebuilt fetched translations from word indexes

  When possible, fetched translations are now rebuilt from their saved word indexes instead of copying the old text directly.

  This only applies when the translation was not manually edited.

• Added support for Chinese translation trimming

  Chinese translations are now better supported both for manual trimming and AI trimming.

Preview and Styling

• Fixed max-line style issue caused by empty subtitles

  Empty subtitles are now ignored when calculating max-line fitting, preventing incorrect font size behavior.

AI Video

• Removed AI Video feature

Quran Caption v3.5.20

Styles

• Added Ayah Banners

  A new global style that lets you add a visual container behind ayahs.
  It works similarly to the existing ayah background style, but uses more polished image-based banners with a more Islamic visual style.

• Fixed vertical alignment styles in the preview

AI Video

• AI Video can now create projects without requiring a background video

• Removed debug mode from the AI Video workflow

• Fixed AI Video provider handling
  → it now correctly uses the AI endpoints configured in Settings

AI providers

• Added quick presets for text AI providers:

  • DeepSeek
  • OpenRouter
  • Groq
  • Gemini
  • OpenAI

This makes it easier to configure AI features without manually entering every provider setting.

Export

• Added subtitle JSON export

  You can now export all project subtitles as JSON, next to the existing project data export options.

Subtitles Editor

• Improved segment marking by length

  You can now mark subtitles based on a minimum and maximum word count, making it easier to find subtitles within a specific length range.

Media

• YouTube downloads no longer show the VBR warning

  Downloaded YouTube media is now automatically converted after download, so the warning is no longer needed.

• CBR conversion is now asynchronous

  Conversion now shows progress and no longer blocks the interface.

Quran Caption v3.5.14

Community styles

• Added community styles system

  → You can now:

  • publish your own styles
  • explore styles shared by the community
  • apply them directly to your project

  This makes it much easier to reuse and share visual setups.

Export

• Added automatic batch size mode (default)

  → The software now:

  • dynamically adjusts batch size in real time
  • keeps RAM usage below ~90%
  • maximizes batch length for better performance

  No more manual tuning needed.

• Fixed an issue where merged subtitles had a transition to blank between them
  → transitions are now seamless

• Fixed an issue where unwanted “non-empty blank frames” could appear between subtitles

• Fixed macOS export rendering
  → styles (background, spacing, underline, etc.) now match preview much more closely

• Fixed vertical alignment not being applied in exported videos

• Fixed export showing Arabic subtitles even when disabled

• Fixed rare crashes when translation editions were missing

AI video generation (beta)

• Added a new AI video generation mode

  → You can write a prompt (example: “a video about respecting parents”)
  → The AI will:

  • select a reciter
  • select a verse range
  • download audio
  • run segmentation
  • trim translations

  → You only need to apply your style and export

  Requires an AI API key configured in settings.

AI segmentation

• Improved audio alignment reliability (by @Hetchy)

  → Fixes progressive desync caused by differences between:

  • container duration
  • actual decoded audio

  → Subtitles now stay aligned even on long or problematic audio files

• This applies to:

  • cloud segmentation
  • local models
  • Whisper
  • imported JSON

Subtitles & rendering

• Added max lines style

  → Ensures subtitles always fit within N lines
  → Automatically reduces font size if needed

• Fixed Arabic rendering in grouped subtitles without WBW timestamps
  → Arabic now always displays
  → WBW is applied only if all subtitles within the groups include timestamps

• Fixed Arabic bracket style rendering

Translations

• Added new “error” status for translations

  → You can now mark translation issues using:

  • missing words detection
  • overlap validation

  → Helps quickly review trimming quality

• Added Bangla WBW helper translation

UI & workflow

• Added project search button in the title bar
  → alternative to CTRL+F

• Fixed export tab UI issue (scrollbar on small screens)

Developer / internal

• Refactored export system:
  → split large export script (commands.rs) into multiple focused modules

Settings & integrations

• Added support for DeepSeek AI endpoint

Quran Caption v3.4.97

Quran Support

• Added Soosi riwayah mushaf
  → contribution by @idrees-mahmood

Search

• Added project-wide verse search (CTRL+F)
  → opens a custom search bar
  → quickly navigate to a verse or its translation

Export

• Fixed an issue with long export filenames on Windows
  → now uses shorter temporary filenames
  → prevents failures when projects contain many surahs

UI

• Improved update modal progress bar contrast
  → better visibility during updates

• Fixed wizard layout overflow on small screens
  → improves usability in AI segmentation flow

Quran Caption v3.4.96

Export

• Fixed an issue where export batches could contain incorrect verses
  → ensuring subtitles are now properly aligned with the correct segments

• Stabilized the export pipeline
  → removed reliance on fragile/edge-case behavior
  → improves overall reliability, especially on long and complex projects

Quran Caption v3.4.95

Export

• Fixed an issue where batch size was not respected during export when no silence clips were present
  → could lead to memory crashes

• Fixed an issue where export could fail on long videos when using:

  • transparent background or fade
  • small batch size

  → the merging step could generate a command too large for Windows to execute

Preview & Layout

• Improved text fitting behavior:
  → vertical alignment is now ignored while fitting text

  This allows combining:

  • max-height
  • vertical alignment

  → ensuring text always fits within the max height while keeping proper positioning

Timeline

• Added ability to split (unmerge) visual merges directly from the timeline button

  → no need to right-click → unmerge group
  → does not break the entire group
  → faster and more precise workflow

UI

• Updated donation component to have more options

Quran Caption v3.4.94

AI segmentation

• Added a new 100% local segmentation model
  → more accurate than the Muaalem-based model
  → currently supports only one surah per audio file

Subtitles

• Fixed an issue where the verse number was treated as a word in merged subtitles

3.4.93 — Fixed an issue where pre-defined subtitle clips were missing their text

Quran Caption v3.4.92

This update focuses on improving editing speed, Word-by-Word (WBW) workflow, and AI segmentation flexibility.

Editing workflow

A new quick editing system has been added to reduce context switching.

You can now edit subtitles directly from anywhere:

• Right-click a subtitle in the timeline to:

  • edit Arabic text
  • edit translation
  • edit WBW styling
    → the editor opens directly inside the timeline

• Double-click on the video preview:

  • Arabic text → edit Arabic
  • Translation text → edit translation

From this overlay, you can also:

• split a subtitle at a specific word using WBW timestamps

This allows faster iteration without switching tabs.

Subtitle editing

Splitting subtitles is now more precise and WBW-aware:

• The D shortcut and right-click → split now:

  • preserve Word-by-Word timestamps
  • automatically split at the nearest word from the cursor position

• Hold CTRL while splitting to:

  • split exactly at the cursor position

This ensures accurate splitting without breaking WBW timing.

Word-by-Word (WBW)

WBW behavior and styling have been improved:

• Verse number now inherits the highlight style of the last word
  → ensures visual consistency during recitation

• WBW timestamps are preserved when resizing a subtitle
  → no need to redo word timing after adjusting start/end

• Highlight color is no longer required to access other WBW styles

• Added option:

  • "Always Show Verse Number" for WBW mode

• Fixed WBW timestamps generated by AI:

  • now always start at 0 and end at the subtitle boundary

AI segmentation

The segmentation system has been expanded and made more robust:

• Added a new 100% local segmentation model based on Muaalem:

  • supports WBW timestamps
  • works offline
  • less accurate than Quranic Universal Aligner (by Hetchy), but usable alternative

• Added multiple speech-to-text models to choose from

• Improved fallback logic:

  • if GPU segmentation fails (quota), it automatically falls back to CPU

Translations editor

• Added a language picker for the WBW helper:

  • English, French, Urdu, Hindi, Dutch, and Pakistani variants

• Updated UI:

  • more compact layout
  • easier access to filters and pre-selection tools

Timeline and UI

• WBW words are now displayed inside subtitle clips in the timeline
  → improves readability and editing precision

• WBW style section is always visible in Arabic styling
  → includes setup guidance if no WBW timestamps are present

• Escape key now exits fullscreen preview

• Fixed an issue where dragging with the mouse could select another clip on mouse release

Styles

• Added customizable verse number color in Text Styling

Export

• Fixed an issue where batch size was not respected during export, which could cause memory crashes when no silence clips were present in the project

• Export speed increased by ~40%

• Fixed issue where wrong subtitles could appear when fade duration = 0

• Fixed CBR conversion reducing video resolution to 320x240

• Removed index numbers from VTT subtitle export

Merging

• Fixed an issue where merging subtitles across mushaf pages
  could display the wrong verse

Codebase

• Partial refactor of the codebase
• Added internal documentation for better maintainability

3.4.84 — Hotfix: fixed export preview showing when it shouldn’t (oops)

3.4.83 — Final fix for issues where the last word or verse number could shift to the line below

🚀 Quran Caption v3.4.82 — Rendering & Transition Fixes

This update focuses on improving subtitle rendering consistency and fixing visual issues during transitions.

🎬 Rendering Fixes

• Fixed an issue where the last word of a subtitle or the verse number
  could be pushed to a new line unexpectedly

• ⚠️ Note:
  In very rare cases, when combining:

  • bracket styles
  • max-height constraints
  • WBW styling

  → the verse number may still shift slightly
  → this is due to a limitation in an external library and is outside current control

🎨 Transition Improvements

• Fixed an issue where static elements (fixed overlays)
  had an opacity lower than expected during transitions

• Fixed a bug where text could briefly appear between transitions

🎯 Summary

This update improves visual stability, ensuring cleaner subtitle layout and smoother transitions in exported videos.

🚀 Quran Caption v3.4.81 — WBW Enhancements & Workflow Improvements

This update improves the Word-by-Word (WBW) experience, adds new visual styles, and enhances subtitle review tools.

✨ Word-by-Word (WBW) Improvements

• Improved WBW editing flow:
  → finishing WBW editing now exits both WBW mode and subtitle edit mode
  → smoother and more intuitive workflow

• Added progressive WBW appearance style
  → words now appear progressively as they are being recited
  → similar to “Tarteel-style” reading experience

🧠 Subtitle Review Tools

• Added “mark subtitles with missing WBW timestamps” option
  → subtitles without WBW timing are highlighted in light blue in the timeline
  → works similarly to “mark long subtitles”

🎨 Styling Fixes

• Fixed WBW styling on merged subtitles
  → WBW styles are now correctly applied even when multiple subtitles are merged

🚀 Quran Caption v3.4.80 — Word-by-Word Highlighting & Editor

This update introduces a complete Word-by-Word (WBW) highlighting system, along with a dedicated editor for precise control.

✨ New Feature — Word-by-Word Highlighting

You can now visually highlight words as they are being recited.

Available styling options:

• WBW text color
• Optional underline
  → with adjustable thickness
• Optional background color
• Toggle to enable/disable WBW background and customize color

Highlight behavior:

• Persist highlighted words option:
  • Enabled → previously recited words remain highlighted
  • Disabled → only the current word is highlighted

→ This allows different visual styles depending on your use case
(e.g. progressive reading vs focus on current word)

✍️ New Feature — Full WBW Editor

A new Word-by-Word editor is now available for fine control over highlighting.

• Edit WBW timing with an intuitive workflow
• Adjust custom playback speed for precise editing
• Integrated tutorial video to guide usage

Quick access:

• Long press E while hovering a subtitle with the timeline cursor
  → instantly enter WBW edit mode

🎯 Summary

This update gives you full control over how words are highlighted and timed, making your videos more immersive and easier to follow.

🚀 Quran Caption v3.4.74 — Faster Export & Timeline Controls

This update improves export performance, fixes audio sync issues, and enhances timeline usability.

🎬 Export Improvements

• Improved export speed:
  → the frame capture step is now up to 2× faster

• Fixed an issue where audio could go out of sync with the background video over time in exported videos

⏱️ Timeline Improvements

• Added ruler zoom controls in the timeline
  → two zoom icons allow you to easily zoom in/out for better precision

🧠 Hifz & Shortcuts

• Added Hifz shortcut visibility in General Settings
  → makes the feature easier to discover and access

🐛 Bug Fixes

• Various fixes improving export reliability and timeline interaction

🚀 Quran Caption v3.4.73 — Hifz Tool & Repetition Workflow

This update introduces a powerful new Hifz tool for repetition-based videos, along with timeline fixes and workflow improvements.

🧠 Major Feature — Hifz Tool (Memorization Mode) (ft. @Himmy504)

A new Hifz tool is now available in the software (accessible from the title bar alongside other tools).

It allows you to generate videos designed for Quran memorization and repetition.

What you can do:

• Repeat subtitles / verses N times automatically
• Add a custom pause duration between repetitions
• Keep audio perfectly aligned across repetitions (including multiple generations)

👉 This makes it possible to easily create:

• memorization videos (hifz)
• repetition-based learning content
• recitation practice videos

⏱️ Timeline Improvements

• Fixed horizontal scrolling on touchpad
  → horizontal scroll is now properly preserved

🐛 Bug Fixes

• Attempted fix for a macOS issue where typing in input fields was not possible

🚀 Quran Caption v3.4.72 — Export Reliability & Workflow Enhancements

This update focuses on improving export reliability, subtitle layout accuracy, and giving more control over shortcuts and timeline editing.

🎬 Export Improvements

• Improved export reliability by waiting for subtitle layout to fully stabilize before frame capture
  → helps prevent issues where subtitles could overflow due to max-height or anti-collision not being applied in time

• Fixed an issue with transparent background exports
  → subtitle transitions now fade correctly to transparent instead of black

• Added RAM usage guidance for batch size directly in the UI
  → helps users choose the right value based on their hardware

✍️ Subtitle & Translation Improvements

• Improved translation styling UX:

  • Added a visual banner indicator when editing word-level styles in the Translations tab

• Fixed a bug where extra spaces after em-dashes were not removed when merging subtitles

⏱️ Timeline & Shortcuts

• Added fully customizable timeline shortcuts
  → you can now define your own key bindings in Settings

• Improved shifting tool:

  • You can now shift only clips at or after a given timestamp (@idrees-mahmood)

🐛 Bug Fixes

• Various fixes improving subtitle rendering consistency and export accuracy

🚀 Quran Caption v3.4.71 — Subtitle Merging & Timeline Improvements

This update introduces a major new feature for subtitle merging, along with timeline usability improvements and important fixes.

✨ Major Feature — Subtitle Merging

• Added subtitle merge functionality with quick controls in the timeline

  → You can now merge multiple subtitle clips into one
  → Enables displaying:

  • multiple verses at the same time
  • multiple parts of a verse
  • or any custom combination

• Flexible merge modes:

  • Merge Arabic only
    → Arabic stays static across merged segments
    → Translations update progressively with the recitation

  • Merge Translation only
    → Translation stays static
    → Arabic updates normally across segments

  • Merge both Arabic and Translation
    → Fully combines subtitles and translations into a single block

• Includes a context menu mode and improved selection handling
  → merged subtitles are now easier to manage and edit

⏱️ Timeline & Shortcuts Improvements

• Added a timeline hint panel showing all available shortcuts
  → can be closed manually

• Added timeline shortcuts to the Settings → Shortcuts tab

• New shortcut:

  • Ctrl + Shift + Scroll → horizontal scroll in timeline

📦 Assets & Media

• Added a warning when a media file is not in constant bitrate (CBR)
  → helps prevent issues when syncing subtitles

🌐 YouTube & Import Fixes

• Fixed an issue where downloading a video could download the entire playlist instead

• Imported projects now have their updatedAt set to current time

• Fixed homepage behavior:

  • changing a project status no longer modifies updatedAt

🐛 Bug Fixes

• Various fixes and improvements for timeline behavior and project consistency

🚀 Quran Caption v3.4.64 — Smarter Segmentation & Editing Improvements

This update improves AI segmentation accuracy, macOS rendering, and introduces powerful new tools for subtitle editing and review.

🤖 AI Segmentation Improvements

• Cloud segmentation now returns maximum one verse per segment
  → improves consistency and readability

• Behavior depends on WBW (word-by-word) mode:

  • WBW enabled → accurate verse splitting
  • WBW disabled → approximate split based on word count
    → segments are automatically marked as “needs review”

• Latest AI segmentation changelog is now hidden by default
  → can be expanded manually if needed

🍎 macOS Rendering Improvements

• Improved macOS export rendering (thanks to @nawzadamiri)
  → exported videos now match the preview much more closely

✍️ Subtitle Editing & Workflow

• New right-click context menu on words in subtitle edit mode
  → instantly split a subtitle at a specific word

• Added tools to detect long subtitles:

  • highlight subtitles with more than N words

• Added automatic split options:

  • split subtitles above N words
  • split subtitles longer than N seconds

• Improved review workflow:

  • subtitles marked as needing review keep their color indicator (more subtle after review)
  • simply hovering a subtitle marks it as reviewed

🎨 Styling Improvements

• Added horizontal padding style for subtitle background
• Fixed an issue where text outline and background opacity styles could not be combined
• Added back the “Reset Styles” button in the Style Editor tab

🌐 Quran.com Integration Enhancements

• Software theme is now synchronized with your Quran.com account theme

• Added Quran.com API tab in the translation modal
  → access and use Quran.com translations directly

📦 Project & Downloads Improvements

• Improved YouTube downloads performance
  → added progress reporting during download

• Added duplicate project option
  → quickly reuse an existing project as a base

🐛 Bug Fixes

• Fixed segmentation UI issue where estimated progress started too early
  → now starts correctly after confirming overwrite of existing subtitles

🚀 Quran Caption v3.4.52 — Major Export Rewrite, Styling & Workflow Improvements

This update brings a major rewrite of the export pipeline, along with many improvements to styling, subtitle editing, project organization, and overall usability.

🔥 Major Highlight — Export Rewrite

The export script has been fully reworked.

What changed

• Export no longer consumes all the RAM of the PC

• New batch size system to control memory usage:

  • higher batch size = more RAM usage
  • lower batch size = less RAM usage

• Export is now faster, more stable, and much more efficient

This is one of the biggest export improvements made so far.

🎬 Export Improvements

• Added export without background in advanced export settings
  → useful if you want to edit the video background later in another editing software
  → also supports semi-transparent backgrounds

• Added timed visibility for Surah Name / Reciter Name global overlays
  → you can now choose when they appear and disappear
  → useful for videos with an intro

• Fixed subtitle fade transitions darkening between transitions

• Increased audio bitrate during export to reduce quality loss

• Fixed a bug where subtitle layout from a stale render could restore opacity too early before max-height / anti-collision was complete
  → this could sometimes cause temporary overlap on an exported frame

• Fixed a bug where adding a custom text shortcut could create an invalid clip
  → custom text now always creates a minimum 3-second clip at subtitle end boundary

• Fixed a macOS issue where non-system fonts were not rendered in exported videos
  → thanks to brother @nawzadamiri

• Fixed a problem where the Surah name could briefly change during subtitle transitions in exported video when using a custom text

🎨 Styling & Visual Improvements

• Added a new style for custom text: width is now customizable
  → useful to force line breaks more easily

• Added style presets directly inside the software
  → you can now save and reuse presets without manually importing/exporting JSON files

• Added a toggleable alignment grid in the preview
  → the grid can also appear automatically while dragging elements
  → makes centering much easier

• Changed the default value of “above overlay” for custom images to true

• Tajweed mushaf type is now forced to render in black
  → other colors are not properly supported by the exporter for this mushaf type
  → if you use it, you should place a fully white background behind the Arabic text

🌍 Translation & Arabic Styling

• Added a Reset All Styles button for:

  • translations
  • Arabic text

• Added per-word color styling for translation words

• Added the ability to bold, italicize, underline, or color individual Arabic words in verses
  → available from the Translations tab, inside the style section

• Optimized the AI prompt used for translation styling

• Fixed a bug where translation styles could reset by themselves

• Fixed a regression where a space was added after every em-dash in translations on the video

• Fixed an issue where changing predefined subtitle translation text could throw an error

✍️ Subtitle Editor & Workflow Improvements

• Changed word selection behavior in the Subtitles tab:

  • clicking an already-selected word now keeps the start cursor
  • only the end of the selection changes
  • clicking the current end word resets the start cursor to the end cursor

• Added the ability to drag the mouse over Arabic words in the Subtitles tab for easier selection

• Added ArrowUp / ArrowDown subtitle navigation in:

  • Video
  • Style
  • Export
    → same behavior as previous/next navigation in the video playbar

• Fixed a bug where silence subtitles could not be edited as Quran

• Fixed an odd audio playback error when moving the cursor in the timeline

🖥️ UI & Small Screen Improvements

• Added a scrollbar to the left panel in Subtitles Editor for small screens

• Added an openable drawer in the Translations tab
  → small-screen users can now access the Arabic and translation style panels more easily

• Fixed a problem in the reciter rename modal where the icon did not load

• Translated player errors into English and added a guard to prevent them from being spammed

🗂️ Project Organization

• Added a project explorer tree on the home page with folders by:

  • reciter
  • type
  • year

• Added drag-and-drop project organization

💬 Support & Community

• Replaced the weekly support prompt with a contextual post-export donation panel
• Added support tracking tied to that new panel

🚀 Quran Caption v3.4.30 — Arabic Styles & Media Effects

This update introduces new Arabic text styles, media effects, and improvements to stability and telemetry.

✨ New Features

• Added a new Arabic general style: Mushaf Type
  → Choose between:

  • Uthmani
  • IndoPak
  • Tajweed

• Added video & audio fade effects 🎬
  → Includes configurable fade duration for smoother transitions

🛠️ Improvements

• Improved telemetry system for better insights and future enhancements

🐛 Bug Fixes

• Fixed an issue where video export could get stuck on macOS (@Himmy504 fix)

🚀 Quran Caption v3.4.20 — AI Translation Styling & Export Improvements

This update brings major improvements to translation styling, AI tooling, and export quality.

🤖 AI & Translation Enhancements

• Added inline emphasis editing in translations:
  → You can now bold, underline, or italicize specific parts of a translation.

• Added an AI Bold Assistant:
  → Automatically highlights important parts of translations using AI.
  → Supports custom prompts.

• Added AI provider endpoint support:
  → You can now connect Quran Caption to any AI provider, not just a single service.

• Added global AI & export preferences:

  • Chunk size is now a global setting
  • Saved automatically in Settings

• Added telemetry for AI translations:
  → Helps improve the system and potentially train a free translation AI model in the future.

🎬 Export Improvements

• Fixed an issue on macOS where export could get stuck at the “taking screenshot” step
• Fixed quality loss in 2K / 4K background videos

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

🛠️ Quran Caption v3.4.1 — Integration & Critical Fixes

This update introduces Quran.com integration and fixes several important issues, including a critical change for AI segmentation.

🌐 Quran.com Integration

• Added Quran.com authentication inside the software

• You can now:

  • Sync your Quran.com bookmarks
  • Right-click a subtitle → bookmark the verse in a collection

• Added support for recitations from Quran.com, alongside mp3quran

  • Includes automatic timings

⚠️ Important — AI Segmentation Update

• The Hugging Face space used for AI segmentation has been renamed
• ⚠️ If you do not update within the next 2 weeks,
  automatic AI segmentation will stop working

🎬 Export Improvements

• Fixed an issue on macOS where video export could hang while waiting for fonts
• Added a confirmation dialog when overwriting an existing export file

✍️ Translation & Editor Improvements

• Added tracking of the last read subtitle
  → You are automatically scrolled back to where you left off in the Translation Editor

• Fixed a bug where the currently selected subtitle was not visible
  when editing across different surahs

🎨 UI Fixes

• Fixed light theme issue where overlapping subtitles were hard to read
  (light text on light background)
• Fixed another issue with the app changelog (dark theme)

🐛 Bug Fixes

• Fixed an issue where downloading audio from YouTube
  would fail on the second download

🚀 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.