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