Files
hyperframes/docs/guides/captions-and-recuts.mdx
ukimsanov c669616370 docs: name the two workflows the captions page covers
There are ten creation workflows — confirmed against both
skills/hyperframes/references/routes/ and the skill directories, which agree.
Nine were findable. Two were not.

This page covers `/embedded-captions` and `/talking-head-recut` and named neither
of them, anywhere, once. It described the difference well — "add captions" versus
"add designed overlays" — but a reader who wanted to invoke one directly had no
way to learn what it was called, and neither name appears in the navigation.

Both are now named where the distinction is drawn, with what each actually does:
words on screen versus designed cards on screen, and the reminder that both leave
the footage untouched.

remotion-to-hyperframes checks out — it is named on three pages including the
Remotion comparison, so it was reachable already.
2026-08-04 15:24:43 -07:00

82 lines
3.3 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?
This page covers two workflows. `/hyperframes` picks between them from what you
ask for, and you can name one directly if you already know which you want.
- **Words on screen** — `/embedded-captions`. Readable, timed words over the clip.
Plain subtitles, or cinematic captions set behind the subject.
- **Designed cards on screen** — `/talking-head-recut`. Titles, pull-quotes, data
callouts, lower thirds, picture-in-picture, synced to the transcript.
- **Change the footage itself** — neither of these. Use
[General 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, use [General Video](/guides/general-video).
## Before it builds
Confirm:
- **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.
<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 workflow](/guides/general-video)