# Captions and voice-over

Source: https://frameleaf.app/docs/studio/captions/

Studio turns the speech in your video into captions, and turns your text into a voice-over. Both land on the timeline ready to edit, so your films are easier to follow and quicker to narrate.

## Captions

Captions are made for one clip at a time. Open the caption dialog for a clip on the timeline and choose where the work runs with **Run on**. To caption several clips on Frameleaf Cloud in one go, see [Several clips on Frameleaf Cloud](#several-clips-on-frameleaf-cloud).

| Run on | What happens |
| --- | --- |
| **This device** | The speech is transcribed in your browser. Nothing leaves your computer, though model files may be downloaded the first time. |
| **Frameleaf Cloud** | Only the clip's sound is sent, after you see the price and confirm. |

If you can't run Frameleaf Cloud jobs, for example because an administrator hasn't allowed it, the price step says why and nothing is sent. Captions on this device always work.

### On this device

1. Choose **This device**, pick the language if you want to, and select **Prepare caption draft**.
2. When the draft is ready, **Review captions** lists every line. Check the text before anything is added.
3. Select **Apply captions** to add the lines to the clip, or **Cancel** to leave the timeline as it was.

If the clip already has generated captions, applying replaces them. Captions elsewhere that use the same transcript are refreshed too. If the timeline changes while you're reviewing, Studio asks you to make a new draft.

### On Frameleaf Cloud

A long video or an older computer can make transcribing slow. Frameleaf Cloud does it for you:

1. Choose **Frameleaf Cloud**, then **See the price**. Studio saves the project and opens **Captions on Frameleaf Cloud** with the estimate. Nothing is sent until you confirm.
2. Confirm the job. You can close the dialog; the job keeps going and shows in **Activity**.
3. When the job finishes, Studio adds the lines to that clip and says "Captions added to" with the clip's name.

If the clip already has caption lines, Studio asks first: **Replace those lines** or **Keep mine**. Lines on other clips stay as they are. Captions you've paid for still arrive after you reload the page or reopen the project. If the clip was removed in the meantime, Studio tells you the captions are ready but the clip is no longer on the timeline.

Frameleaf Cloud captions one clip at a time, in whole lines, so [word-by-word styles](https://frameleaf.app/docs/studio/caption-styles/) can't follow each word. Use **This device** when you want words to light up as they're spoken.

### Several clips on Frameleaf Cloud

To caption several clips at once, select them on the timeline, right-click one of them and choose **Captions for N clips on Frameleaf Cloud…**, where N is the number of clips you selected. There's no limit on how many you select.

1. The list shows every selected clip with its length. Pick one **Language** for the whole batch. A clip with nothing to caption says **No sound**, and a clip whose Cloud captions are already running says **Already being captioned**; both are left out. A video and its linked sound count as one clip.
2. Select **Review the prices**. **Captions on Frameleaf Cloud · clip 1 of 3** opens for the first clip, with every clip of the batch listed at the top and its estimate beside it.
3. Each clip is confirmed on its own; there's no button that sends them all. Confirm this clip to send it, or choose **Skip this clip** to move on without sending it. **Stop here**, or closing the dialog, ends the batch: nothing more is sent, and clips you've already confirmed keep going in **Activity**.

As you go, the list marks each clip **Sent** or **Skipped**. Nothing is sent or charged for a clip until you confirm it. Each finished clip gets its lines just as a single clip does, including **Replace those lines** or **Keep mine** for a clip that already has caption lines.

To see what a project's Cloud jobs cost, open **More**, then **Cloud job receipts**. See [Frameleaf Cloud jobs in a project](https://frameleaf.app/docs/studio/overview/#frameleaf-cloud-jobs-in-a-project) and [Cloud GPU](https://frameleaf.app/docs/cloud/cloud-gpu/).

### Work with captions

To cut the video by its words, name the speakers or fix a misheard word, use [Edit by transcript](https://frameleaf.app/docs/studio/edit-by-transcript/). A word you fix there is fixed in the captions made from it too.

To make words light up or pop in as they're spoken, see [Word-by-word captions](https://frameleaf.app/docs/studio/caption-styles/). To translate captions and make a voice-over in another language, see [Captions in other languages](https://frameleaf.app/docs/studio/caption-languages/).

### Check caption quality

**Caption quality** lists captions that may be hard to read. It appears in the clip panel when you select a caption, a subtitle or a clip with captions, and stays reachable with nothing selected. A film with no captions doesn't show it. The title shows how many lines need a look.

| Warning | What it means |
| --- | --- |
| **Too fast to read (over 20 characters a second)** | The line is on screen too briefly for its length |
| More than two lines | The caption is too tall |
| **Overlaps another caption on this track** | Two captions show at once |
| **Starts before the film or runs past its end** | Part of the caption is never seen |
| **Has no time on screen** | The caption has no length |

Translated captions are checked too. Choose a warning to go to that caption, then fix it as you like. The checks are advice only: nothing is changed for you, and warnings never block an export.

### Captions in the export

The export dialog's **Subtitles** setting decides how captions go out:

| Subtitles | What you get |
| --- | --- |
| **Burn in** | Captions are drawn into the picture |
| **Embedded MP4 text track (default)** | A caption track inside the file that viewers can switch on, where the format supports it |
| **Separate SRT file** | A subtitle file saved next to the export |
| **Off** | No captions |

Other caption languages go out as their own subtitle files, and the dialog lists them. Export a short part of the film first to check timing, text and appearance. See [Exporting](https://frameleaf.app/docs/studio/exporting/#subtitles).

## Voice-over

Type a script and Studio reads it aloud, placing the result on the voice track. Voice-overs are made on your own hardware, with several voices included. They don't use Frameleaf Cloud.

You can also record your own voice-over with a microphone. See [Audio and music](https://frameleaf.app/docs/studio/audio/#voice-over).
