Skip to content

Where the transcript's words come from

The Transcript tab needs no setting up. It uses a transcript you already have, or transcribes the file on this Mac the first time you look, which the tab calls reading it. Either way it sends nothing anywhere.

Where
Inspector ▸ Transcript
Needs
A speech model on this Mac, for any file with no AssemblyAI transcript.
Agent tools
get_timeline_transcriptget_transcript

For each file, the tab takes the first of these it finds:

  1. An AssemblyAI transcript. You have one if you’ve used File ▸ Generate Captions… with AssemblyAI or Remove Filler Words on the file. Using it needs no key.
  2. A reading on this Mac. Otherwise the tab transcribes the file the first time you look, in your Mac’s language unless you choose another.

Reading on this Mac is quick: about 0.7 seconds a minute of speech on an M2 Max, so an hour takes well under a minute. Playback keeps running while it reads.

The tab never makes a network request, whichever source it uses.

Files are read one at a time, starting with the one under the playhead. Each file’s words appear as soon as it’s done, without waiting for the rest.

If you switch to another tab, the reading stops, and it picks up when you come back. To stop it yourself, use Stop.

What this Mac heard is kept in the project’s cache, one reading for each file and language, so the next look is immediate.

Each file is read whole, once. Trimming a clip, adding another clip of the same file or changing its speed doesn’t read it again.

A reading is used only while the file and the macOS version are the same. If either changes, or you choose another language, the file is read again.

These readings are only for the transcript. Captions and Remove Filler Words never use them.

If your Mac has no speech model, the tab says:

This Mac has no speech model installed. Choose File ▸ Generate Captions…, pick a language and press Download.

Do that, then come back to the tab. A file with an AssemblyAI transcript shows its words in the meantime.

A file this Mac can’t read is named in the same place, and the tab carries on with the others. It tries that file again when you next come back to the tab.

Words are placed through a clip’s speed, including a ramp, so a word’s time matches what plays on the timeline.

Editing the timeline updates the text right away, and the words you were reading stay where they were. During a drag, the text updates when you let go.

An agent reads these words with get_timeline_transcript, or one clip’s with get_transcript. When it reads a file on this Mac, the tab’s Stop leaves that reading running. The Assistant’s own Stop ends it, unless the tab is reading that file too, and nothing is saved from a stopped reading. See get_timeline_transcript and get_transcript.