render

name	render
description	Render a Remotion composition to a video file in out/. Use when the user wants to export an animation they previewed.
disable-model-invocation	true

Render a composition

Input: $ARGUMENTS = composition id (and optional output name). If empty, list the compositions registered in src/Root.tsx and ask which to render.

Steps

1. Pick the composition id (must match an id in src/Root.tsx: TitleCard, LowerThird, CountUp, or a newer one).
2. Render:
   • Standard opaque scene (TitleCard, CountUp): npm run render <id> out/<name>.mp4
   • Transparent overlay (LowerThird or anything meant to sit on footage): npm run render <id> out/<name>.mov --codec=prores --image-format=png
   • To override props: add --props='{"key":"value"}'.
   • Note: the very first render downloads a headless Chromium (one-time, slower).
3. Confirm the output file exists in out/ and report its path + duration.

Compositing with footage

To lay an overlay/intro over cleaned footage, either import both into Remotion and sequence them, or use local ffmpeg (e.g. ffmpeg -i base.mp4 -i overlay.mov -filter_complex overlay ...). ffmpeg edits stay fully local (no upload).