npx remotion render

Render a video or audio based on the entry point, the composition ID and save it to the output location.

npx remotion render <entry-point|serve-url>? <composition-id> <output-location>

You may pass a Serve URL or an entry point as the first argument, otherwise the entry point will be determined.

If composition-id is not passed, Remotion will ask you to select a composition.
If output-location is not passed, the media will be rendered into the out folder.

Flags

Besides choosing a video and output location with the command line arguments, the following flags are supported:

--props

:::note Inline JSON string isn't supported on Windows shells because it removes the " character, use a file name instead. :::

--height<AvailableFrom v="3.2.40" />

--width<AvailableFrom v="3.2.40" />

--fps<AvailableFrom v="4.0.424" />

--duration<AvailableFrom v="4.0.424" />

--concurrency

--pixel-format

--image-format<AvailableFrom v="1.4.0" />

--image-sequence-pattern<AvailableFrom v="4.0.313" />

--config<AvailableFrom v="1.2.0" />

--env-file<AvailableFrom v="2.2.0" />

--jpeg-quality<AvailableFrom v="4.0.0" />

Value between 0 and 100 for JPEG rendering quality. Doesn't work when PNG frames are rendered.

--quality<AvailableFrom v="1.4.0" />

Renamed to --jpeg-quality in v4.0.0

--output <AvailableFrom v="4.0.0" />

Sets the output file path, as an alternative to the output-location positional argument.

--overwrite

Write to output even if file already exists.. This flag is enabled by default, use --overwrite=false to disable it.

--sequence<AvailableFrom v="1.4.0" />

--codec<AvailableFrom v="1.4.0" />

h264 or h265 or av1 or png or vp8 or vp9 or mp3 or aac or wav or prores or h264-mkv. If you don't supply --codec, it will use the H.264 encoder.

If you are rendering on Linux ARM64 GNU, av1 is not available.

--audio-codec<AvailableFrom v="3.3.42" />

--audio-bitrate<AvailableFrom v="3.2.32" />

--video-bitrate<AvailableFrom v="3.2.32" />

--buffer-size<AvailableFrom v="4.0.78" />

--max-rate<AvailableFrom v="4.0.78" />

--prores-profile<AvailableFrom v="2.1.6" />

--x264-preset<AvailableFrom v="4.2.2" />

--crf<AvailableFrom v="1.4.0" />

To set Constant Rate Factor (CRF) of the output. Minimum 0. Use this rate control mode if you want to keep the best quality and care less about the file size. This option cannot be set if --video-bitrate is set.

:::note If you enable hardware acceleration, you cannot set a crf. Use the --video-bitrate option instead. :::

--browser-executable<AvailableFrom v="1.5.0" />

--chrome-mode<AvailableFrom v="4.0.248" />

--scale

Scales the output frames by the factor you pass in. For example, a 1280x720px frame will become a 1920x1080px frame with a scale factor of 1.5. Vector elements like fonts and HTML markups will be rendered with extra details. scale must be greater than 0 and less than equal to 16. Default: 1.

--frames<AvailableFrom v="2.0.0" />

--every-nth-frame<AvailableFrom v="3.1.0" />

For example only every second frame, every third frame and so on. Only works for rendering GIFs. See here for more details.

--muted<AvailableFrom v="3.2.1" />

Disables audio output. This option may only be used when rendering a video.

--enforce-audio-track<AvailableFrom v="3.2.1" />

Render a silent audio track if there wouldn't be one otherwise..

--disallow-parallel-encoding<AvailableFrom v="4.0.315" />

Disallows the renderer from doing rendering frames and encoding at the same time. This makes the rendering process more memory-efficient, but possibly slower.

--number-of-gif-loops<AvailableFrom v="3.1.0" />

--color-space<AvailableFrom v="4.0.28"/>

--hardware-acceleration<AvailableFrom v="4.0.228" />

--bundle-cache<AvailableFrom v="2.0.0" />

--log

Set the log level. Increase or decrease the amount of output. Acceptable values: error, warn, info (default), verbose

--port

--public-dir<AvailableFrom v="3.2.13" />

--timeout

Define how long a single frame may take to resolve all delayRender() calls before it times out in milliseconds. Default: 30000.

:::info Not to be confused with the --timeout flag when deploying a Lambda function. :::

--ignore-certificate-errors<AvailableFrom v="2.6.5" />

--disable-web-security<AvailableFrom v="2.6.5" />

--disable-headless<AvailableFrom v="2.6.5" />

--dark-mode<AvailableFrom v="4.0.381"/>

--gl

--user-agent<AvailableFrom v="3.3.83"/>

--media-cache-size-in-bytes<AvailableFrom v="4.0.352"/>

--offthreadvideo-cache-size-in-bytes<AvailableFrom v="4.0.23"/>

--offthreadvideo-video-threads<AvailableFrom v="4.0.261"/>

--enable-multiprocess-on-linux<AvailableFrom v="4.0.42"/>

--repro<AvailableFrom v="4.0.88" />

--binaries-directory<AvailableFrom v="4.0.120" />

--experimental-rspack<AvailableFrom v="4.0.426" />

--sample-rate<AvailableFrom v="4.0.448" />

--for-seamless-aac-concatenation<AvailableFrom v="4.0.123" />

--separate-audio-to<AvailableFrom v="4.0.123" />

--metadata<AvailableFrom v="4.0.216" />

--ffmpeg-executable

removed in v4.0

Set a custom ffmpeg executable. If not defined, a ffmpeg executable will be searched in PATH.

--ffprobe-executable <AvailableFrom v="3.0.17" />

removed in v4.0

Set a custom ffprobe executable. If not defined, a ffprobe executable will be searched in PATH.