Quran Caption v3.8.50

More AI tools without an API key

The copy-paste workflow is now available in four additional assistants:

• Bold emphasis in translations.
• Word-by-word translation alignment.
• Translation review.
• Subtitle splitting by meaning.

Copy the prepared prompt into an AI chat, then paste its reply back into Quran Caption. Replies are validated before results are applied.

Generating export ranges grouped by meaning also supports this workflow when no API key is configured or the API request fails.

Identical prompts now keep the same request ID, so regenerating an unchanged prompt no longer invalidates its previous reply. AI bold changes also support undo and redo.

Cleaner text outlines

Text outlines now have smoother, rounded edges, especially at larger widths. Subtitle outlines support widths up to 20 px, increased from 10 px.

Fixed gaps that could appear around small characters with thick outlines in both the preview and exports, including on macOS.

Combine glow, neon, and shadows

Glow, neon, drop shadows, and individual word highlights now work together without replacing one another.

Glow preserves the text’s original color, while neon has a brighter center and a more controlled halo.

Automatic retry for stalled exports

If a video export captures no frames for 30 seconds, Quran Caption now cleans up the stalled capture and retries it once automatically.

If the retry also remains at zero frames for another 30 seconds, the export is canceled instead of remaining stuck indefinitely.

Quran Caption v3.8.41

Add media at the timeline cursor

Hold Ctrl while clicking an Add to Timeline option to place an image, video, or audio clip at the current cursor position.

The app checks for overlaps and warns you if there isn’t enough space. This action supports undo and redo.

Exported files visible on macOS

Fixed an issue where automatically shortened export filenames could cause files to be hidden in Finder.

Startup crash fixed

Fixed a crash when loading settings from older versions with missing timeline shortcuts.

Quran Caption v3.8.40

Smoother timeline navigation

A new Show video in preview checkbox on the video track lets you temporarily disable background video loading for smoother scrubbing.

Audio playback continues, and re-enabling the preview synchronizes the video with the timeline cursor. This setting does not affect exports.

Correct fonts after text case changes

Fixed an export issue where applying uppercase or lowercase styling could cause characters to appear in a fallback font. Exported text now keeps the selected font after these transformations.

Enter shortcut restored

Fixed an issue where the Enter shortcut could stop working after closing the quick subtitle editor.

Quran Caption v3.8.32

This update improves the AI copy-paste workflow and preserves existing translations when splitting subtitles.

More reliable AI reply validation

Pasted replies now handle more formatting issues, including Markdown escapes, HTML space entities, and unescaped quotation marks inside translation text.

Cleanup happens when you check the reply, leaving the pasted text unchanged in the input field.

Smoother translation processing

• Translation alignment or coverage errors no longer block the entire batch. Affected segments are marked AI Error so you can review them.
• Translations apply automatically after you check the final reply, without a separate confirmation step.
• The complete operation supports undo and redo.

Translations preserved when splitting subtitles

Splitting a subtitle now keeps its existing translation text and selected range on both resulting fragments. Both translations are marked To review, so you can adjust each one to match its new Arabic fragment.

This applies to manual splits and automatic subdivision.

Quran Caption v3.8.31

This update fixes two issues with AI replies and keyboard shortcuts.

Pasting AI replies

You can now paste the full AI reply, even if it includes Markdown code blocks or text around the JSON. The surrounding content is automatically removed before validation.

Keyboard shortcuts after updating

Fixed an issue when loading shortcut settings from older versions. Missing shortcuts are now added before the editor registers them, while preserving your custom bindings.

Quran Caption v3.8.30

This update adds PNG image exports, a Turkish interface, and a new way to move Quran words between subtitle fragments.

Export subtitles as PNG images

You can now export your subtitles as still images, ready to share individually or use in a carousel.

• Select a time range and an export folder.
• Export one PNG per subtitle within that range, including its background and styling.
• Images use your project’s dimensions and are saved in a separate folder with numbered filenames.

For video backgrounds, each image includes the corresponding video frame.

Turkish interface

Quran Caption is now available in Turkish! Select Türkçe from the language selector to switch the interface.

Move words between subtitle fragments

You can now adjust how words are split between adjacent fragments of the same Quranic verse.

