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 and prores. 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.

Codec File extension File size Encoding time Browser compatibility
H.264 also known as MPEG-4 .mp4 or .mkv Large Very fast Very good
H.265 also known as HEVC .mp4 or .hevc Medium Fast Very poor
VP8 .webm Small Slow Okay
VP9 .webm Very small Very slow Okay
ProRes .mov Large Fast None
info

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

You can set a config using Config.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:

Changelog
  • 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.
Codec Minimum - Best quality Maximum - Best compression Default
H264 1 51 18
H265 0 51 23
VP8 4 63 9
VP9 0 63 28

You can set a CRF in the config file using the Config.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.

Value FFMPEG setting Bitrate Supports alpha channel
"proxy" 0 ~45Mbps No
"light" 1 ~102Mbps No
"standard" (default) 2 ~147Mbps No
"hq" 3 ~220Mbps No
"4444" 4 ~330Mbps Yes
"4444-xq" 4 ~500Mbps Yes

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.

GIFs

You can also render your video as a GIF.

Audio codec

available from v3.3.42

Using the --audio-codec flag, you can set the format of the audio that is embedded in the video. Not all codec and audio codec combinations are supported and certain combinations require a certain file extension and container format.

The container format will be automatically derived based on the file extension.

import {SupportedAudioCodecTable, FileExtensionTable} from '../components/SupportedAudioCodec';

GIFs don't support audio.

* Note: In versions before v4.0.0 the default audio codec for ProRes was aac. Now it's pcm-16.

File extensions

Specifying a file extension when rendering media will determine the default codec. You may override the codec using --codec as long as the combination is supported in the table above.

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