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