🛠️ 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 ✍️