Boxed Line Captions

Everything below can be changed without touching the animation. Hand the list to an agent, or edit the values at the bottom of the component file.

• Srt

  srt · string

  Paste an SRT or WebVTT file's text. When it has cues it replaces `words`, and each cue's words share its time by length. A transcript longer than the clip plays as far as the composition runs, so lengthen the composition to show all of it.

• Words

  words · array

  The transcript as timed words, exactly as a transcription tool exports them. Used when `srt` is empty. Each caption appears on its first word's start, so the timings are what keep the boxes in step with your voice.

  now: 23 items

• Max words

  maxWords · number

  Most words on screen at once. The native look is three to five, wrapped onto one or two lines; a full stop, a subtitle cue or a pause of more than 0.6 s always starts a new screen early.

  now: 5

• Emphasis

  emphasis · array

  Words that take the accent colour: prices, numbers, names, the word the sentence is about. Matched ignoring case and punctuation, so 'berlin' catches 'Berlin.'. Two or three per clip keeps them meaning something.

  now: 3 items

• Position

  position · "lower" | "center" | "upper"

  Where the stack of boxes sits. Lower keeps its foot above the app's bottom 18%, where the caption and sound bar live; upper clears the top tabs. Nothing ever enters the right 12%, where the like and share buttons are.

  now: lower

• Box style

  boxStyle · "white" | "black" | "accent"

  The box fill. White with dark type is the platform default and reads over anything; black with white type suits bright footage; accent fills the box with the brand colour and flips emphasis words onto a white chip.

  now: white

• Scale

  scale · number

  Type size. 1 is about 96 px on a 1080-wide vertical video, the size of the app's own text boxes. A screen that would run into the like buttons shrinks on its own, so a larger size costs nothing on short lines.

  now: 1

• Stage

  stage · boolean

  Draw the stand-in shot behind the captions: a shopping street in low golden-hour sun, walked down, soft-focus. It is only there so the boxes can be judged over real tone. Switch it off when you put the captions over your own video.

  now: true

• Ground

  ground · boolean

  Paint a plain brand ground behind the captions when the stand-in is off. Off by default: with both off the captions render on a transparent background and drop straight onto your footage.

  now: false

• Brand

  brand · string

  Brand token id, one of the keys of BRANDS. Sets the type colour and the accent, and the stand-in street's colours are all worked out from it.

  now: beacon