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