• Hold Shift while dragging a subtitle boundary to transfer words between the two fragments.
• Use Shift+M / Shift+N to make word-aware boundary adjustments at the timeline cursor.

The Arabic text and associated translations update to match the new word ranges. These changes also support undo and redo.

Quran Caption v3.8.20

This update introduces a completely new visual identity for Quran Caption, a new AI-assisted translation mapping workflow that works without an API key, and a new Roman Urdu translation by Mufti Taqi Usmani.

It also improves style preset management and fixes an issue preventing the local AI segmentation engine from downloading correctly.

---

A New Visual Identity for Quran Caption!

• Quran Caption has received a completely redesigned logo!

  The previous logo has been replaced with a new blue design, giving Quran Caption a more recognizable and consistent identity.

• Updated the application icons across desktop platforms, including Windows, macOS, and Linux.

• Updated the website favicon to match the new branding.

---

AI Translation Mapping Without an API Key — New!

• Completely redesigned the AI-assisted translation mapping workflow.

  You can now use ChatGPT or another AI chat to automatically match existing Quran translations to partially recited verses, without configuring an API key.

• Replaced the legacy translation mapping workflow with two AI connection methods:

  • With API: Continue using automatic AI translation mapping through your configured provider.
  • Without API Key: Generate prompts, send them to your preferred AI chat, and paste the responses back into Quran Caption.

• Added a guided copy-and-paste workflow:

  1. Select Without API Key in the AI Translation Mapping dialog.
  2. Choose the Quranic verses you want to process.
  3. Configure the maximum number of words per AI request.
  4. Click Prepare Prompts.
  5. Copy the generated prompt into ChatGPT or another AI chat.
  6. Paste the AI response back into Quran Caption.
  7. Validate the response and review the proposed translation segments.
  8. Apply the translations to your project.

• Added automatic response validation.

  Quran Caption checks that the AI's suggested segments correspond to the original translation.

  Responses are checked for invented words, invalid mappings, missing translation coverage, and other inconsistencies before they can be applied.

• The AI must reuse the wording of the existing translation rather than generate a completely new translation.

  This helps preserve the original translator's wording when matching translations to partial Quranic recitations.

• Added automatic batching for longer passages.

  Large requests can be divided into smaller prompts, with progress tracking and individual response validation.

• Added retry support for invalid AI responses.

  If a response fails validation, Quran Caption explains the problem and lets you regenerate only the affected response. Previously validated results are preserved.

• Added a translation preview before applying changes.

• The application also checks whether the project or source subtitles have changed during processing, preventing outdated AI responses from being applied.

• Your selected AI connection method is saved for future use.

---

New Roman Urdu Translation

• Added Mufti Taqi Usmani's Roman Urdu Translation to the built-in translation library.

• The translation is available under Urdu (Roman).

• Added translation data for all 114 Surahs.

• Roman Urdu uses the Latin alphabet, allowing Urdu speakers who cannot read the Urdu script to follow Quranic translations more easily.

• The translation can be selected and used with Quran Caption's existing subtitle, styling, and export features.

  Source: Quran GTAF, Mufti Taqi Usmani Roman Urdu Translation.

---

Style Preset Improvements

• Added a new Update button for locally saved style presets.

  After selecting a saved preset and modifying its appearance, you can now update the existing preset directly instead of creating another copy.

• Quran Caption remembers which locally saved preset is currently selected.

• Updating a preset preserves its identity and name while saving the latest styling, custom elements, and video resolution.

• Renamed the preset creation action to New, making it easier to distinguish between creating and updating presets.

• Fixed portrait preset thumbnails being cropped.

  Vertical preset previews now preserve their aspect ratio and display the complete image.

---

Local AI Segmentation Fixes

• Fixed an issue preventing the local AI segmentation engine from downloading or initializing correctly after certain application updates.

  The application now prioritizes the current CTC aligner package instead of accidentally loading outdated alignment files left behind by previous installations.

• Improved compatibility with existing local segmentation installations.

---

Analytics & Maintenance

• Improved analytics to distinguish Quran Caption events from Minbar Caption events.

  This allows more accurate application-specific usage statistics.

