Skip to main content

Encoding Guide

Backed by FFMPEG, Remotion allows you to configure a variety of encoding settings. The goal of this page is to help you navigate through the settings and to help you choose the right one.

Choosing a codec#

Remotion supports 5 video codecs: h264 (default), h265, vp8, vp9, prores. The first two produce an output that will be an MP4, the last two are for generating WebM videos. While H264 will work well in most cases, sometimes it's worth going for a different codec. Refer to the table below to see the advantages and drawbacks of each codec.

CodecFile extensionFile sizeRendering timeBrowser compatibility
H.264 also known as MPEG-4.mp4LargeVery fastVery good
H.265 also known as HEVC.mp4 or .hevcMediumFastVery poor
VP9.webmVery smallVery slowOkay

Click on a browser compatibility link to see exactly which browsers are supported on

You can set a config using Config.Output.setCodec() in the config file or the --codec CLI flag.

Controlling quality using the CRF setting#

Applies only to h264, h265, vp8 and vp9.

No matter which codec you end up using, there's always a tradeoff between file size and video quality. You can control it by setting the so called CRF (Constant Rate Factor). The lower the number, the better the quality, the higher the number, the smaller the file is โ€“ of course at the cost of quality.

Be cautious: Every codec has it's own range of acceptable values and a different default. So while 23 will look very good on a H264 video, it will look terrible on a WebM video. Use this chart to determine which CRF value to use:

  • Since version 2.1.3, Remotion doesn't allow the CRF to be set to 0 anymore because of the issues it causes on macOS/iOS and possible other scenarios. Set the CRF to 1 or higher.
CodecMinimum - Best qualityMaximum - Best compressionDefault

You can set a CRF in the config file using the Config.Output.setCrf() function or use the --crf command line flag.

Controlling quality using ProRes profile#

Applies only to prores codec.

For ProRes, there is no CRF option, but there are profiles which you can set using the --prores-profile flag or the setProResProfile config file option.

ValueFFMPEG settingBitrateSupports alpha channel
"standard" (default)2~147MbpsNo

Higher bitrate means higher quality and higher file size.

Audio-only export#

You can pass mp3, wav or aac as a codec. If you do it, an audio file will be output in the corresponding format. Quality settings will be ignored.

What other settings do you need?#

Which of the dozens of options that FFMPEG supports would you like to see exposed in Remotion? Let us know by opening an issue on our issue tracker!

See also#