Skip to content

Captions that fit on two lines, corrected words, and a transcript to download - #91

Merged
pallaoro merged 2 commits into
mainfrom
captions-transcript-feedback
Nov 11, 2026
Merged

pallaoro merged 2 commits into
mainfrom
captions-transcript-feedback

Conversation

@pallaoro

Copy link
Copy Markdown
Member

From a client call: captions on vertical clips were large and wrapped to three lines, there was no way to fix a caption's words or to get a video's transcript out, and on a small laptop screen the Captions tab could not be reached.

What changes

  • Caption size is a share of the frame's shorter side, not its height. On a 1080×1920 video "Medium" was 106 px (17 characters a line, against captions of up to 32); it is now 59 px, the same as on a 1080p wide video. Wide and square videos do not change. Existing vertical projects get smaller captions.
  • Two lines at most: a caption's length is cut down where the chosen line length would not fit on two lines, and wrapLines no longer spends a third line when words do not split evenly (it affects text overlays too, only where they wrapped to more lines than the width needs).
  • Extra small size (XS, 0.035).
  • Correct the words: the Captions panel lists what is said on the timeline, cue by cue; editing one saves it to the clip's transcript (PUT /api/assets/{id}/transcript/cues), so every video cut from that clip shows it.
  • Download transcript: GET /api/assets/{id}/transcript/text, one [m:ss] words line per cue. Linked from the Captions panel and from a library video's hover controls.
  • Short screens: the rail's tabs are icons only under 820 px of height, and the column scrolls.

Known limit

Asking for a transcript in another language replaces the kept one, corrections included (there is one transcript per clip). Stated in agent.md.

Checked

  • pnpm typecheck, pnpm test (314), pnpm test:e2e pass; new unit tests for sizing, the two-line rule over every size, line length and shape, and the VTT round trip; e2e for both routes.
  • Run locally in a browser at 1271×628: all six tabs reachable, the panel scrolls, a vertical video at Large shows two even lines, a corrected cue is saved and shown.
  • Not checked in a browser: the library tile's download button (it shows only for videos on the media service, which a local run does not have).

…download

Caption size is now a share of the frame's shorter side. As a share of the
height, the same setting was nearly twice as large on a vertical video, each
line held half the words, and captions wrapped to three lines. A caption is
also kept to what fits on two lines, and there is an extra small size.

What a cue says can be corrected in the Captions panel; the fix is kept in the
clip's transcript, so every video cut from it shows it. A video's transcript
downloads as text with times, from the Captions panel and from a library
video's hover controls.

On a short screen the rail's last tabs (Captions, Review) were below the fold
with no way to reach them: the tabs are icons only there, and the column
scrolls.
@pallaoro
pallaoro merged commit 8f9319d into main Nov 11, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant