Files
hyperframes/docs/guides/captions-and-recuts.mdx

84 lines
3.4 KiB
Plaintext

---
title: "Add captions or repackage talking-head footage"
sidebarTitle: "Captions and talking head"
description: "Add captions, add designed overlays, or change the spoken edit."
---
import { DocsVideo } from "/snippets/docs-video.jsx";
<DocsVideo
title="Five caption treatments on the same untouched clip"
src="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/captions-recut-demo-v1.mp4"
poster="https://static.heygen.ai/hyperframes-oss/docs/images/showcase/captions-recut-demo-v1.jpg"
/>
A verbatim rail, an embedded climax word, kinetic emphasis, a lower third and a
pull-quote. The footage underneath is never re-edited — the overlays carry all
of it.
## Make the request
Name the file and the change you want:
```text
Using /hyperframes, add clear animated captions to assets/interview.mp4.
Keep the footage and its spoken edit unchanged.
```
Ask for designed information cards instead when the footage needs titles,
quotes, statistics, lower thirds, or picture-in-picture.
## What should change?
Say which of these you want; `/hyperframes` handles both.
- **Words on screen** — readable, timed words over the clip. Plain subtitles, or
cinematic captions set behind the subject.
- **Designed cards on screen** — titles, pull-quotes, data callouts, lower
thirds, picture-in-picture, synced to the transcript.
- **Change the footage itself** — neither of these. Make a
[custom video](/guides/general-video) when pauses, selected moments, or the
spoken order must change.
Both leave the clip and its audio untouched: the first adds words, the second adds
graphics, and the footage plays the same underneath either way.
Captions and designed overlays work best on a clear, single-subject clip with audible speech. Both keep the original footage and audio intact.
If you need to remove pauses, choose different moments, or reorder the speech, make a [custom video](/guides/general-video).
## Before it builds
Settle these in the request, or ask the agent to propose them first:
- **Captions:** the intended format and any names or terms the transcript may miss. HyperFrames can recommend a visual treatment after it sees the clip.
- **Designed overlays:** the format, layout, visual style, and how often a title, quote, statistic, or side panel should appear.
- **Either path:** where the speaker, existing text, and important action leave safe room for graphics.
## Review what matters
- Names, product terms, and numbers are correct.
- Captions follow the spoken words.
- Graphics avoid faces and important parts of the footage.
- The video works with sound and muted.
- The final caption or graphic clears before the video ends.
For direct placement changes, use [Captions in Studio](/studio/captions) to
inspect synchronization and save position, scale, or rotation corrections. Ask
the agent or edit the caption source for corrected words and durable timing or
style changes.
To import replacement words, run `hyperframes transcribe transcript.json --dir ./my-video`.
This replaces the full transcript in existing caption HTML and keeps the surrounding caption code.
<Card title="Finish and share" icon="circle-check" href="/guides/export-and-share">
Review the chosen caption, overlay, or recut path, then render and watch the final file.
</Card>
## Related topics
- [Edit captions in Studio](/studio/captions)
- [Work with voice, music, sound, and captions](/guides/voice-and-audio)
- [Change the spoken edit with a custom video](/guides/general-video)