Documentation

Translations

The Translations tab is where you add translations of the Quran text to your video, in one or several languages, and adapt them to each recited passage.

Translations tab showing the added translations and the filter panel
The Translations tab

Adding a translation

Create your Arabic subtitles first, then click Add new translation to open the translation picker:

  1. Choose a language, then select a translation (edition) by a specific author. You can select several at once.
  2. A preview panel shows the translated text of your project’s verses, so you can check the wording before adding.
  3. Confirm with Add Translation — Quran Caption fetches the selected translations and syncs them with your subtitles.

Translations come from two sources — Quran API and Quran.com — plus a Recent translations shortcut. Standard translation downloads do not require a text AI key.

To import from TXT, use a project containing a single surah. The file must contain one translation per line: line 1 is verse 1, line 2 is verse 2, and so on. Keep lines for earlier verses even if your project starts later; each verse used by the project must have a non-empty line. The text is imported as written, including any verse numbers you put in it.

Add translation dialog showing the language and edition selection
The Add translation dialog

Translation statuses

Each translated passage has a status, shown as a colored badge in the filter panel:

  • To review (yellow) — the translation needs attention, for example because the subtitle contains only part of a verse or an AI review flagged a possible mismatch.
  • AI error / Error (red) — processing failed; check the passage before retrying.
  • AI trimmed / Automatically trimmed / Reviewed / Completed by default — completed workflow states. Reviewed records a manual edit or selection; automatic completion does not guarantee that the selected text matches the Arabic meaning.

Fetched identifies passages updated with the Fetch action. Use the quick filters to show only what needs attention: Show partial verses, Show AI fetched, or Show needs review.

Partial verses

When a subtitle contains only part of a verse, the full translation does not match. Select the words in the translation that correspond to the recited Arabic — Quran Caption trims the translation automatically and marks the passage as reviewed.

Translation editor showing a partial verse with word selection
Trimming a partial-verse translation

Editing translations

Enable Manually edit to change a passage’s displayed text. The edition menu lets you reset or remove the whole translation; removing it affects every subtitle using that edition.

Word styles

Word styles let you emphasize individual words — in the translation or in the Arabic text — directly from the Translations editor. The Word Styles panel has two exclusive modes.

Word Style Editing

To highlight words manually:

  1. Enable Word Style Editing.
  2. Turn on one or more styles: bold, italic, underline, new line, color, or glow.
  3. Drag across the words you want to style — in the trimmed translation or in the Arabic segment.

Bold, italic, underline, and new line are toggled on the selected range. Color and glow are applied with their current swatch. Editing the translation text afterwards clears the translation word styles and word-by-word mappings. Use Reset all segment styles to clear manual word emphasis.

You can also open the AI Bold Assistant to let your AI provider highlight key words automatically.

Word style editing with bold, italic, underline, new line, color, and glow toggles
Word style editing

Set WBW translation

This mode links translation words to specific Arabic words. Select an Arabic word, then drag across the trimmed translation range that matches it. The AI WBW Translation Assistant can map these ranges for you automatically.

AI translation assistants

Quran Caption includes several AI tools that run on your configured AI provider (see Settings → API Keys → AI Key):

  • AI trimming — trims translations to match partial verses.
  • Review translations with AI — checks the chosen translations for possible meaning, boundary, and overlap errors, then marks flagged passages as To review for you to inspect.
  • AI bold — highlights key words automatically.
  • AI WBW translation — maps translation ranges to each Arabic word.

What’s next?

With translations ready, customize how everything looks in the Style editor.