• Updated the build workflow configuration for Minbar Caption's separate release system.

Quran Caption v3.8.13

This update fixes several video export issues, particularly on macOS, improving subtitle rendering, scaling, and reliability.

---

macOS Export Fixes

• Fixed Arabic and translated subtitles appearing at incorrect sizes or positions in exported videos.

  Subtitle scaling, rotation, and positioning are now correctly applied during macOS frame capture, matching the video preview more accurately.

• Fixed subtitle text and line backgrounds becoming misaligned when using scaling or rotation effects.

---

Export Reliability

• Fixed subtitles occasionally disappearing or being captured before they were fully rendered.

  Quran Caption now waits for fonts to load and subtitle layout adjustments to finish before capturing each frame.

• Fixed subtitle fitting potentially getting stuck or delayed during exports.

  Layout adjustments no longer depend on background timers that macOS may suspend or throttle during frame capture.

Quran Caption v3.8.11

This update improves macOS video exports, adds new text rotation controls, and restores the macOS Intel build workflow.

---

macOS Export Fixes

• Fixed Arabic and translated text appearing vertically misaligned in exported videos on macOS.

• Fixed subtitle line backgrounds sometimes disappearing during macOS exports.

  Line backgrounds are now correctly preserved throughout the video.

---

Text Rotation

• Added a Rotation setting to composite text styles.

  You can now rotate Surah names, reciter names, verse numbers, and custom text elements directly from the Style Editor.

---

Export & Preview Fixes

• Fixed a potential export error when using progressive zoom animations on image clips.

• Fixed fullscreen playback controls appearing in generated style preset previews.

---

macOS Intel Support

• Re-enabled the macOS Intel (x86_64) build workflow.

  The build process now downloads prebuilt FFmpeg binaries instead of compiling or installing FFmpeg through Homebrew, avoiding the extremely slow dependency installation affecting GitHub's macOS Intel runners.

Quran Caption v3.8.0

This major update introduces audio and video speed controls, customizable layer ordering, animated image zoom, and several improvements to the Style Editor and Word-by-Word subtitles.

---

Audio & Video Speed Control

• Added a new tool to speed up or slow down audio and video files.

  You can now adjust playback speed from 3x slower to 3x faster, directly from the Tools menu or by right-clicking a clip on the timeline.

• Audio pitch is preserved when changing playback speed.

• Added an option to automatically adapt subtitle timings when changing the speed of an audio clip.

  This also adjusts Word-by-Word timestamps, keeping subtitles synchronized with the modified recitation.

• Speed-adjusted media is saved as a new asset, preserving the original file.

---

Layer Ordering (Z-Order)

• Added a new Z-Order slider in the Style Editor.

  You can now control which elements appear in front of or behind others, including Arabic subtitles, translations, Surah names, reciter names, verse numbers, custom text, and images.

• Added layer ordering controls to the video preview's right-click menu.

  Easily move elements forward or backward without leaving the preview.

• Layer ordering is now saved with projects and style presets.

  Existing projects and older presets are automatically adapted while preserving previously configured layer positions.

---

Animated Image Zoom

• Added progressive zoom animations for images on the video timeline.

  Right-click an image clip and enable "Animate Image Zoom" to create a smooth zoom-in effect throughout its duration.

• Customize the final zoom level from 1x to 3x.

• Animations are supported in both the video preview and final exports.

---

Style Editor

• Reorganized Surah Name and Reciter Name settings into clearer groups.

  Arabic calligraphy, Latin text, and positioning controls are now easier to navigate.

• Settings that are not currently applicable are automatically hidden.

  For example, Latin text styling options are hidden when Latin text is disabled.

---

Arabic Fonts

• QPC V2 is now the default Arabic font when selecting the Hafs Riwayah.

• Fixed AI Segmentation unnecessarily resetting previously selected Arabic fonts.

  Your custom font preferences are now preserved when segmentation does not change the project's Riwayah.

---

Word-by-Word Subtitles

• Fixed Word-by-Word markers on the timeline sometimes displaying technical references (such as 2:255:3) instead of the actual Arabic words.

  Quran Caption now resolves and displays the correct Arabic text whenever available.