Reframe Aspect Ratio

reframe

Re-aspect a video to 16:9, 9:16, 1:1, or 4:5 by padding or cropping.

producewritesdestructivesince v0.8.0

00:00PARAMETERS

Name	Type	Description
`input` required	`string`	Path to the source video.
`aspect` required	`"16:9" \| "9:16" \| "1:1" \| "4:5"`	Target aspect ratio.
`fit`	`"pad" \| "crop"`	pad (default): letterbox, nothing lost. crop: fill and center-crop.
`output`	`string`	Optional output path. Defaults under SCREENCAST_HOME/edits.
`overwrite`	`boolean`	Allow replacing an existing file at the output path (default false).

00:05A MINIMAL CALL

reframe { "input": "recording.mp4", "aspect": "16:9" }

The required arguments only, with placeholder values. Everything else takes its default.

00:10WHAT COMES BACK

Structured content (structuredContent), alongside a text summary:

Field	Type	Description
`outputPath` always	`string`	Path of the file written.

00:15SEEN IN