Skip to content

encoders

FFmpeg encoders.

Functions:

Name Description
a64multi

(codec a64_multi)

a64multi5

(codec a64_multi5)

aac

Args:

ac3

Args:

ac3_fixed

(codec ac3)

adpcm_adx

Returns:

adpcm_argo

Args:

adpcm_ima_alp

Args:

adpcm_ima_amv

Args:

adpcm_ima_apm

Args:

adpcm_ima_qt

Args:

adpcm_ima_ssi

Args:

adpcm_ima_wav

Args:

adpcm_ima_ws

Args:

adpcm_ms

Args:

adpcm_swf

Args:

adpcm_yamaha

Args:

alac

Args:

alias_pix

Returns:

amv

Args:

apng

Args:

aptx

Returns:

aptx_hd

Returns:

ass

Returns:

asv1

Returns:

asv2

Returns:

avrp

Returns:

avui

Returns:

ayuv

Returns:

bitpacked

Returns:

bmp

Returns:

cfhd

Args:

cinepak

Args:

cljr

Args:

comfortnoise

Returns:

dca

(codec dts)

dfpwm

Returns:

dnxhd

Args:

dpx

Returns:

dvbsub

(codec dvb_subtitle)

dvdsub

(codec dvd_subtitle)

dvvideo

Args:

eac3

Args:

exr

Args:

ffv1

Args:

ffvhuff

Args:

fits

Returns:

flac

Args:

flashsv

Returns:

flashsv2

Returns:

flv

(codec flv1)

g722

(codec adpcm_g722)

g723_1

Returns:

g726

(codec adpcm_g726)

g726le

(codec adpcm_g726le)

gif

Args:

h261

Args:

h263

Args:

h263_v4l2m2m

(codec h263)

h263p

Args:

h264_v4l2m2m

(codec h264)

hevc_v4l2m2m

(codec hevc)

huffyuv

Args:

jpeg2000

Args:

jpegls

Args:

libfdk_aac

(codec aac)

libkvazaar

(codec hevc)

libmp3lame

(codec mp3)

libopencore_amrnb

(codec amr_nb)

libopenjpeg

(codec jpeg2000)

libopus

(codec opus)

libtheora

(codec theora)

libvorbis

(codec vorbis)

libvpx

(codec vp8)

libwebp

(codec webp)

libx264

(codec h264)

libx264rgb

(codec h264)

libx265

(codec hevc)

libxvid

(codec mpeg4)

ljpeg

Args:

magicyuv

Args:

mjpeg

Args:

mlp

Returns:

mov_text

Args:

mp2

Returns:

mp2fixed

(codec mp2)

mpeg1video

Args:

mpeg2video

Args:

mpeg4

Args:

mpeg4_v4l2m2m

(codec mpeg4)

msmpeg4

(codec msmpeg4v3)

msmpeg4v2

Args:

msvideo1

Returns:

nellymoser

Returns:

opus

Args:

pam

Returns:

pbm

Returns:

pcm_alaw

Returns:

pcm_bluray

Returns:

pcm_dvd

Returns:

pcm_f32be

Returns:

pcm_f32le

Returns:

pcm_f64be

Returns:

pcm_f64le

Returns:

pcm_mulaw

Returns:

pcm_s16be

Returns:

pcm_s16be_planar

Returns:

pcm_s16le

Returns:

pcm_s16le_planar

Returns:

pcm_s24be

Returns:

pcm_s24daud

Returns:

pcm_s24le

Returns:

pcm_s24le_planar

Returns:

pcm_s32be

Returns:

pcm_s32le

Returns:

pcm_s32le_planar

Returns:

pcm_s64be

Returns:

pcm_s64le

Returns:

pcm_s8

Returns:

pcm_s8_planar

Returns:

pcm_u16be

Returns:

pcm_u16le

Returns:

pcm_u24be

Returns:

pcm_u24le

Returns:

pcm_u32be

Returns:

pcm_u32le

Returns:

pcm_u8

Returns:

pcm_vidc

Returns:

pcx

Returns:

pfm

Returns:

pgm

Returns:

pgmyuv

Returns:

phm

Returns:

png

Args:

ppm

Returns:

prores

Args:

prores_aw

(codec prores)

prores_ks

(codec prores)

qoi

Returns:

qtrle

Returns:

r10k

Returns:

r210

Returns:

rawvideo

Returns:

real_144

(codec ra_144)

roq_dpcm

Returns:

roqvideo

(codec roq)

rpza

Args:

rv10

Args:

rv20

Args:

s302m

Returns:

sbc

Args:

sgi

Args:

smc

Returns:

snow

Args:

sonic

Returns:

sonicls

Returns:

speedhq

Args:

srt

(codec subrip)

ssa

(codec ass)

subrip

Returns:

sunrast

Args:

svq1

Args:

targa

Args:

text

Returns:

tiff

Args:

truehd

Returns:

tta

Returns:

ttml

Returns:

utvideo

Args:

v210

Returns:

v308

Returns:

v408

Returns:

v410

Returns:

vbn

Args:

vc2

(codec dirac)

vorbis

Returns:

vp8_v4l2m2m

(codec vp8)

wavpack

Args:

webvtt

Returns:

wmav1

Returns:

wmav2

Returns:

wmv1

Args:

wmv2

Args:

wrapped_avframe

Returns:

xbm

Returns:

xface

Returns:

xsub

Returns:

xwd

Returns:

y41p

Returns:

yuv4

Returns:

zlib

Returns:

zmbv

Returns:

a64multi

a64multi() -> FFMpegEncoderOption

(codec a64_multi)

Returns:

Type Description
FFMpegEncoderOption

the set codec options

a64multi5

a64multi5() -> FFMpegEncoderOption

(codec a64_multi5)

Returns:

Type Description
FFMpegEncoderOption

the set codec options

aac

aac(
    aac_coder: (
        int | None | Literal["anmr", "twoloop", "fast"]
    ) = None,
    aac_ms: bool | None = None,
    aac_is: bool | None = None,
    aac_pns: bool | None = None,
    aac_tns: bool | None = None,
    aac_ltp: bool | None = None,
    aac_pred: bool | None = None,
    aac_pce: bool | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
aac_coder int | None | Literal['anmr', 'twoloop', 'fast']

Coding algorithm (from 0 to 2) (default twoloop)

None
aac_ms bool | None

Force M/S stereo coding (default auto)

None
aac_is bool | None

Intensity stereo coding (default true)

None
aac_pns bool | None

Perceptual noise substitution (default true)

None
aac_tns bool | None

Temporal noise shaping (default true)

None
aac_ltp bool | None

Long term prediction (default false)

None
aac_pred bool | None

AAC-Main prediction (default false)

None
aac_pce bool | None

Forces the use of PCEs (default false)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

ac3

ac3(
    center_mixlev: float | None = None,
    surround_mixlev: float | None = None,
    mixing_level: int | None = None,
    room_type: (
        int
        | None
        | Literal["notindicated", "large", "small"]
    ) = None,
    per_frame_metadata: bool | None = None,
    copyright: int | None = None,
    dialnorm: int | None = None,
    dsur_mode: (
        int | None | Literal["notindicated", "on", "off"]
    ) = None,
    original: int | None = None,
    dmix_mode: (
        int
        | None
        | Literal["notindicated", "ltrt", "loro", "dplii"]
    ) = None,
    ltrt_cmixlev: float | None = None,
    ltrt_surmixlev: float | None = None,
    loro_cmixlev: float | None = None,
    loro_surmixlev: float | None = None,
    dsurex_mode: (
        int
        | None
        | Literal["notindicated", "on", "off", "dpliiz"]
    ) = None,
    dheadphone_mode: (
        int | None | Literal["notindicated", "on", "off"]
    ) = None,
    ad_conv_type: (
        int | None | Literal["standard", "hdcd"]
    ) = None,
    stereo_rematrixing: bool | None = None,
    channel_coupling: int | None | Literal["auto"] = None,
    cpl_start_band: int | None | Literal["auto"] = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
center_mixlev float | None

Center Mix Level (from 0 to 1) (default 0.594604)

None
surround_mixlev float | None

Surround Mix Level (from 0 to 1) (default 0.5)

None
mixing_level int | None

Mixing Level (from -1 to 111) (default -1)

None
room_type int | None | Literal['notindicated', 'large', 'small']

Room Type (from -1 to 2) (default -1)

None
per_frame_metadata bool | None

Allow Changing Metadata Per-Frame (default false)

None
copyright int | None

Copyright Bit (from -1 to 1) (default -1)

None
dialnorm int | None

Dialogue Level (dB) (from -31 to -1) (default -31)

None
dsur_mode int | None | Literal['notindicated', 'on', 'off']

Dolby Surround Mode (from -1 to 2) (default -1)

None
original int | None

Original Bit Stream (from -1 to 1) (default -1)

None
dmix_mode int | None | Literal['notindicated', 'ltrt', 'loro', 'dplii']

Preferred Stereo Downmix Mode (from -1 to 3) (default -1)

None
ltrt_cmixlev float | None

Lt/Rt Center Mix Level (from -1 to 2) (default -1)

None
ltrt_surmixlev float | None

Lt/Rt Surround Mix Level (from -1 to 2) (default -1)

None
loro_cmixlev float | None

Lo/Ro Center Mix Level (from -1 to 2) (default -1)

None
loro_surmixlev float | None

Lo/Ro Surround Mix Level (from -1 to 2) (default -1)

None
dsurex_mode int | None | Literal['notindicated', 'on', 'off', 'dpliiz']

Dolby Surround EX Mode (from -1 to 3) (default -1)

None
dheadphone_mode int | None | Literal['notindicated', 'on', 'off']

Dolby Headphone Mode (from -1 to 2) (default -1)

None
ad_conv_type int | None | Literal['standard', 'hdcd']

A/D Converter Type (from -1 to 1) (default -1)

None
stereo_rematrixing bool | None

Stereo Rematrixing (default true)

None
channel_coupling int | None | Literal['auto']

Channel Coupling (from -1 to 1) (default auto)

None
cpl_start_band int | None | Literal['auto']

Coupling Start Band (from -1 to 15) (default auto)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

ac3_fixed

ac3_fixed(
    center_mixlev: float | None = None,
    surround_mixlev: float | None = None,
    mixing_level: int | None = None,
    room_type: (
        int
        | None
        | Literal["notindicated", "large", "small"]
    ) = None,
    per_frame_metadata: bool | None = None,
    copyright: int | None = None,
    dialnorm: int | None = None,
    dsur_mode: (
        int | None | Literal["notindicated", "on", "off"]
    ) = None,
    original: int | None = None,
    dmix_mode: (
        int
        | None
        | Literal["notindicated", "ltrt", "loro", "dplii"]
    ) = None,
    ltrt_cmixlev: float | None = None,
    ltrt_surmixlev: float | None = None,
    loro_cmixlev: float | None = None,
    loro_surmixlev: float | None = None,
    dsurex_mode: (
        int
        | None
        | Literal["notindicated", "on", "off", "dpliiz"]
    ) = None,
    dheadphone_mode: (
        int | None | Literal["notindicated", "on", "off"]
    ) = None,
    ad_conv_type: (
        int | None | Literal["standard", "hdcd"]
    ) = None,
    stereo_rematrixing: bool | None = None,
    channel_coupling: int | None | Literal["auto"] = None,
    cpl_start_band: int | None | Literal["auto"] = None,
) -> FFMpegEncoderOption

(codec ac3)

Parameters:

Name Type Description Default
center_mixlev float | None

Center Mix Level (from 0 to 1) (default 0.594604)

None
surround_mixlev float | None

Surround Mix Level (from 0 to 1) (default 0.5)

None
mixing_level int | None

Mixing Level (from -1 to 111) (default -1)

None
room_type int | None | Literal['notindicated', 'large', 'small']

Room Type (from -1 to 2) (default -1)

None
per_frame_metadata bool | None

Allow Changing Metadata Per-Frame (default false)

None
copyright int | None

Copyright Bit (from -1 to 1) (default -1)

None
dialnorm int | None

Dialogue Level (dB) (from -31 to -1) (default -31)

None
dsur_mode int | None | Literal['notindicated', 'on', 'off']

Dolby Surround Mode (from -1 to 2) (default -1)

None
original int | None

Original Bit Stream (from -1 to 1) (default -1)

None
dmix_mode int | None | Literal['notindicated', 'ltrt', 'loro', 'dplii']

Preferred Stereo Downmix Mode (from -1 to 3) (default -1)

None
ltrt_cmixlev float | None

Lt/Rt Center Mix Level (from -1 to 2) (default -1)

None
ltrt_surmixlev float | None

Lt/Rt Surround Mix Level (from -1 to 2) (default -1)

None
loro_cmixlev float | None

Lo/Ro Center Mix Level (from -1 to 2) (default -1)

None
loro_surmixlev float | None

Lo/Ro Surround Mix Level (from -1 to 2) (default -1)

None
dsurex_mode int | None | Literal['notindicated', 'on', 'off', 'dpliiz']

Dolby Surround EX Mode (from -1 to 3) (default -1)

None
dheadphone_mode int | None | Literal['notindicated', 'on', 'off']

Dolby Headphone Mode (from -1 to 2) (default -1)

None
ad_conv_type int | None | Literal['standard', 'hdcd']

A/D Converter Type (from -1 to 1) (default -1)

None
stereo_rematrixing bool | None

Stereo Rematrixing (default true)

None
channel_coupling int | None | Literal['auto']

Channel Coupling (from -1 to 1) (default auto)

None
cpl_start_band int | None | Literal['auto']

Coupling Start Band (from -1 to 15) (default auto)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

adpcm_adx

adpcm_adx() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

adpcm_argo

adpcm_argo(
    block_size: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
block_size int | None

set the block size (from 32 to 8192) (default 1024)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

adpcm_ima_alp

adpcm_ima_alp(
    block_size: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
block_size int | None

set the block size (from 32 to 8192) (default 1024)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

adpcm_ima_amv

adpcm_ima_amv(
    block_size: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
block_size int | None

set the block size (from 32 to 8192) (default 1024)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

adpcm_ima_apm

adpcm_ima_apm(
    block_size: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
block_size int | None

set the block size (from 32 to 8192) (default 1024)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

adpcm_ima_qt

adpcm_ima_qt(
    block_size: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
block_size int | None

set the block size (from 32 to 8192) (default 1024)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

adpcm_ima_ssi

adpcm_ima_ssi(
    block_size: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
block_size int | None

set the block size (from 32 to 8192) (default 1024)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

adpcm_ima_wav

adpcm_ima_wav(
    block_size: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
block_size int | None

set the block size (from 32 to 8192) (default 1024)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

adpcm_ima_ws

adpcm_ima_ws(
    block_size: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
block_size int | None

set the block size (from 32 to 8192) (default 1024)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

adpcm_ms

adpcm_ms(
    block_size: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
block_size int | None

set the block size (from 32 to 8192) (default 1024)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

adpcm_swf

adpcm_swf(
    block_size: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
block_size int | None

set the block size (from 32 to 8192) (default 1024)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

adpcm_yamaha

adpcm_yamaha(
    block_size: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
block_size int | None

set the block size (from 32 to 8192) (default 1024)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

alac

alac(
    min_prediction_order: int | None = None,
    max_prediction_order: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
min_prediction_order int | None

(from 1 to 30) (default 4)

None
max_prediction_order int | None

(from 1 to 30) (default 6)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

alias_pix

alias_pix() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

amv

amv(
    mpv_flags: str | None = None,
    luma_elim_threshold: int | None = None,
    chroma_elim_threshold: int | None = None,
    quantizer_noise_shaping: int | None = None,
    error_rate: int | None = None,
    qsquish: float | None = None,
    rc_qmod_amp: float | None = None,
    rc_qmod_freq: int | None = None,
    rc_eq: str | None = None,
    rc_init_cplx: float | None = None,
    rc_buf_aggressivity: float | None = None,
    border_mask: float | None = None,
    lmin: int | None = None,
    lmax: int | None = None,
    skip_threshold: int | None = None,
    skip_factor: int | None = None,
    skip_exp: int | None = None,
    skip_cmp: (
        int
        | None
        | Literal[
            "sad",
            "sse",
            "satd",
            "dct",
            "psnr",
            "bit",
            "rd",
            "zero",
            "vsad",
            "vsse",
            "nsse",
            "dct264",
            "dctmax",
            "chroma",
            "msad",
        ]
    ) = None,
    sc_threshold: int | None = None,
    noise_reduction: int | None = None,
    ps: int | None = None,
    huffman: (
        int | None | Literal["default", "optimal"]
    ) = None,
    force_duplicated_matrix: bool | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
mpv_flags str | None

Flags common for all mpegvideo-based encoders. (default 0)

None
luma_elim_threshold int | None

single coefficient elimination threshold for luminance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
chroma_elim_threshold int | None

single coefficient elimination threshold for chrominance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
quantizer_noise_shaping int | None

(from 0 to INT_MAX) (default 0)

None
error_rate int | None

Simulate errors in the bitstream to test error concealment. (from 0 to INT_MAX) (default 0)

None
qsquish float | None

how to keep quantizer between qmin and qmax (0 = clip, 1 = use differentiable function) (from 0 to 99) (default 0)

None
rc_qmod_amp float | None

experimental quantizer modulation (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_qmod_freq int | None

experimental quantizer modulation (from INT_MIN to INT_MAX) (default 0)

None
rc_eq str | None

Set rate control equation. When computing the expression, besides the standard functions defined in the section 'Expression Evaluation', the following functions are available: bits2qp(bits), qp2bits(qp). Also the following constants are available: iTex pTex tex mv fCode iCount mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex avgTex.

None
rc_init_cplx float | None

initial complexity for 1-pass encoding (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_buf_aggressivity float | None

currently useless (from -FLT_MAX to FLT_MAX) (default 1)

None
border_mask float | None

increase the quantizer for macroblocks close to borders (from -FLT_MAX to FLT_MAX) (default 0)

None
lmin int | None

minimum Lagrange factor (VBR) (from 0 to INT_MAX) (default 236)

None
lmax int | None

maximum Lagrange factor (VBR) (from 0 to INT_MAX) (default 3658)

None
skip_threshold int | None

Frame skip threshold (from INT_MIN to INT_MAX) (default 0)

None
skip_factor int | None

Frame skip factor (from INT_MIN to INT_MAX) (default 0)

None
skip_exp int | None

Frame skip exponent (from INT_MIN to INT_MAX) (default 0)

None
skip_cmp int | None | Literal['sad', 'sse', 'satd', 'dct', 'psnr', 'bit', 'rd', 'zero', 'vsad', 'vsse', 'nsse', 'dct264', 'dctmax', 'chroma', 'msad']

Frame skip compare function (from INT_MIN to INT_MAX) (default dctmax)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default 0)

None
noise_reduction int | None

Noise reduction (from INT_MIN to INT_MAX) (default 0)

None
ps int | None

RTP payload size in bytes (from INT_MIN to INT_MAX) (default 0)

None
huffman int | None | Literal['default', 'optimal']

Huffman table strategy (from 0 to 1) (default optimal)

None
force_duplicated_matrix bool | None

Always write luma and chroma matrix for mjpeg, useful for rtp streaming. (default false)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

apng

apng(
    dpi: int | None = None,
    dpm: int | None = None,
    pred: (
        int
        | None
        | Literal[
            "none", "sub", "up", "avg", "paeth", "mixed"
        ]
    ) = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
dpi int | None

Set image resolution (in dots per inch) (from 0 to 65536) (default 0)

None
dpm int | None

Set image resolution (in dots per meter) (from 0 to 65536) (default 0)

None
pred int | None | Literal['none', 'sub', 'up', 'avg', 'paeth', 'mixed']

Prediction method (from 0 to 5) (default none)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

aptx

Returns:

Type Description
FFMpegEncoderOption

the set codec options

aptx_hd

aptx_hd() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

ass

Returns:

Type Description
FFMpegEncoderOption

the set codec options

asv1

Returns:

Type Description
FFMpegEncoderOption

the set codec options

asv2

Returns:

Type Description
FFMpegEncoderOption

the set codec options

avrp

Returns:

Type Description
FFMpegEncoderOption

the set codec options

avui

Returns:

Type Description
FFMpegEncoderOption

the set codec options

ayuv

Returns:

Type Description
FFMpegEncoderOption

the set codec options

bitpacked

bitpacked() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

bmp

Returns:

Type Description
FFMpegEncoderOption

the set codec options

cfhd

cfhd(
    quality: (
        int
        | None
        | Literal[
            "film3+",
            "film3",
            "film2+",
            "film2",
            "film1.5",
            "film1+",
            "film1",
            "high+",
            "high",
            "medium+",
            "medium",
            "low+",
            "low",
        ]
    ) = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
quality int | None | Literal['film3+', 'film3', 'film2+', 'film2', 'film1.5', 'film1+', 'film1', 'high+', 'high', 'medium+', 'medium', 'low+', 'low']

set quality (from 0 to 12) (default film3+)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

cinepak

cinepak(
    max_extra_cb_iterations: int | None = None,
    skip_empty_cb: bool | None = None,
    max_strips: int | None = None,
    min_strips: int | None = None,
    strip_number_adaptivity: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
max_extra_cb_iterations int | None

Max extra codebook recalculation passes, more is better and slower (from 0 to INT_MAX) (default 2)

None
skip_empty_cb bool | None

Avoid wasting bytes, ignore vintage MacOS decoder (default false)

None
max_strips int | None

Limit strips/frame, vintage compatible is 1..3, otherwise the more the better (from 1 to 32) (default 3)

None
min_strips int | None

Enforce min strips/frame, more is worse and faster, must be <= max_strips (from 1 to 32) (default 1)

None
strip_number_adaptivity int | None

How fast the strip number adapts, more is slightly better, much slower (from 0 to 31) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

cljr

cljr(dither_type: int | None = None) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
dither_type int | None

Dither type (from 0 to 2) (default 1)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

comfortnoise

comfortnoise() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

dca

dca(dca_adpcm: bool | None = None) -> FFMpegEncoderOption

(codec dts)

Parameters:

Name Type Description Default
dca_adpcm bool | None

Use ADPCM encoding (default false)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

dfpwm

Returns:

Type Description
FFMpegEncoderOption

the set codec options

dnxhd

dnxhd(
    nitris_compat: bool | None = None,
    ibias: int | None = None,
    profile: (
        int
        | None
        | Literal[
            "dnxhd",
            "dnxhr_444",
            "dnxhr_hqx",
            "dnxhr_hq",
            "dnxhr_sq",
            "dnxhr_lb",
        ]
    ) = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
nitris_compat bool | None

encode with Avid Nitris compatibility (default false)

None
ibias int | None

intra quant bias (from INT_MIN to INT_MAX) (default 0)

None
profile int | None | Literal['dnxhd', 'dnxhr_444', 'dnxhr_hqx', 'dnxhr_hq', 'dnxhr_sq', 'dnxhr_lb']

(from 0 to 5) (default dnxhd)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

dpx

Returns:

Type Description
FFMpegEncoderOption

the set codec options

dvbsub

dvbsub() -> FFMpegEncoderOption

(codec dvb_subtitle)

Returns:

Type Description
FFMpegEncoderOption

the set codec options

dvdsub

dvdsub(
    palette: str | None = None,
    even_rows_fix: bool | None = None,
) -> FFMpegEncoderOption

(codec dvd_subtitle)

Parameters:

Name Type Description Default
palette str | None

set the global palette

None
even_rows_fix bool | None

Make number of rows even (workaround for some players) (default false)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

dvvideo

dvvideo(
    quant_deadzone: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
quant_deadzone int | None

Quantizer dead zone (from 0 to 1024) (default 7)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

eac3

eac3(
    mixing_level: int | None = None,
    room_type: (
        int
        | None
        | Literal["notindicated", "large", "small"]
    ) = None,
    per_frame_metadata: bool | None = None,
    copyright: int | None = None,
    dialnorm: int | None = None,
    dsur_mode: (
        int | None | Literal["notindicated", "on", "off"]
    ) = None,
    original: int | None = None,
    dmix_mode: (
        int
        | None
        | Literal["notindicated", "ltrt", "loro", "dplii"]
    ) = None,
    ltrt_cmixlev: float | None = None,
    ltrt_surmixlev: float | None = None,
    loro_cmixlev: float | None = None,
    loro_surmixlev: float | None = None,
    dsurex_mode: (
        int
        | None
        | Literal["notindicated", "on", "off", "dpliiz"]
    ) = None,
    dheadphone_mode: (
        int | None | Literal["notindicated", "on", "off"]
    ) = None,
    ad_conv_type: (
        int | None | Literal["standard", "hdcd"]
    ) = None,
    stereo_rematrixing: bool | None = None,
    channel_coupling: int | None | Literal["auto"] = None,
    cpl_start_band: int | None | Literal["auto"] = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
mixing_level int | None

Mixing Level (from -1 to 111) (default -1)

None
room_type int | None | Literal['notindicated', 'large', 'small']

Room Type (from -1 to 2) (default -1)

None
per_frame_metadata bool | None

Allow Changing Metadata Per-Frame (default false)

None
copyright int | None

Copyright Bit (from -1 to 1) (default -1)

None
dialnorm int | None

Dialogue Level (dB) (from -31 to -1) (default -31)

None
dsur_mode int | None | Literal['notindicated', 'on', 'off']

Dolby Surround Mode (from -1 to 2) (default -1)

None
original int | None

Original Bit Stream (from -1 to 1) (default -1)

None
dmix_mode int | None | Literal['notindicated', 'ltrt', 'loro', 'dplii']

Preferred Stereo Downmix Mode (from -1 to 3) (default -1)

None
ltrt_cmixlev float | None

Lt/Rt Center Mix Level (from -1 to 2) (default -1)

None
ltrt_surmixlev float | None

Lt/Rt Surround Mix Level (from -1 to 2) (default -1)

None
loro_cmixlev float | None

Lo/Ro Center Mix Level (from -1 to 2) (default -1)

None
loro_surmixlev float | None

Lo/Ro Surround Mix Level (from -1 to 2) (default -1)

None
dsurex_mode int | None | Literal['notindicated', 'on', 'off', 'dpliiz']

Dolby Surround EX Mode (from -1 to 3) (default -1)

None
dheadphone_mode int | None | Literal['notindicated', 'on', 'off']

Dolby Headphone Mode (from -1 to 2) (default -1)

None
ad_conv_type int | None | Literal['standard', 'hdcd']

A/D Converter Type (from -1 to 1) (default -1)

None
stereo_rematrixing bool | None

Stereo Rematrixing (default true)

None
channel_coupling int | None | Literal['auto']

Channel Coupling (from -1 to 1) (default auto)

None
cpl_start_band int | None | Literal['auto']

Coupling Start Band (from -1 to 15) (default auto)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

exr

exr(
    compression: (
        int | None | Literal["none", "rle", "zip1", "zip16"]
    ) = None,
    format: int | None | Literal["half", "float"] = None,
    gamma: float | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
compression int | None | Literal['none', 'rle', 'zip1', 'zip16']

set compression type (from 0 to 3) (default none)

None
format int | None | Literal['half', 'float']

set pixel type (from 1 to 2) (default float)

None
gamma float | None

set gamma (from 0.001 to FLT_MAX) (default 1)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

ffv1

ffv1(
    slicecrc: bool | None = None,
    coder: (
        int
        | None
        | Literal["rice", "range_def", "range_tab", "ac"]
    ) = None,
    context: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
slicecrc bool | None

Protect slices with CRCs (default auto)

None
coder int | None | Literal['rice', 'range_def', 'range_tab', 'ac']

Coder type (from -2 to 2) (default rice)

None
context int | None

Context model (from 0 to 1) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

ffvhuff

ffvhuff(
    non_deterministic: bool | None = None,
    pred: (
        int | None | Literal["left", "plane", "median"]
    ) = None,
    context: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
non_deterministic bool | None

Allow multithreading for e.g. context=1 at the expense of determinism (default false)

None
pred int | None | Literal['left', 'plane', 'median']

Prediction method (from 0 to 2) (default left)

None
context int | None

Set per-frame huffman tables (from 0 to 1) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

fits

Returns:

Type Description
FFMpegEncoderOption

the set codec options

flac

flac(
    lpc_coeff_precision: int | None = None,
    lpc_type: (
        int
        | None
        | Literal["none", "fixed", "levinson", "cholesky"]
    ) = None,
    lpc_passes: int | None = None,
    min_partition_order: int | None = None,
    prediction_order_method: (
        int
        | None
        | Literal[
            "estimation",
            "2level",
            "4level",
            "8level",
            "search",
            "log",
        ]
    ) = None,
    ch_mode: (
        int
        | None
        | Literal[
            "auto",
            "indep",
            "left_side",
            "right_side",
            "mid_side",
        ]
    ) = None,
    exact_rice_parameters: bool | None = None,
    multi_dim_quant: bool | None = None,
    min_prediction_order: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
lpc_coeff_precision int | None

LPC coefficient precision (from 0 to 15) (default 15)

None
lpc_type int | None | Literal['none', 'fixed', 'levinson', 'cholesky']

LPC algorithm (from -1 to 3) (default -1)

None
lpc_passes int | None

Number of passes to use for Cholesky factorization during LPC analysis (from 1 to INT_MAX) (default 2)

None
min_partition_order int | None

(from -1 to 8) (default -1)

None
prediction_order_method int | None | Literal['estimation', '2level', '4level', '8level', 'search', 'log']

Search method for selecting prediction order (from -1 to 5) (default -1)

None
ch_mode int | None | Literal['auto', 'indep', 'left_side', 'right_side', 'mid_side']

Stereo decorrelation mode (from -1 to 3) (default auto)

None
exact_rice_parameters bool | None

Calculate rice parameters exactly (default false)

None
multi_dim_quant bool | None

Multi-dimensional quantization (default false)

None
min_prediction_order int | None

(from -1 to 32) (default -1)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

flashsv

flashsv() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

flashsv2

flashsv2() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

flv

flv(
    mpv_flags: str | None = None,
    luma_elim_threshold: int | None = None,
    chroma_elim_threshold: int | None = None,
    quantizer_noise_shaping: int | None = None,
    error_rate: int | None = None,
    qsquish: float | None = None,
    rc_qmod_amp: float | None = None,
    rc_qmod_freq: int | None = None,
    rc_eq: str | None = None,
    rc_init_cplx: float | None = None,
    rc_buf_aggressivity: float | None = None,
    border_mask: float | None = None,
    lmin: int | None = None,
    lmax: int | None = None,
    skip_threshold: int | None = None,
    skip_factor: int | None = None,
    skip_exp: int | None = None,
    skip_cmp: (
        int
        | None
        | Literal[
            "sad",
            "sse",
            "satd",
            "dct",
            "psnr",
            "bit",
            "rd",
            "zero",
            "vsad",
            "vsse",
            "nsse",
            "dct264",
            "dctmax",
            "chroma",
            "msad",
        ]
    ) = None,
    sc_threshold: int | None = None,
    noise_reduction: int | None = None,
    ps: int | None = None,
    motion_est: (
        int | None | Literal["zero", "epzs", "xone"]
    ) = None,
    mepc: int | None = None,
    mepre: int | None = None,
    intra_penalty: int | None = None,
) -> FFMpegEncoderOption

(codec flv1)

Parameters:

Name Type Description Default
mpv_flags str | None

Flags common for all mpegvideo-based encoders. (default 0)

None
luma_elim_threshold int | None

single coefficient elimination threshold for luminance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
chroma_elim_threshold int | None

single coefficient elimination threshold for chrominance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
quantizer_noise_shaping int | None

(from 0 to INT_MAX) (default 0)

None
error_rate int | None

Simulate errors in the bitstream to test error concealment. (from 0 to INT_MAX) (default 0)

None
qsquish float | None

how to keep quantizer between qmin and qmax (0 = clip, 1 = use differentiable function) (from 0 to 99) (default 0)

None
rc_qmod_amp float | None

experimental quantizer modulation (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_qmod_freq int | None

experimental quantizer modulation (from INT_MIN to INT_MAX) (default 0)

None
rc_eq str | None

Set rate control equation. When computing the expression, besides the standard functions defined in the section 'Expression Evaluation', the following functions are available: bits2qp(bits), qp2bits(qp). Also the following constants are available: iTex pTex tex mv fCode iCount mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex avgTex.

None
rc_init_cplx float | None

initial complexity for 1-pass encoding (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_buf_aggressivity float | None

currently useless (from -FLT_MAX to FLT_MAX) (default 1)

None
border_mask float | None

increase the quantizer for macroblocks close to borders (from -FLT_MAX to FLT_MAX) (default 0)

None
lmin int | None

minimum Lagrange factor (VBR) (from 0 to INT_MAX) (default 236)

None
lmax int | None

maximum Lagrange factor (VBR) (from 0 to INT_MAX) (default 3658)

None
skip_threshold int | None

Frame skip threshold (from INT_MIN to INT_MAX) (default 0)

None
skip_factor int | None

Frame skip factor (from INT_MIN to INT_MAX) (default 0)

None
skip_exp int | None

Frame skip exponent (from INT_MIN to INT_MAX) (default 0)

None
skip_cmp int | None | Literal['sad', 'sse', 'satd', 'dct', 'psnr', 'bit', 'rd', 'zero', 'vsad', 'vsse', 'nsse', 'dct264', 'dctmax', 'chroma', 'msad']

Frame skip compare function (from INT_MIN to INT_MAX) (default dctmax)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default 0)

None
noise_reduction int | None

Noise reduction (from INT_MIN to INT_MAX) (default 0)

None
ps int | None

RTP payload size in bytes (from INT_MIN to INT_MAX) (default 0)

None
motion_est int | None | Literal['zero', 'epzs', 'xone']

motion estimation algorithm (from 0 to 2) (default epzs)

None
mepc int | None

Motion estimation bitrate penalty compensation (1.0 = 256) (from INT_MIN to INT_MAX) (default 256)

None
mepre int | None

pre motion estimation (from INT_MIN to INT_MAX) (default 0)

None
intra_penalty int | None

Penalty for intra blocks in block decision (from 0 to 1.07374e+09) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

g722

(codec adpcm_g722)

Returns:

Type Description
FFMpegEncoderOption

the set codec options

g723_1

g723_1() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

g726

g726(code_size: int | None = None) -> FFMpegEncoderOption

(codec adpcm_g726)

Parameters:

Name Type Description Default
code_size int | None

Bits per code (from 2 to 5) (default 4)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

g726le

g726le(code_size: int | None = None) -> FFMpegEncoderOption

(codec adpcm_g726le)

Parameters:

Name Type Description Default
code_size int | None

Bits per code (from 2 to 5) (default 4)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

gif

gif(
    gifflags: str | None = None,
    gifimage: bool | None = None,
    global_palette: bool | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
gifflags str | None

set GIF flags (default offsetting+transdiff)

None
gifimage bool | None

enable encoding only images per frame (default false)

None
global_palette bool | None

write a palette to the global gif header where feasible (default true)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

h261

h261(
    mpv_flags: str | None = None,
    luma_elim_threshold: int | None = None,
    chroma_elim_threshold: int | None = None,
    quantizer_noise_shaping: int | None = None,
    error_rate: int | None = None,
    qsquish: float | None = None,
    rc_qmod_amp: float | None = None,
    rc_qmod_freq: int | None = None,
    rc_eq: str | None = None,
    rc_init_cplx: float | None = None,
    rc_buf_aggressivity: float | None = None,
    border_mask: float | None = None,
    lmin: int | None = None,
    lmax: int | None = None,
    skip_threshold: int | None = None,
    skip_factor: int | None = None,
    skip_exp: int | None = None,
    skip_cmp: (
        int
        | None
        | Literal[
            "sad",
            "sse",
            "satd",
            "dct",
            "psnr",
            "bit",
            "rd",
            "zero",
            "vsad",
            "vsse",
            "nsse",
            "dct264",
            "dctmax",
            "chroma",
            "msad",
        ]
    ) = None,
    sc_threshold: int | None = None,
    noise_reduction: int | None = None,
    ps: int | None = None,
    motion_est: (
        int | None | Literal["zero", "epzs", "xone"]
    ) = None,
    mepc: int | None = None,
    mepre: int | None = None,
    intra_penalty: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
mpv_flags str | None

Flags common for all mpegvideo-based encoders. (default 0)

None
luma_elim_threshold int | None

single coefficient elimination threshold for luminance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
chroma_elim_threshold int | None

single coefficient elimination threshold for chrominance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
quantizer_noise_shaping int | None

(from 0 to INT_MAX) (default 0)

None
error_rate int | None

Simulate errors in the bitstream to test error concealment. (from 0 to INT_MAX) (default 0)

None
qsquish float | None

how to keep quantizer between qmin and qmax (0 = clip, 1 = use differentiable function) (from 0 to 99) (default 0)

None
rc_qmod_amp float | None

experimental quantizer modulation (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_qmod_freq int | None

experimental quantizer modulation (from INT_MIN to INT_MAX) (default 0)

None
rc_eq str | None

Set rate control equation. When computing the expression, besides the standard functions defined in the section 'Expression Evaluation', the following functions are available: bits2qp(bits), qp2bits(qp). Also the following constants are available: iTex pTex tex mv fCode iCount mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex avgTex.

None
rc_init_cplx float | None

initial complexity for 1-pass encoding (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_buf_aggressivity float | None

currently useless (from -FLT_MAX to FLT_MAX) (default 1)

None
border_mask float | None

increase the quantizer for macroblocks close to borders (from -FLT_MAX to FLT_MAX) (default 0)

None
lmin int | None

minimum Lagrange factor (VBR) (from 0 to INT_MAX) (default 236)

None
lmax int | None

maximum Lagrange factor (VBR) (from 0 to INT_MAX) (default 3658)

None
skip_threshold int | None

Frame skip threshold (from INT_MIN to INT_MAX) (default 0)

None
skip_factor int | None

Frame skip factor (from INT_MIN to INT_MAX) (default 0)

None
skip_exp int | None

Frame skip exponent (from INT_MIN to INT_MAX) (default 0)

None
skip_cmp int | None | Literal['sad', 'sse', 'satd', 'dct', 'psnr', 'bit', 'rd', 'zero', 'vsad', 'vsse', 'nsse', 'dct264', 'dctmax', 'chroma', 'msad']

Frame skip compare function (from INT_MIN to INT_MAX) (default dctmax)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default 0)

None
noise_reduction int | None

Noise reduction (from INT_MIN to INT_MAX) (default 0)

None
ps int | None

RTP payload size in bytes (from INT_MIN to INT_MAX) (default 0)

None
motion_est int | None | Literal['zero', 'epzs', 'xone']

motion estimation algorithm (from 0 to 2) (default epzs)

None
mepc int | None

Motion estimation bitrate penalty compensation (1.0 = 256) (from INT_MIN to INT_MAX) (default 256)

None
mepre int | None

pre motion estimation (from INT_MIN to INT_MAX) (default 0)

None
intra_penalty int | None

Penalty for intra blocks in block decision (from 0 to 1.07374e+09) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

h263

h263(
    obmc: bool | None = None,
    mb_info: int | None = None,
    mpv_flags: str | None = None,
    luma_elim_threshold: int | None = None,
    chroma_elim_threshold: int | None = None,
    quantizer_noise_shaping: int | None = None,
    error_rate: int | None = None,
    qsquish: float | None = None,
    rc_qmod_amp: float | None = None,
    rc_qmod_freq: int | None = None,
    rc_eq: str | None = None,
    rc_init_cplx: float | None = None,
    rc_buf_aggressivity: float | None = None,
    border_mask: float | None = None,
    lmin: int | None = None,
    lmax: int | None = None,
    skip_threshold: int | None = None,
    skip_factor: int | None = None,
    skip_exp: int | None = None,
    skip_cmp: (
        int
        | None
        | Literal[
            "sad",
            "sse",
            "satd",
            "dct",
            "psnr",
            "bit",
            "rd",
            "zero",
            "vsad",
            "vsse",
            "nsse",
            "dct264",
            "dctmax",
            "chroma",
            "msad",
        ]
    ) = None,
    sc_threshold: int | None = None,
    noise_reduction: int | None = None,
    ps: int | None = None,
    motion_est: (
        int | None | Literal["zero", "epzs", "xone"]
    ) = None,
    mepc: int | None = None,
    mepre: int | None = None,
    intra_penalty: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
obmc bool | None

use overlapped block motion compensation. (default false)

None
mb_info int | None

emit macroblock info for RFC 2190 packetization, the parameter value is the maximum payload size (from 0 to INT_MAX) (default 0)

None
mpv_flags str | None

Flags common for all mpegvideo-based encoders. (default 0)

None
luma_elim_threshold int | None

single coefficient elimination threshold for luminance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
chroma_elim_threshold int | None

single coefficient elimination threshold for chrominance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
quantizer_noise_shaping int | None

(from 0 to INT_MAX) (default 0)

None
error_rate int | None

Simulate errors in the bitstream to test error concealment. (from 0 to INT_MAX) (default 0)

None
qsquish float | None

how to keep quantizer between qmin and qmax (0 = clip, 1 = use differentiable function) (from 0 to 99) (default 0)

None
rc_qmod_amp float | None

experimental quantizer modulation (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_qmod_freq int | None

experimental quantizer modulation (from INT_MIN to INT_MAX) (default 0)

None
rc_eq str | None

Set rate control equation. When computing the expression, besides the standard functions defined in the section 'Expression Evaluation', the following functions are available: bits2qp(bits), qp2bits(qp). Also the following constants are available: iTex pTex tex mv fCode iCount mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex avgTex.

None
rc_init_cplx float | None

initial complexity for 1-pass encoding (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_buf_aggressivity float | None

currently useless (from -FLT_MAX to FLT_MAX) (default 1)

None
border_mask float | None

increase the quantizer for macroblocks close to borders (from -FLT_MAX to FLT_MAX) (default 0)

None
lmin int | None

minimum Lagrange factor (VBR) (from 0 to INT_MAX) (default 236)

None
lmax int | None

maximum Lagrange factor (VBR) (from 0 to INT_MAX) (default 3658)

None
skip_threshold int | None

Frame skip threshold (from INT_MIN to INT_MAX) (default 0)

None
skip_factor int | None

Frame skip factor (from INT_MIN to INT_MAX) (default 0)

None
skip_exp int | None

Frame skip exponent (from INT_MIN to INT_MAX) (default 0)

None
skip_cmp int | None | Literal['sad', 'sse', 'satd', 'dct', 'psnr', 'bit', 'rd', 'zero', 'vsad', 'vsse', 'nsse', 'dct264', 'dctmax', 'chroma', 'msad']

Frame skip compare function (from INT_MIN to INT_MAX) (default dctmax)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default 0)

None
noise_reduction int | None

Noise reduction (from INT_MIN to INT_MAX) (default 0)

None
ps int | None

RTP payload size in bytes (from INT_MIN to INT_MAX) (default 0)

None
motion_est int | None | Literal['zero', 'epzs', 'xone']

motion estimation algorithm (from 0 to 2) (default epzs)

None
mepc int | None

Motion estimation bitrate penalty compensation (1.0 = 256) (from INT_MIN to INT_MAX) (default 256)

None
mepre int | None

pre motion estimation (from INT_MIN to INT_MAX) (default 0)

None
intra_penalty int | None

Penalty for intra blocks in block decision (from 0 to 1.07374e+09) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

h263_v4l2m2m

h263_v4l2m2m(
    num_output_buffers: int | None = None,
    num_capture_buffers: int | None = None,
) -> FFMpegEncoderOption

(codec h263)

Parameters:

Name Type Description Default
num_output_buffers int | None

Number of buffers in the output context (from 6 to INT_MAX) (default 16)

None
num_capture_buffers int | None

Number of buffers in the capture context (from 4 to INT_MAX) (default 4)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

h263p

h263p(
    umv: bool | None = None,
    aiv: bool | None = None,
    obmc: bool | None = None,
    structured_slices: bool | None = None,
    mpv_flags: str | None = None,
    luma_elim_threshold: int | None = None,
    chroma_elim_threshold: int | None = None,
    quantizer_noise_shaping: int | None = None,
    error_rate: int | None = None,
    qsquish: float | None = None,
    rc_qmod_amp: float | None = None,
    rc_qmod_freq: int | None = None,
    rc_eq: str | None = None,
    rc_init_cplx: float | None = None,
    rc_buf_aggressivity: float | None = None,
    border_mask: float | None = None,
    lmin: int | None = None,
    lmax: int | None = None,
    skip_threshold: int | None = None,
    skip_factor: int | None = None,
    skip_exp: int | None = None,
    skip_cmp: (
        int
        | None
        | Literal[
            "sad",
            "sse",
            "satd",
            "dct",
            "psnr",
            "bit",
            "rd",
            "zero",
            "vsad",
            "vsse",
            "nsse",
            "dct264",
            "dctmax",
            "chroma",
            "msad",
        ]
    ) = None,
    sc_threshold: int | None = None,
    noise_reduction: int | None = None,
    ps: int | None = None,
    motion_est: (
        int | None | Literal["zero", "epzs", "xone"]
    ) = None,
    mepc: int | None = None,
    mepre: int | None = None,
    intra_penalty: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
umv bool | None

Use unlimited motion vectors. (default false)

None
aiv bool | None

Use alternative inter VLC. (default false)

None
obmc bool | None

use overlapped block motion compensation. (default false)

None
structured_slices bool | None

Write slice start position at every GOB header instead of just GOB number. (default false)

None
mpv_flags str | None

Flags common for all mpegvideo-based encoders. (default 0)

None
luma_elim_threshold int | None

single coefficient elimination threshold for luminance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
chroma_elim_threshold int | None

single coefficient elimination threshold for chrominance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
quantizer_noise_shaping int | None

(from 0 to INT_MAX) (default 0)

None
error_rate int | None

Simulate errors in the bitstream to test error concealment. (from 0 to INT_MAX) (default 0)

None
qsquish float | None

how to keep quantizer between qmin and qmax (0 = clip, 1 = use differentiable function) (from 0 to 99) (default 0)

None
rc_qmod_amp float | None

experimental quantizer modulation (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_qmod_freq int | None

experimental quantizer modulation (from INT_MIN to INT_MAX) (default 0)

None
rc_eq str | None

Set rate control equation. When computing the expression, besides the standard functions defined in the section 'Expression Evaluation', the following functions are available: bits2qp(bits), qp2bits(qp). Also the following constants are available: iTex pTex tex mv fCode iCount mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex avgTex.

None
rc_init_cplx float | None

initial complexity for 1-pass encoding (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_buf_aggressivity float | None

currently useless (from -FLT_MAX to FLT_MAX) (default 1)

None
border_mask float | None

increase the quantizer for macroblocks close to borders (from -FLT_MAX to FLT_MAX) (default 0)

None
lmin int | None

minimum Lagrange factor (VBR) (from 0 to INT_MAX) (default 236)

None
lmax int | None

maximum Lagrange factor (VBR) (from 0 to INT_MAX) (default 3658)

None
skip_threshold int | None

Frame skip threshold (from INT_MIN to INT_MAX) (default 0)

None
skip_factor int | None

Frame skip factor (from INT_MIN to INT_MAX) (default 0)

None
skip_exp int | None

Frame skip exponent (from INT_MIN to INT_MAX) (default 0)

None
skip_cmp int | None | Literal['sad', 'sse', 'satd', 'dct', 'psnr', 'bit', 'rd', 'zero', 'vsad', 'vsse', 'nsse', 'dct264', 'dctmax', 'chroma', 'msad']

Frame skip compare function (from INT_MIN to INT_MAX) (default dctmax)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default 0)

None
noise_reduction int | None

Noise reduction (from INT_MIN to INT_MAX) (default 0)

None
ps int | None

RTP payload size in bytes (from INT_MIN to INT_MAX) (default 0)

None
motion_est int | None | Literal['zero', 'epzs', 'xone']

motion estimation algorithm (from 0 to 2) (default epzs)

None
mepc int | None

Motion estimation bitrate penalty compensation (1.0 = 256) (from INT_MIN to INT_MAX) (default 256)

None
mepre int | None

pre motion estimation (from INT_MIN to INT_MAX) (default 0)

None
intra_penalty int | None

Penalty for intra blocks in block decision (from 0 to 1.07374e+09) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

h264_v4l2m2m

h264_v4l2m2m(
    num_output_buffers: int | None = None,
    num_capture_buffers: int | None = None,
) -> FFMpegEncoderOption

(codec h264)

Parameters:

Name Type Description Default
num_output_buffers int | None

Number of buffers in the output context (from 6 to INT_MAX) (default 16)

None
num_capture_buffers int | None

Number of buffers in the capture context (from 4 to INT_MAX) (default 4)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

hevc_v4l2m2m

hevc_v4l2m2m(
    num_output_buffers: int | None = None,
    num_capture_buffers: int | None = None,
) -> FFMpegEncoderOption

(codec hevc)

Parameters:

Name Type Description Default
num_output_buffers int | None

Number of buffers in the output context (from 6 to INT_MAX) (default 16)

None
num_capture_buffers int | None

Number of buffers in the capture context (from 4 to INT_MAX) (default 4)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

huffyuv

huffyuv(
    non_deterministic: bool | None = None,
    pred: (
        int | None | Literal["left", "plane", "median"]
    ) = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
non_deterministic bool | None

Allow multithreading for e.g. context=1 at the expense of determinism (default false)

None
pred int | None | Literal['left', 'plane', 'median']

Prediction method (from 0 to 2) (default left)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

jpeg2000

jpeg2000(
    format: int | None | Literal["j2k", "jp2"] = None,
    tile_width: int | None = None,
    tile_height: int | None = None,
    pred: int | None | Literal["dwt97int", "dwt53"] = None,
    sop: int | None = None,
    eph: int | None = None,
    prog: (
        int
        | None
        | Literal["lrcp", "rlcp", "rpcl", "pcrl", "cprl"]
    ) = None,
    layer_rates: str | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
format int | None | Literal['j2k', 'jp2']

Codec Format (from 0 to 1) (default jp2)

None
tile_width int | None

Tile Width (from 1 to 1.07374e+09) (default 256)

None
tile_height int | None

Tile Height (from 1 to 1.07374e+09) (default 256)

None
pred int | None | Literal['dwt97int', 'dwt53']

DWT Type (from 0 to 1) (default dwt97int)

None
sop int | None

SOP marker (from 0 to 1) (default 0)

None
eph int | None

EPH marker (from 0 to 1) (default 0)

None
prog int | None | Literal['lrcp', 'rlcp', 'rpcl', 'pcrl', 'cprl']

Progression Order (from 0 to 4) (default lrcp)

None
layer_rates str | None

Layer Rates

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

jpegls

jpegls(
    pred: (
        int | None | Literal["left", "plane", "median"]
    ) = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
pred int | None | Literal['left', 'plane', 'median']

Prediction method (from 0 to 2) (default left)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

libfdk_aac

libfdk_aac(
    afterburner: int | None = None,
    eld_sbr: int | None = None,
    signaling: (
        int
        | None
        | Literal[
            "default",
            "implicit",
            "explicit_sbr",
            "explicit_hierarchical",
        ]
    ) = None,
    latm: int | None = None,
    header_period: int | None = None,
    vbr: int | None = None,
) -> FFMpegEncoderOption

(codec aac)

Parameters:

Name Type Description Default
afterburner int | None

Afterburner (improved quality) (from 0 to 1) (default 1)

None
eld_sbr int | None

Enable SBR for ELD (for SBR in other configurations, use the -profile parameter) (from 0 to 1) (default 0)

None
signaling int | None | Literal['default', 'implicit', 'explicit_sbr', 'explicit_hierarchical']

SBR/PS signaling style (from -1 to 2) (default default)

None
latm int | None

Output LATM/LOAS encapsulated data (from 0 to 1) (default 0)

None
header_period int | None

StreamMuxConfig and PCE repetition period (in frames) (from 0 to 65535) (default 0)

None
vbr int | None

VBR mode (1-5) (from 0 to 5) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

libkvazaar

libkvazaar(
    kvazaar_params: str | None = None,
) -> FFMpegEncoderOption

(codec hevc)

Parameters:

Name Type Description Default
kvazaar_params str | None

Set kvazaar parameters as a comma-separated list of key=value pairs.

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

libmp3lame

libmp3lame(
    reservoir: bool | None = None,
    joint_stereo: bool | None = None,
    abr: bool | None = None,
) -> FFMpegEncoderOption

(codec mp3)

Parameters:

Name Type Description Default
reservoir bool | None

use bit reservoir (default true)

None
joint_stereo bool | None

use joint stereo (default true)

None
abr bool | None

use ABR (default false)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

libopencore_amrnb

libopencore_amrnb(
    dtx: int | None = None,
) -> FFMpegEncoderOption

(codec amr_nb)

Parameters:

Name Type Description Default
dtx int | None

Allow DTX (generate comfort noise) (from 0 to 1) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

libopenjpeg

libopenjpeg(
    format: int | None | Literal["j2k", "jp2"] = None,
    profile: (
        int
        | None
        | Literal["jpeg2000", "cinema2k", "cinema4k"]
    ) = None,
    cinema_mode: (
        int
        | None
        | Literal["off", "2k_24", "2k_48", "4k_24"]
    ) = None,
    prog_order: (
        int
        | None
        | Literal["lrcp", "rlcp", "rpcl", "pcrl", "cprl"]
    ) = None,
    numresolution: int | None = None,
    irreversible: int | None = None,
    disto_alloc: int | None = None,
    fixed_quality: int | None = None,
) -> FFMpegEncoderOption

(codec jpeg2000)

Parameters:

Name Type Description Default
format int | None | Literal['j2k', 'jp2']

Codec Format (from 0 to 2) (default jp2)

None
profile int | None | Literal['jpeg2000', 'cinema2k', 'cinema4k']

(from 0 to 4) (default jpeg2000)

None
cinema_mode int | None | Literal['off', '2k_24', '2k_48', '4k_24']

Digital Cinema (from 0 to 3) (default off)

None
prog_order int | None | Literal['lrcp', 'rlcp', 'rpcl', 'pcrl', 'cprl']

Progression Order (from 0 to 4) (default lrcp)

None
numresolution int | None

(from 0 to 33) (default 6)

None
irreversible int | None

(from 0 to 1) (default 0)

None
disto_alloc int | None

(from 0 to 1) (default 1)

None
fixed_quality int | None

(from 0 to 1) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

libopus

libopus(
    application: (
        int | None | Literal["voip", "audio", "lowdelay"]
    ) = None,
    frame_duration: float | None = None,
    packet_loss: int | None = None,
    fec: bool | None = None,
    vbr: (
        int | None | Literal["off", "on", "constrained"]
    ) = None,
    mapping_family: int | None = None,
    apply_phase_inv: bool | None = None,
) -> FFMpegEncoderOption

(codec opus)

Parameters:

Name Type Description Default
application int | None | Literal['voip', 'audio', 'lowdelay']

Intended application type (from 2048 to 2051) (default audio)

None
frame_duration float | None

Duration of a frame in milliseconds (from 2.5 to 120) (default 20)

None
packet_loss int | None

Expected packet loss percentage (from 0 to 100) (default 0)

None
fec bool | None

Enable inband FEC. Expected packet loss must be non-zero (default false)

None
vbr int | None | Literal['off', 'on', 'constrained']

Variable bit rate mode (from 0 to 2) (default on)

None
mapping_family int | None

Channel Mapping Family (from -1 to 255) (default -1)

None
apply_phase_inv bool | None

Apply intensity stereo phase inversion (default true)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

libtheora

libtheora() -> FFMpegEncoderOption

(codec theora)

Returns:

Type Description
FFMpegEncoderOption

the set codec options

libvorbis

libvorbis(
    iblock: float | None = None,
) -> FFMpegEncoderOption

(codec vorbis)

Parameters:

Name Type Description Default
iblock float | None

Sets the impulse block bias (from -15 to 0) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

libvpx

libvpx(
    lag_in_frames: int | None = None,
    arnr_maxframes: int | None = None,
    arnr_strength: int | None = None,
    arnr_type: (
        int
        | None
        | Literal["backward", "forward", "centered"]
    ) = None,
    tune: int | None | Literal["psnr", "ssim"] = None,
    deadline: (
        int | None | Literal["best", "good", "realtime"]
    ) = None,
    error_resilient: str | None = None,
    max_intra_rate: int | None = None,
    crf: int | None = None,
    static_thresh: int | None = None,
    drop_threshold: int | None = None,
    noise_sensitivity: int | None = None,
    undershoot_pct: int | None = None,
    overshoot_pct: int | None = None,
    ts_parameters: str | None = None,
    auto_alt_ref: int | None = None,
    cpu_used: int | None = None,
    speed: int | None = None,
    quality: (
        int | None | Literal["best", "good", "realtime"]
    ) = None,
    vp8flags: str | None = None,
    arnr_max_frames: int | None = None,
    rc_lookahead: int | None = None,
    sharpness: int | None = None,
) -> FFMpegEncoderOption

(codec vp8)

Parameters:

Name Type Description Default
lag_in_frames int | None

Number of frames to look ahead for alternate reference frame selection (from -1 to INT_MAX) (default -1)

None
arnr_maxframes int | None

altref noise reduction max frame count (from -1 to INT_MAX) (default -1)

None
arnr_strength int | None

altref noise reduction filter strength (from -1 to INT_MAX) (default -1)

None
arnr_type int | None | Literal['backward', 'forward', 'centered']

altref noise reduction filter type (from -1 to INT_MAX) (default -1)

None
tune int | None | Literal['psnr', 'ssim']

Tune the encoding to a specific scenario (from -1 to INT_MAX) (default -1)

None
deadline int | None | Literal['best', 'good', 'realtime']

Time to spend encoding, in microseconds. (from INT_MIN to INT_MAX) (default good)

None
error_resilient str | None

Error resilience configuration (default 0)

None
max_intra_rate int | None

Maximum I-frame bitrate (pct) 0=unlimited (from -1 to INT_MAX) (default -1)

None
crf int | None

Select the quality for constant quality mode (from -1 to 63) (default -1)

None
static_thresh int | None

A change threshold on blocks below which they will be skipped by the encoder (from 0 to INT_MAX) (default 0)

None
drop_threshold int | None

Frame drop threshold (from INT_MIN to INT_MAX) (default 0)

None
noise_sensitivity int | None

Noise sensitivity (from 0 to 4) (default 0)

None
undershoot_pct int | None

Datarate undershoot (min) target (%) (from -1 to 100) (default -1)

None
overshoot_pct int | None

Datarate overshoot (max) target (%) (from -1 to 1000) (default -1)

None
ts_parameters str | None

Temporal scaling configuration using a :-separated list of key=value parameters

None
auto_alt_ref int | None

Enable use of alternate reference frames (2-pass only) (from -1 to 2) (default -1)

None
cpu_used int | None

Quality/Speed ratio modifier (from -16 to 16) (default 1)

None
speed int | None

(from -16 to 16) (default 1)

None
quality int | None | Literal['best', 'good', 'realtime']

(from INT_MIN to INT_MAX) (default good)

None
vp8flags str | None

(default 0)

None
arnr_max_frames int | None

altref noise reduction max frame count (from 0 to 15) (default 0)

None
rc_lookahead int | None

Number of frames to look ahead for alternate reference frame selection (from 0 to 25) (default 25)

None
sharpness int | None

Increase sharpness at the expense of lower PSNR (from -1 to 7) (default -1)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

libwebp

libwebp(
    lossless: int | None = None,
    preset: (
        int
        | None
        | Literal[
            "none",
            "default",
            "picture",
            "photo",
            "drawing",
            "icon",
            "text",
        ]
    ) = None,
    cr_threshold: int | None = None,
    cr_size: int | None = None,
    quality: float | None = None,
) -> FFMpegEncoderOption

(codec webp)

Parameters:

Name Type Description Default
lossless int | None

Use lossless mode (from 0 to 1) (default 0)

None
preset int | None | Literal['none', 'default', 'picture', 'photo', 'drawing', 'icon', 'text']

Configuration preset (from -1 to 5) (default none)

None
cr_threshold int | None

Conditional replenishment threshold (from 0 to INT_MAX) (default 0)

None
cr_size int | None

Conditional replenishment block size (from 0 to 256) (default 16)

None
quality float | None

Quality (from 0 to 100) (default 75)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

libx264

libx264(
    preset: str | None = None,
    tune: str | None = None,
    profile: str | None = None,
    fastfirstpass: bool | None = None,
    level: str | None = None,
    passlogfile: str | None = None,
    wpredp: str | None = None,
    a53cc: bool | None = None,
    x264opts: str | None = None,
    crf: float | None = None,
    crf_max: float | None = None,
    qp: int | None = None,
    aq_mode: (
        int
        | None
        | Literal[
            "none",
            "variance",
            "autovariance",
            "autovariance-biased",
        ]
    ) = None,
    aq_strength: float | None = None,
    psy: bool | None = None,
    psy_rd: str | None = None,
    rc_lookahead: int | None = None,
    weightb: bool | None = None,
    weightp: (
        int | None | Literal["none", "simple", "smart"]
    ) = None,
    ssim: bool | None = None,
    intra_refresh: bool | None = None,
    bluray_compat: bool | None = None,
    b_bias: int | None = None,
    b_pyramid: (
        int | None | Literal["none", "strict", "normal"]
    ) = None,
    mixed_refs: bool | None = None,
    _8x8dct: bool | None = None,
    fast_pskip: bool | None = None,
    aud: bool | None = None,
    mbtree: bool | None = None,
    deblock: str | None = None,
    cplxblur: float | None = None,
    partitions: str | None = None,
    direct_pred: (
        int
        | None
        | Literal["none", "spatial", "temporal", "auto"]
    ) = None,
    slice_max_size: int | None = None,
    stats: str | None = None,
    nal_hrd: (
        int | None | Literal["none", "vbr", "cbr"]
    ) = None,
    avcintra_class: int | None = None,
    me_method: (
        int
        | None
        | Literal["dia", "hex", "umh", "esa", "tesa"]
    ) = None,
    forced_idr: bool | None = None,
    coder: (
        int
        | None
        | Literal["default", "cavlc", "cabac", "vlc", "ac"]
    ) = None,
    b_strategy: int | None = None,
    chromaoffset: int | None = None,
    sc_threshold: int | None = None,
    noise_reduction: int | None = None,
    udu_sei: bool | None = None,
    x264_params: str | None = None,
) -> FFMpegEncoderOption

(codec h264)

Parameters:

Name Type Description Default
preset str | None

Set the encoding preset (cf. x264 --fullhelp) (default "medium")

None
tune str | None

Tune the encoding params (cf. x264 --fullhelp)

None
profile str | None

Set profile restrictions (cf. x264 --fullhelp)

None
fastfirstpass bool | None

Use fast settings when encoding first pass (default true)

None
level str | None

Specify level (as defined by Annex A)

None
passlogfile str | None

Filename for 2 pass stats

None
wpredp str | None

Weighted prediction for P-frames

None
a53cc bool | None

Use A53 Closed Captions (if available) (default true)

None
x264opts str | None

x264 options

None
crf float | None

Select the quality for constant quality mode (from -1 to FLT_MAX) (default -1)

None
crf_max float | None

In CRF mode, prevents VBV from lowering quality beyond this point. (from -1 to FLT_MAX) (default -1)

None
qp int | None

Constant quantization parameter rate control method (from -1 to INT_MAX) (default -1)

None
aq_mode int | None | Literal['none', 'variance', 'autovariance', 'autovariance-biased']

AQ method (from -1 to INT_MAX) (default -1)

None
aq_strength float | None

AQ strength. Reduces blocking and blurring in flat and textured areas. (from -1 to FLT_MAX) (default -1)

None
psy bool | None

Use psychovisual optimizations. (default auto)

None
psy_rd str | None

Strength of psychovisual optimization, in : format.

None
rc_lookahead int | None

Number of frames to look ahead for frametype and ratecontrol (from -1 to INT_MAX) (default -1)

None
weightb bool | None

Weighted prediction for B-frames. (default auto)

None
weightp int | None | Literal['none', 'simple', 'smart']

Weighted prediction analysis method. (from -1 to INT_MAX) (default -1)

None
ssim bool | None

Calculate and print SSIM stats. (default auto)

None
intra_refresh bool | None

Use Periodic Intra Refresh instead of IDR frames. (default auto)

None
bluray_compat bool | None

Bluray compatibility workarounds. (default auto)

None
b_bias int | None

Influences how often B-frames are used (from INT_MIN to INT_MAX) (default INT_MIN)

None
b_pyramid int | None | Literal['none', 'strict', 'normal']

Keep some B-frames as references. (from -1 to INT_MAX) (default -1)

None
mixed_refs bool | None

One reference per partition, as opposed to one reference per macroblock (default auto)

None
_8x8dct bool | None

High profile 8x8 transform. (default auto)

None
fast_pskip bool | None

(default auto)

None
aud bool | None

Use access unit delimiters. (default auto)

None
mbtree bool | None

Use macroblock tree ratecontrol. (default auto)

None
deblock str | None

Loop filter parameters, in form.

None
cplxblur float | None

Reduce fluctuations in QP (before curve compression) (from -1 to FLT_MAX) (default -1)

None
partitions str | None

A comma-separated list of partitions to consider. Possible values: p8x8, p4x4, b8x8, i8x8, i4x4, none, all

None
direct_pred int | None | Literal['none', 'spatial', 'temporal', 'auto']

Direct MV prediction mode (from -1 to INT_MAX) (default -1)

None
slice_max_size int | None

Limit the size of each slice in bytes (from -1 to INT_MAX) (default -1)

None
stats str | None

Filename for 2 pass stats

None
nal_hrd int | None | Literal['none', 'vbr', 'cbr']

Signal HRD information (requires vbv-bufsize; cbr not allowed in .mp4) (from -1 to INT_MAX) (default -1)

None
avcintra_class int | None

AVC-Intra class 50/100/200/300/480 (from -1 to 480) (default -1)

None
me_method int | None | Literal['dia', 'hex', 'umh', 'esa', 'tesa']

Set motion estimation method (from -1 to 4) (default -1)

None
forced_idr bool | None

If forcing keyframes, force them as IDR frames. (default false)

None
coder int | None | Literal['default', 'cavlc', 'cabac', 'vlc', 'ac']

Coder type (from -1 to 1) (default default)

None
b_strategy int | None

Strategy to choose between I/P/B-frames (from -1 to 2) (default -1)

None
chromaoffset int | None

QP difference between chroma and luma (from INT_MIN to INT_MAX) (default 0)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default -1)

None
noise_reduction int | None

Noise reduction (from INT_MIN to INT_MAX) (default -1)

None
udu_sei bool | None

Use user data unregistered SEI if available (default false)

None
x264_params str | None

Override the x264 configuration using a :-separated list of key=value parameters

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

libx264rgb

libx264rgb(
    preset: str | None = None,
    tune: str | None = None,
    profile: str | None = None,
    fastfirstpass: bool | None = None,
    level: str | None = None,
    passlogfile: str | None = None,
    wpredp: str | None = None,
    a53cc: bool | None = None,
    x264opts: str | None = None,
    crf: float | None = None,
    crf_max: float | None = None,
    qp: int | None = None,
    aq_mode: (
        int
        | None
        | Literal[
            "none",
            "variance",
            "autovariance",
            "autovariance-biased",
        ]
    ) = None,
    aq_strength: float | None = None,
    psy: bool | None = None,
    psy_rd: str | None = None,
    rc_lookahead: int | None = None,
    weightb: bool | None = None,
    weightp: (
        int | None | Literal["none", "simple", "smart"]
    ) = None,
    ssim: bool | None = None,
    intra_refresh: bool | None = None,
    bluray_compat: bool | None = None,
    b_bias: int | None = None,
    b_pyramid: (
        int | None | Literal["none", "strict", "normal"]
    ) = None,
    mixed_refs: bool | None = None,
    _8x8dct: bool | None = None,
    fast_pskip: bool | None = None,
    aud: bool | None = None,
    mbtree: bool | None = None,
    deblock: str | None = None,
    cplxblur: float | None = None,
    partitions: str | None = None,
    direct_pred: (
        int
        | None
        | Literal["none", "spatial", "temporal", "auto"]
    ) = None,
    slice_max_size: int | None = None,
    stats: str | None = None,
    nal_hrd: (
        int | None | Literal["none", "vbr", "cbr"]
    ) = None,
    avcintra_class: int | None = None,
    me_method: (
        int
        | None
        | Literal["dia", "hex", "umh", "esa", "tesa"]
    ) = None,
    forced_idr: bool | None = None,
    coder: (
        int
        | None
        | Literal["default", "cavlc", "cabac", "vlc", "ac"]
    ) = None,
    b_strategy: int | None = None,
    chromaoffset: int | None = None,
    sc_threshold: int | None = None,
    noise_reduction: int | None = None,
    udu_sei: bool | None = None,
    x264_params: str | None = None,
) -> FFMpegEncoderOption

(codec h264)

Parameters:

Name Type Description Default
preset str | None

Set the encoding preset (cf. x264 --fullhelp) (default "medium")

None
tune str | None

Tune the encoding params (cf. x264 --fullhelp)

None
profile str | None

Set profile restrictions (cf. x264 --fullhelp)

None
fastfirstpass bool | None

Use fast settings when encoding first pass (default true)

None
level str | None

Specify level (as defined by Annex A)

None
passlogfile str | None

Filename for 2 pass stats

None
wpredp str | None

Weighted prediction for P-frames

None
a53cc bool | None

Use A53 Closed Captions (if available) (default true)

None
x264opts str | None

x264 options

None
crf float | None

Select the quality for constant quality mode (from -1 to FLT_MAX) (default -1)

None
crf_max float | None

In CRF mode, prevents VBV from lowering quality beyond this point. (from -1 to FLT_MAX) (default -1)

None
qp int | None

Constant quantization parameter rate control method (from -1 to INT_MAX) (default -1)

None
aq_mode int | None | Literal['none', 'variance', 'autovariance', 'autovariance-biased']

AQ method (from -1 to INT_MAX) (default -1)

None
aq_strength float | None

AQ strength. Reduces blocking and blurring in flat and textured areas. (from -1 to FLT_MAX) (default -1)

None
psy bool | None

Use psychovisual optimizations. (default auto)

None
psy_rd str | None

Strength of psychovisual optimization, in : format.

None
rc_lookahead int | None

Number of frames to look ahead for frametype and ratecontrol (from -1 to INT_MAX) (default -1)

None
weightb bool | None

Weighted prediction for B-frames. (default auto)

None
weightp int | None | Literal['none', 'simple', 'smart']

Weighted prediction analysis method. (from -1 to INT_MAX) (default -1)

None
ssim bool | None

Calculate and print SSIM stats. (default auto)

None
intra_refresh bool | None

Use Periodic Intra Refresh instead of IDR frames. (default auto)

None
bluray_compat bool | None

Bluray compatibility workarounds. (default auto)

None
b_bias int | None

Influences how often B-frames are used (from INT_MIN to INT_MAX) (default INT_MIN)

None
b_pyramid int | None | Literal['none', 'strict', 'normal']

Keep some B-frames as references. (from -1 to INT_MAX) (default -1)

None
mixed_refs bool | None

One reference per partition, as opposed to one reference per macroblock (default auto)

None
_8x8dct bool | None

High profile 8x8 transform. (default auto)

None
fast_pskip bool | None

(default auto)

None
aud bool | None

Use access unit delimiters. (default auto)

None
mbtree bool | None

Use macroblock tree ratecontrol. (default auto)

None
deblock str | None

Loop filter parameters, in form.

None
cplxblur float | None

Reduce fluctuations in QP (before curve compression) (from -1 to FLT_MAX) (default -1)

None
partitions str | None

A comma-separated list of partitions to consider. Possible values: p8x8, p4x4, b8x8, i8x8, i4x4, none, all

None
direct_pred int | None | Literal['none', 'spatial', 'temporal', 'auto']

Direct MV prediction mode (from -1 to INT_MAX) (default -1)

None
slice_max_size int | None

Limit the size of each slice in bytes (from -1 to INT_MAX) (default -1)

None
stats str | None

Filename for 2 pass stats

None
nal_hrd int | None | Literal['none', 'vbr', 'cbr']

Signal HRD information (requires vbv-bufsize; cbr not allowed in .mp4) (from -1 to INT_MAX) (default -1)

None
avcintra_class int | None

AVC-Intra class 50/100/200/300/480 (from -1 to 480) (default -1)

None
me_method int | None | Literal['dia', 'hex', 'umh', 'esa', 'tesa']

Set motion estimation method (from -1 to 4) (default -1)

None
forced_idr bool | None

If forcing keyframes, force them as IDR frames. (default false)

None
coder int | None | Literal['default', 'cavlc', 'cabac', 'vlc', 'ac']

Coder type (from -1 to 1) (default default)

None
b_strategy int | None

Strategy to choose between I/P/B-frames (from -1 to 2) (default -1)

None
chromaoffset int | None

QP difference between chroma and luma (from INT_MIN to INT_MAX) (default 0)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default -1)

None
noise_reduction int | None

Noise reduction (from INT_MIN to INT_MAX) (default -1)

None
udu_sei bool | None

Use user data unregistered SEI if available (default false)

None
x264_params str | None

Override the x264 configuration using a :-separated list of key=value parameters

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

libx265

libx265(
    crf: float | None = None,
    qp: int | None = None,
    forced_idr: bool | None = None,
    preset: str | None = None,
    tune: str | None = None,
    profile: str | None = None,
    udu_sei: bool | None = None,
    x265_params: str | None = None,
) -> FFMpegEncoderOption

(codec hevc)

Parameters:

Name Type Description Default
crf float | None

set the x265 crf (from -1 to FLT_MAX) (default -1)

None
qp int | None

set the x265 qp (from -1 to INT_MAX) (default -1)

None
forced_idr bool | None

if forcing keyframes, force them as IDR frames (default false)

None
preset str | None

set the x265 preset

None
tune str | None

set the x265 tune parameter

None
profile str | None

set the x265 profile

None
udu_sei bool | None

Use user data unregistered SEI if available (default false)

None
x265_params str | None

set the x265 configuration using a :-separated list of key=value parameters

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

libxvid

libxvid(
    lumi_aq: int | None = None,
    variance_aq: int | None = None,
    ssim: (
        int | None | Literal["off", "avg", "frame"]
    ) = None,
    ssim_acc: int | None = None,
    gmc: int | None = None,
    me_quality: int | None = None,
    mpeg_quant: int | None = None,
) -> FFMpegEncoderOption

(codec mpeg4)

Parameters:

Name Type Description Default
lumi_aq int | None

Luminance masking AQ (from 0 to 1) (default 0)

None
variance_aq int | None

Variance AQ (from 0 to 1) (default 0)

None
ssim int | None | Literal['off', 'avg', 'frame']

Show SSIM information to stdout (from 0 to 2) (default off)

None
ssim_acc int | None

SSIM accuracy (from 0 to 4) (default 2)

None
gmc int | None

use GMC (from 0 to 1) (default 0)

None
me_quality int | None

Motion estimation quality (from 0 to 6) (default 4)

None
mpeg_quant int | None

Use MPEG quantizers instead of H.263 (from 0 to 1) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

ljpeg

ljpeg(
    pred: (
        int | None | Literal["left", "plane", "median"]
    ) = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
pred int | None | Literal['left', 'plane', 'median']

Prediction method (from 1 to 3) (default left)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

magicyuv

magicyuv(
    pred: (
        int | None | Literal["left", "gradient", "median"]
    ) = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
pred int | None | Literal['left', 'gradient', 'median']

Prediction method (from 1 to 3) (default left)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

mjpeg

mjpeg(
    mpv_flags: str | None = None,
    luma_elim_threshold: int | None = None,
    chroma_elim_threshold: int | None = None,
    quantizer_noise_shaping: int | None = None,
    error_rate: int | None = None,
    qsquish: float | None = None,
    rc_qmod_amp: float | None = None,
    rc_qmod_freq: int | None = None,
    rc_eq: str | None = None,
    rc_init_cplx: float | None = None,
    rc_buf_aggressivity: float | None = None,
    border_mask: float | None = None,
    lmin: int | None = None,
    lmax: int | None = None,
    skip_threshold: int | None = None,
    skip_factor: int | None = None,
    skip_exp: int | None = None,
    skip_cmp: (
        int
        | None
        | Literal[
            "sad",
            "sse",
            "satd",
            "dct",
            "psnr",
            "bit",
            "rd",
            "zero",
            "vsad",
            "vsse",
            "nsse",
            "dct264",
            "dctmax",
            "chroma",
            "msad",
        ]
    ) = None,
    sc_threshold: int | None = None,
    noise_reduction: int | None = None,
    ps: int | None = None,
    huffman: (
        int | None | Literal["default", "optimal"]
    ) = None,
    force_duplicated_matrix: bool | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
mpv_flags str | None

Flags common for all mpegvideo-based encoders. (default 0)

None
luma_elim_threshold int | None

single coefficient elimination threshold for luminance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
chroma_elim_threshold int | None

single coefficient elimination threshold for chrominance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
quantizer_noise_shaping int | None

(from 0 to INT_MAX) (default 0)

None
error_rate int | None

Simulate errors in the bitstream to test error concealment. (from 0 to INT_MAX) (default 0)

None
qsquish float | None

how to keep quantizer between qmin and qmax (0 = clip, 1 = use differentiable function) (from 0 to 99) (default 0)

None
rc_qmod_amp float | None

experimental quantizer modulation (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_qmod_freq int | None

experimental quantizer modulation (from INT_MIN to INT_MAX) (default 0)

None
rc_eq str | None

Set rate control equation. When computing the expression, besides the standard functions defined in the section 'Expression Evaluation', the following functions are available: bits2qp(bits), qp2bits(qp). Also the following constants are available: iTex pTex tex mv fCode iCount mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex avgTex.

None
rc_init_cplx float | None

initial complexity for 1-pass encoding (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_buf_aggressivity float | None

currently useless (from -FLT_MAX to FLT_MAX) (default 1)

None
border_mask float | None

increase the quantizer for macroblocks close to borders (from -FLT_MAX to FLT_MAX) (default 0)

None
lmin int | None

minimum Lagrange factor (VBR) (from 0 to INT_MAX) (default 236)

None
lmax int | None

maximum Lagrange factor (VBR) (from 0 to INT_MAX) (default 3658)

None
skip_threshold int | None

Frame skip threshold (from INT_MIN to INT_MAX) (default 0)

None
skip_factor int | None

Frame skip factor (from INT_MIN to INT_MAX) (default 0)

None
skip_exp int | None

Frame skip exponent (from INT_MIN to INT_MAX) (default 0)

None
skip_cmp int | None | Literal['sad', 'sse', 'satd', 'dct', 'psnr', 'bit', 'rd', 'zero', 'vsad', 'vsse', 'nsse', 'dct264', 'dctmax', 'chroma', 'msad']

Frame skip compare function (from INT_MIN to INT_MAX) (default dctmax)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default 0)

None
noise_reduction int | None

Noise reduction (from INT_MIN to INT_MAX) (default 0)

None
ps int | None

RTP payload size in bytes (from INT_MIN to INT_MAX) (default 0)

None
huffman int | None | Literal['default', 'optimal']

Huffman table strategy (from 0 to 1) (default optimal)

None
force_duplicated_matrix bool | None

Always write luma and chroma matrix for mjpeg, useful for rtp streaming. (default false)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

mlp

Returns:

Type Description
FFMpegEncoderOption

the set codec options

mov_text

mov_text(height: int | None = None) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
height int | None

Frame height, usually video height (from 0 to INT_MAX) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

mp2

Returns:

Type Description
FFMpegEncoderOption

the set codec options

mp2fixed

mp2fixed() -> FFMpegEncoderOption

(codec mp2)

Returns:

Type Description
FFMpegEncoderOption

the set codec options

mpeg1video

mpeg1video(
    gop_timecode: str | None = None,
    drop_frame_timecode: bool | None = None,
    scan_offset: bool | None = None,
    timecode_frame_start: int | None = None,
    b_strategy: int | None = None,
    b_sensitivity: int | None = None,
    brd_scale: int | None = None,
    mpv_flags: str | None = None,
    luma_elim_threshold: int | None = None,
    chroma_elim_threshold: int | None = None,
    quantizer_noise_shaping: int | None = None,
    error_rate: int | None = None,
    qsquish: float | None = None,
    rc_qmod_amp: float | None = None,
    rc_qmod_freq: int | None = None,
    rc_eq: str | None = None,
    rc_init_cplx: float | None = None,
    rc_buf_aggressivity: float | None = None,
    border_mask: float | None = None,
    lmin: int | None = None,
    lmax: int | None = None,
    skip_threshold: int | None = None,
    skip_factor: int | None = None,
    skip_exp: int | None = None,
    skip_cmp: (
        int
        | None
        | Literal[
            "sad",
            "sse",
            "satd",
            "dct",
            "psnr",
            "bit",
            "rd",
            "zero",
            "vsad",
            "vsse",
            "nsse",
            "dct264",
            "dctmax",
            "chroma",
            "msad",
        ]
    ) = None,
    sc_threshold: int | None = None,
    noise_reduction: int | None = None,
    ps: int | None = None,
    motion_est: (
        int | None | Literal["zero", "epzs", "xone"]
    ) = None,
    mepc: int | None = None,
    mepre: int | None = None,
    intra_penalty: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
gop_timecode str | None

MPEG GOP Timecode in hh:mm:ss[:;.]ff format. Overrides timecode_frame_start.

None
drop_frame_timecode bool | None

Timecode is in drop frame format. (default false)

None
scan_offset bool | None

Reserve space for SVCD scan offset user data. (default false)

None
timecode_frame_start int | None

GOP timecode frame start number, in non-drop-frame format (from -1 to I64_MAX) (default -1)

None
b_strategy int | None

Strategy to choose between I/P/B-frames (from 0 to 2) (default 0)

None
b_sensitivity int | None

Adjust sensitivity of b_frame_strategy 1 (from 1 to INT_MAX) (default 40)

None
brd_scale int | None

Downscale frames for dynamic B-frame decision (from 0 to 3) (default 0)

None
mpv_flags str | None

Flags common for all mpegvideo-based encoders. (default 0)

None
luma_elim_threshold int | None

single coefficient elimination threshold for luminance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
chroma_elim_threshold int | None

single coefficient elimination threshold for chrominance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
quantizer_noise_shaping int | None

(from 0 to INT_MAX) (default 0)

None
error_rate int | None

Simulate errors in the bitstream to test error concealment. (from 0 to INT_MAX) (default 0)

None
qsquish float | None

how to keep quantizer between qmin and qmax (0 = clip, 1 = use differentiable function) (from 0 to 99) (default 0)

None
rc_qmod_amp float | None

experimental quantizer modulation (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_qmod_freq int | None

experimental quantizer modulation (from INT_MIN to INT_MAX) (default 0)

None
rc_eq str | None

Set rate control equation. When computing the expression, besides the standard functions defined in the section 'Expression Evaluation', the following functions are available: bits2qp(bits), qp2bits(qp). Also the following constants are available: iTex pTex tex mv fCode iCount mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex avgTex.

None
rc_init_cplx float | None

initial complexity for 1-pass encoding (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_buf_aggressivity float | None

currently useless (from -FLT_MAX to FLT_MAX) (default 1)

None
border_mask float | None

increase the quantizer for macroblocks close to borders (from -FLT_MAX to FLT_MAX) (default 0)

None
lmin int | None

minimum Lagrange factor (VBR) (from 0 to INT_MAX) (default 236)

None
lmax int | None

maximum Lagrange factor (VBR) (from 0 to INT_MAX) (default 3658)

None
skip_threshold int | None

Frame skip threshold (from INT_MIN to INT_MAX) (default 0)

None
skip_factor int | None

Frame skip factor (from INT_MIN to INT_MAX) (default 0)

None
skip_exp int | None

Frame skip exponent (from INT_MIN to INT_MAX) (default 0)

None
skip_cmp int | None | Literal['sad', 'sse', 'satd', 'dct', 'psnr', 'bit', 'rd', 'zero', 'vsad', 'vsse', 'nsse', 'dct264', 'dctmax', 'chroma', 'msad']

Frame skip compare function (from INT_MIN to INT_MAX) (default dctmax)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default 0)

None
noise_reduction int | None

Noise reduction (from INT_MIN to INT_MAX) (default 0)

None
ps int | None

RTP payload size in bytes (from INT_MIN to INT_MAX) (default 0)

None
motion_est int | None | Literal['zero', 'epzs', 'xone']

motion estimation algorithm (from 0 to 2) (default epzs)

None
mepc int | None

Motion estimation bitrate penalty compensation (1.0 = 256) (from INT_MIN to INT_MAX) (default 256)

None
mepre int | None

pre motion estimation (from INT_MIN to INT_MAX) (default 0)

None
intra_penalty int | None

Penalty for intra blocks in block decision (from 0 to 1.07374e+09) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

mpeg2video

mpeg2video(
    gop_timecode: str | None = None,
    drop_frame_timecode: bool | None = None,
    scan_offset: bool | None = None,
    timecode_frame_start: int | None = None,
    b_strategy: int | None = None,
    b_sensitivity: int | None = None,
    brd_scale: int | None = None,
    intra_vlc: bool | None = None,
    non_linear_quant: bool | None = None,
    alternate_scan: bool | None = None,
    a53cc: bool | None = None,
    seq_disp_ext: (
        int | None | Literal["auto", "never", "always"]
    ) = None,
    video_format: (
        int
        | None
        | Literal[
            "component",
            "pal",
            "ntsc",
            "secam",
            "mac",
            "unspecified",
        ]
    ) = None,
    mpv_flags: str | None = None,
    luma_elim_threshold: int | None = None,
    chroma_elim_threshold: int | None = None,
    quantizer_noise_shaping: int | None = None,
    error_rate: int | None = None,
    qsquish: float | None = None,
    rc_qmod_amp: float | None = None,
    rc_qmod_freq: int | None = None,
    rc_eq: str | None = None,
    rc_init_cplx: float | None = None,
    rc_buf_aggressivity: float | None = None,
    border_mask: float | None = None,
    lmin: int | None = None,
    lmax: int | None = None,
    skip_threshold: int | None = None,
    skip_factor: int | None = None,
    skip_exp: int | None = None,
    skip_cmp: (
        int
        | None
        | Literal[
            "sad",
            "sse",
            "satd",
            "dct",
            "psnr",
            "bit",
            "rd",
            "zero",
            "vsad",
            "vsse",
            "nsse",
            "dct264",
            "dctmax",
            "chroma",
            "msad",
        ]
    ) = None,
    sc_threshold: int | None = None,
    noise_reduction: int | None = None,
    ps: int | None = None,
    motion_est: (
        int | None | Literal["zero", "epzs", "xone"]
    ) = None,
    mepc: int | None = None,
    mepre: int | None = None,
    intra_penalty: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
gop_timecode str | None

MPEG GOP Timecode in hh:mm:ss[:;.]ff format. Overrides timecode_frame_start.

None
drop_frame_timecode bool | None

Timecode is in drop frame format. (default false)

None
scan_offset bool | None

Reserve space for SVCD scan offset user data. (default false)

None
timecode_frame_start int | None

GOP timecode frame start number, in non-drop-frame format (from -1 to I64_MAX) (default -1)

None
b_strategy int | None

Strategy to choose between I/P/B-frames (from 0 to 2) (default 0)

None
b_sensitivity int | None

Adjust sensitivity of b_frame_strategy 1 (from 1 to INT_MAX) (default 40)

None
brd_scale int | None

Downscale frames for dynamic B-frame decision (from 0 to 3) (default 0)

None
intra_vlc bool | None

Use MPEG-2 intra VLC table. (default false)

None
non_linear_quant bool | None

Use nonlinear quantizer. (default false)

None
alternate_scan bool | None

Enable alternate scantable. (default false)

None
a53cc bool | None

Use A53 Closed Captions (if available) (default true)

None
seq_disp_ext int | None | Literal['auto', 'never', 'always']

Write sequence_display_extension blocks. (from -1 to 1) (default auto)

None
video_format int | None | Literal['component', 'pal', 'ntsc', 'secam', 'mac', 'unspecified']

Video_format in the sequence_display_extension indicating the source of the video. (from 0 to 7) (default unspecified)

None
mpv_flags str | None

Flags common for all mpegvideo-based encoders. (default 0)

None
luma_elim_threshold int | None

single coefficient elimination threshold for luminance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
chroma_elim_threshold int | None

single coefficient elimination threshold for chrominance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
quantizer_noise_shaping int | None

(from 0 to INT_MAX) (default 0)

None
error_rate int | None

Simulate errors in the bitstream to test error concealment. (from 0 to INT_MAX) (default 0)

None
qsquish float | None

how to keep quantizer between qmin and qmax (0 = clip, 1 = use differentiable function) (from 0 to 99) (default 0)

None
rc_qmod_amp float | None

experimental quantizer modulation (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_qmod_freq int | None

experimental quantizer modulation (from INT_MIN to INT_MAX) (default 0)

None
rc_eq str | None

Set rate control equation. When computing the expression, besides the standard functions defined in the section 'Expression Evaluation', the following functions are available: bits2qp(bits), qp2bits(qp). Also the following constants are available: iTex pTex tex mv fCode iCount mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex avgTex.

None
rc_init_cplx float | None

initial complexity for 1-pass encoding (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_buf_aggressivity float | None

currently useless (from -FLT_MAX to FLT_MAX) (default 1)

None
border_mask float | None

increase the quantizer for macroblocks close to borders (from -FLT_MAX to FLT_MAX) (default 0)

None
lmin int | None

minimum Lagrange factor (VBR) (from 0 to INT_MAX) (default 236)

None
lmax int | None

maximum Lagrange factor (VBR) (from 0 to INT_MAX) (default 3658)

None
skip_threshold int | None

Frame skip threshold (from INT_MIN to INT_MAX) (default 0)

None
skip_factor int | None

Frame skip factor (from INT_MIN to INT_MAX) (default 0)

None
skip_exp int | None

Frame skip exponent (from INT_MIN to INT_MAX) (default 0)

None
skip_cmp int | None | Literal['sad', 'sse', 'satd', 'dct', 'psnr', 'bit', 'rd', 'zero', 'vsad', 'vsse', 'nsse', 'dct264', 'dctmax', 'chroma', 'msad']

Frame skip compare function (from INT_MIN to INT_MAX) (default dctmax)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default 0)

None
noise_reduction int | None

Noise reduction (from INT_MIN to INT_MAX) (default 0)

None
ps int | None

RTP payload size in bytes (from INT_MIN to INT_MAX) (default 0)

None
motion_est int | None | Literal['zero', 'epzs', 'xone']

motion estimation algorithm (from 0 to 2) (default epzs)

None
mepc int | None

Motion estimation bitrate penalty compensation (1.0 = 256) (from INT_MIN to INT_MAX) (default 256)

None
mepre int | None

pre motion estimation (from INT_MIN to INT_MAX) (default 0)

None
intra_penalty int | None

Penalty for intra blocks in block decision (from 0 to 1.07374e+09) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

mpeg4

mpeg4(
    data_partitioning: bool | None = None,
    alternate_scan: bool | None = None,
    mpeg_quant: int | None = None,
    b_strategy: int | None = None,
    b_sensitivity: int | None = None,
    brd_scale: int | None = None,
    mpv_flags: str | None = None,
    luma_elim_threshold: int | None = None,
    chroma_elim_threshold: int | None = None,
    quantizer_noise_shaping: int | None = None,
    error_rate: int | None = None,
    qsquish: float | None = None,
    rc_qmod_amp: float | None = None,
    rc_qmod_freq: int | None = None,
    rc_eq: str | None = None,
    rc_init_cplx: float | None = None,
    rc_buf_aggressivity: float | None = None,
    border_mask: float | None = None,
    lmin: int | None = None,
    lmax: int | None = None,
    skip_threshold: int | None = None,
    skip_factor: int | None = None,
    skip_exp: int | None = None,
    skip_cmp: (
        int
        | None
        | Literal[
            "sad",
            "sse",
            "satd",
            "dct",
            "psnr",
            "bit",
            "rd",
            "zero",
            "vsad",
            "vsse",
            "nsse",
            "dct264",
            "dctmax",
            "chroma",
            "msad",
        ]
    ) = None,
    sc_threshold: int | None = None,
    noise_reduction: int | None = None,
    ps: int | None = None,
    motion_est: (
        int | None | Literal["zero", "epzs", "xone"]
    ) = None,
    mepc: int | None = None,
    mepre: int | None = None,
    intra_penalty: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
data_partitioning bool | None

Use data partitioning. (default false)

None
alternate_scan bool | None

Enable alternate scantable. (default false)

None
mpeg_quant int | None

Use MPEG quantizers instead of H.263 (from 0 to 1) (default 0)

None
b_strategy int | None

Strategy to choose between I/P/B-frames (from 0 to 2) (default 0)

None
b_sensitivity int | None

Adjust sensitivity of b_frame_strategy 1 (from 1 to INT_MAX) (default 40)

None
brd_scale int | None

Downscale frames for dynamic B-frame decision (from 0 to 3) (default 0)

None
mpv_flags str | None

Flags common for all mpegvideo-based encoders. (default 0)

None
luma_elim_threshold int | None

single coefficient elimination threshold for luminance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
chroma_elim_threshold int | None

single coefficient elimination threshold for chrominance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
quantizer_noise_shaping int | None

(from 0 to INT_MAX) (default 0)

None
error_rate int | None

Simulate errors in the bitstream to test error concealment. (from 0 to INT_MAX) (default 0)

None
qsquish float | None

how to keep quantizer between qmin and qmax (0 = clip, 1 = use differentiable function) (from 0 to 99) (default 0)

None
rc_qmod_amp float | None

experimental quantizer modulation (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_qmod_freq int | None

experimental quantizer modulation (from INT_MIN to INT_MAX) (default 0)

None
rc_eq str | None

Set rate control equation. When computing the expression, besides the standard functions defined in the section 'Expression Evaluation', the following functions are available: bits2qp(bits), qp2bits(qp). Also the following constants are available: iTex pTex tex mv fCode iCount mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex avgTex.

None
rc_init_cplx float | None

initial complexity for 1-pass encoding (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_buf_aggressivity float | None

currently useless (from -FLT_MAX to FLT_MAX) (default 1)

None
border_mask float | None

increase the quantizer for macroblocks close to borders (from -FLT_MAX to FLT_MAX) (default 0)

None
lmin int | None

minimum Lagrange factor (VBR) (from 0 to INT_MAX) (default 236)

None
lmax int | None

maximum Lagrange factor (VBR) (from 0 to INT_MAX) (default 3658)

None
skip_threshold int | None

Frame skip threshold (from INT_MIN to INT_MAX) (default 0)

None
skip_factor int | None

Frame skip factor (from INT_MIN to INT_MAX) (default 0)

None
skip_exp int | None

Frame skip exponent (from INT_MIN to INT_MAX) (default 0)

None
skip_cmp int | None | Literal['sad', 'sse', 'satd', 'dct', 'psnr', 'bit', 'rd', 'zero', 'vsad', 'vsse', 'nsse', 'dct264', 'dctmax', 'chroma', 'msad']

Frame skip compare function (from INT_MIN to INT_MAX) (default dctmax)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default 0)

None
noise_reduction int | None

Noise reduction (from INT_MIN to INT_MAX) (default 0)

None
ps int | None

RTP payload size in bytes (from INT_MIN to INT_MAX) (default 0)

None
motion_est int | None | Literal['zero', 'epzs', 'xone']

motion estimation algorithm (from 0 to 2) (default epzs)

None
mepc int | None

Motion estimation bitrate penalty compensation (1.0 = 256) (from INT_MIN to INT_MAX) (default 256)

None
mepre int | None

pre motion estimation (from INT_MIN to INT_MAX) (default 0)

None
intra_penalty int | None

Penalty for intra blocks in block decision (from 0 to 1.07374e+09) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

mpeg4_v4l2m2m

mpeg4_v4l2m2m(
    num_output_buffers: int | None = None,
    num_capture_buffers: int | None = None,
) -> FFMpegEncoderOption

(codec mpeg4)

Parameters:

Name Type Description Default
num_output_buffers int | None

Number of buffers in the output context (from 6 to INT_MAX) (default 16)

None
num_capture_buffers int | None

Number of buffers in the capture context (from 4 to INT_MAX) (default 4)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

msmpeg4

msmpeg4(
    mpv_flags: str | None = None,
    luma_elim_threshold: int | None = None,
    chroma_elim_threshold: int | None = None,
    quantizer_noise_shaping: int | None = None,
    error_rate: int | None = None,
    qsquish: float | None = None,
    rc_qmod_amp: float | None = None,
    rc_qmod_freq: int | None = None,
    rc_eq: str | None = None,
    rc_init_cplx: float | None = None,
    rc_buf_aggressivity: float | None = None,
    border_mask: float | None = None,
    lmin: int | None = None,
    lmax: int | None = None,
    skip_threshold: int | None = None,
    skip_factor: int | None = None,
    skip_exp: int | None = None,
    skip_cmp: (
        int
        | None
        | Literal[
            "sad",
            "sse",
            "satd",
            "dct",
            "psnr",
            "bit",
            "rd",
            "zero",
            "vsad",
            "vsse",
            "nsse",
            "dct264",
            "dctmax",
            "chroma",
            "msad",
        ]
    ) = None,
    sc_threshold: int | None = None,
    noise_reduction: int | None = None,
    ps: int | None = None,
    motion_est: (
        int | None | Literal["zero", "epzs", "xone"]
    ) = None,
    mepc: int | None = None,
    mepre: int | None = None,
    intra_penalty: int | None = None,
) -> FFMpegEncoderOption

(codec msmpeg4v3)

Parameters:

Name Type Description Default
mpv_flags str | None

Flags common for all mpegvideo-based encoders. (default 0)

None
luma_elim_threshold int | None

single coefficient elimination threshold for luminance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
chroma_elim_threshold int | None

single coefficient elimination threshold for chrominance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
quantizer_noise_shaping int | None

(from 0 to INT_MAX) (default 0)

None
error_rate int | None

Simulate errors in the bitstream to test error concealment. (from 0 to INT_MAX) (default 0)

None
qsquish float | None

how to keep quantizer between qmin and qmax (0 = clip, 1 = use differentiable function) (from 0 to 99) (default 0)

None
rc_qmod_amp float | None

experimental quantizer modulation (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_qmod_freq int | None

experimental quantizer modulation (from INT_MIN to INT_MAX) (default 0)

None
rc_eq str | None

Set rate control equation. When computing the expression, besides the standard functions defined in the section 'Expression Evaluation', the following functions are available: bits2qp(bits), qp2bits(qp). Also the following constants are available: iTex pTex tex mv fCode iCount mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex avgTex.

None
rc_init_cplx float | None

initial complexity for 1-pass encoding (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_buf_aggressivity float | None

currently useless (from -FLT_MAX to FLT_MAX) (default 1)

None
border_mask float | None

increase the quantizer for macroblocks close to borders (from -FLT_MAX to FLT_MAX) (default 0)

None
lmin int | None

minimum Lagrange factor (VBR) (from 0 to INT_MAX) (default 236)

None
lmax int | None

maximum Lagrange factor (VBR) (from 0 to INT_MAX) (default 3658)

None
skip_threshold int | None

Frame skip threshold (from INT_MIN to INT_MAX) (default 0)

None
skip_factor int | None

Frame skip factor (from INT_MIN to INT_MAX) (default 0)

None
skip_exp int | None

Frame skip exponent (from INT_MIN to INT_MAX) (default 0)

None
skip_cmp int | None | Literal['sad', 'sse', 'satd', 'dct', 'psnr', 'bit', 'rd', 'zero', 'vsad', 'vsse', 'nsse', 'dct264', 'dctmax', 'chroma', 'msad']

Frame skip compare function (from INT_MIN to INT_MAX) (default dctmax)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default 0)

None
noise_reduction int | None

Noise reduction (from INT_MIN to INT_MAX) (default 0)

None
ps int | None

RTP payload size in bytes (from INT_MIN to INT_MAX) (default 0)

None
motion_est int | None | Literal['zero', 'epzs', 'xone']

motion estimation algorithm (from 0 to 2) (default epzs)

None
mepc int | None

Motion estimation bitrate penalty compensation (1.0 = 256) (from INT_MIN to INT_MAX) (default 256)

None
mepre int | None

pre motion estimation (from INT_MIN to INT_MAX) (default 0)

None
intra_penalty int | None

Penalty for intra blocks in block decision (from 0 to 1.07374e+09) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

msmpeg4v2

msmpeg4v2(
    mpv_flags: str | None = None,
    luma_elim_threshold: int | None = None,
    chroma_elim_threshold: int | None = None,
    quantizer_noise_shaping: int | None = None,
    error_rate: int | None = None,
    qsquish: float | None = None,
    rc_qmod_amp: float | None = None,
    rc_qmod_freq: int | None = None,
    rc_eq: str | None = None,
    rc_init_cplx: float | None = None,
    rc_buf_aggressivity: float | None = None,
    border_mask: float | None = None,
    lmin: int | None = None,
    lmax: int | None = None,
    skip_threshold: int | None = None,
    skip_factor: int | None = None,
    skip_exp: int | None = None,
    skip_cmp: (
        int
        | None
        | Literal[
            "sad",
            "sse",
            "satd",
            "dct",
            "psnr",
            "bit",
            "rd",
            "zero",
            "vsad",
            "vsse",
            "nsse",
            "dct264",
            "dctmax",
            "chroma",
            "msad",
        ]
    ) = None,
    sc_threshold: int | None = None,
    noise_reduction: int | None = None,
    ps: int | None = None,
    motion_est: (
        int | None | Literal["zero", "epzs", "xone"]
    ) = None,
    mepc: int | None = None,
    mepre: int | None = None,
    intra_penalty: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
mpv_flags str | None

Flags common for all mpegvideo-based encoders. (default 0)

None
luma_elim_threshold int | None

single coefficient elimination threshold for luminance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
chroma_elim_threshold int | None

single coefficient elimination threshold for chrominance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
quantizer_noise_shaping int | None

(from 0 to INT_MAX) (default 0)

None
error_rate int | None

Simulate errors in the bitstream to test error concealment. (from 0 to INT_MAX) (default 0)

None
qsquish float | None

how to keep quantizer between qmin and qmax (0 = clip, 1 = use differentiable function) (from 0 to 99) (default 0)

None
rc_qmod_amp float | None

experimental quantizer modulation (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_qmod_freq int | None

experimental quantizer modulation (from INT_MIN to INT_MAX) (default 0)

None
rc_eq str | None

Set rate control equation. When computing the expression, besides the standard functions defined in the section 'Expression Evaluation', the following functions are available: bits2qp(bits), qp2bits(qp). Also the following constants are available: iTex pTex tex mv fCode iCount mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex avgTex.

None
rc_init_cplx float | None

initial complexity for 1-pass encoding (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_buf_aggressivity float | None

currently useless (from -FLT_MAX to FLT_MAX) (default 1)

None
border_mask float | None

increase the quantizer for macroblocks close to borders (from -FLT_MAX to FLT_MAX) (default 0)

None
lmin int | None

minimum Lagrange factor (VBR) (from 0 to INT_MAX) (default 236)

None
lmax int | None

maximum Lagrange factor (VBR) (from 0 to INT_MAX) (default 3658)

None
skip_threshold int | None

Frame skip threshold (from INT_MIN to INT_MAX) (default 0)

None
skip_factor int | None

Frame skip factor (from INT_MIN to INT_MAX) (default 0)

None
skip_exp int | None

Frame skip exponent (from INT_MIN to INT_MAX) (default 0)

None
skip_cmp int | None | Literal['sad', 'sse', 'satd', 'dct', 'psnr', 'bit', 'rd', 'zero', 'vsad', 'vsse', 'nsse', 'dct264', 'dctmax', 'chroma', 'msad']

Frame skip compare function (from INT_MIN to INT_MAX) (default dctmax)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default 0)

None
noise_reduction int | None

Noise reduction (from INT_MIN to INT_MAX) (default 0)

None
ps int | None

RTP payload size in bytes (from INT_MIN to INT_MAX) (default 0)

None
motion_est int | None | Literal['zero', 'epzs', 'xone']

motion estimation algorithm (from 0 to 2) (default epzs)

None
mepc int | None

Motion estimation bitrate penalty compensation (1.0 = 256) (from INT_MIN to INT_MAX) (default 256)

None
mepre int | None

pre motion estimation (from INT_MIN to INT_MAX) (default 0)

None
intra_penalty int | None

Penalty for intra blocks in block decision (from 0 to 1.07374e+09) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

msvideo1

msvideo1() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

nellymoser

nellymoser() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

opus

opus(
    opus_delay: float | None = None,
    apply_phase_inv: bool | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
opus_delay float | None

Maximum delay in milliseconds (from 2.5 to 360) (default 360)

None
apply_phase_inv bool | None

Apply intensity stereo phase inversion (default true)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pam

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pbm

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_alaw

pcm_alaw() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_bluray

pcm_bluray() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_dvd

pcm_dvd() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_f32be

pcm_f32be() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_f32le

pcm_f32le() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_f64be

pcm_f64be() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_f64le

pcm_f64le() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_mulaw

pcm_mulaw() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_s16be

pcm_s16be() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_s16be_planar

pcm_s16be_planar() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_s16le

pcm_s16le() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_s16le_planar

pcm_s16le_planar() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_s24be

pcm_s24be() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_s24daud

pcm_s24daud() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_s24le

pcm_s24le() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_s24le_planar

pcm_s24le_planar() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_s32be

pcm_s32be() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_s32le

pcm_s32le() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_s32le_planar

pcm_s32le_planar() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_s64be

pcm_s64be() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_s64le

pcm_s64le() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_s8

pcm_s8() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_s8_planar

pcm_s8_planar() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_u16be

pcm_u16be() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_u16le

pcm_u16le() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_u24be

pcm_u24be() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_u24le

pcm_u24le() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_u32be

pcm_u32be() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_u32le

pcm_u32le() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_u8

pcm_u8() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcm_vidc

pcm_vidc() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pcx

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pfm

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pgm

Returns:

Type Description
FFMpegEncoderOption

the set codec options

pgmyuv

pgmyuv() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

phm

Returns:

Type Description
FFMpegEncoderOption

the set codec options

png

png(
    dpi: int | None = None,
    dpm: int | None = None,
    pred: (
        int
        | None
        | Literal[
            "none", "sub", "up", "avg", "paeth", "mixed"
        ]
    ) = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
dpi int | None

Set image resolution (in dots per inch) (from 0 to 65536) (default 0)

None
dpm int | None

Set image resolution (in dots per meter) (from 0 to 65536) (default 0)

None
pred int | None | Literal['none', 'sub', 'up', 'avg', 'paeth', 'mixed']

Prediction method (from 0 to 5) (default none)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

ppm

Returns:

Type Description
FFMpegEncoderOption

the set codec options

prores

prores(vendor: str | None = None) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
vendor str | None

vendor ID (default "fmpg")

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

prores_aw

prores_aw(vendor: str | None = None) -> FFMpegEncoderOption

(codec prores)

Parameters:

Name Type Description Default
vendor str | None

vendor ID (default "fmpg")

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

prores_ks

prores_ks(
    mbs_per_slice: int | None = None,
    profile: (
        int
        | None
        | Literal[
            "auto",
            "proxy",
            "lt",
            "standard",
            "hq",
            "4444",
            "4444xq",
        ]
    ) = None,
    vendor: str | None = None,
    bits_per_mb: int | None = None,
    quant_mat: (
        int
        | None
        | Literal[
            "auto",
            "proxy",
            "lt",
            "standard",
            "hq",
            "default",
        ]
    ) = None,
    alpha_bits: int | None = None,
) -> FFMpegEncoderOption

(codec prores)

Parameters:

Name Type Description Default
mbs_per_slice int | None

macroblocks per slice (from 1 to 8) (default 8)

None
profile int | None | Literal['auto', 'proxy', 'lt', 'standard', 'hq', '4444', '4444xq']

(from -1 to 5) (default auto)

None
vendor str | None

vendor ID (default "Lavc")

None
bits_per_mb int | None

desired bits per macroblock (from 0 to 8192) (default 0)

None
quant_mat int | None | Literal['auto', 'proxy', 'lt', 'standard', 'hq', 'default']

quantiser matrix (from -1 to 6) (default auto)

None
alpha_bits int | None

bits for alpha plane (from 0 to 16) (default 16)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

qoi

Returns:

Type Description
FFMpegEncoderOption

the set codec options

qtrle

Returns:

Type Description
FFMpegEncoderOption

the set codec options

r10k

Returns:

Type Description
FFMpegEncoderOption

the set codec options

r210

Returns:

Type Description
FFMpegEncoderOption

the set codec options

rawvideo

rawvideo() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

real_144

real_144() -> FFMpegEncoderOption

(codec ra_144)

Returns:

Type Description
FFMpegEncoderOption

the set codec options

roq_dpcm

roq_dpcm() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

roqvideo

roqvideo(
    quake3_compat: bool | None = None,
) -> FFMpegEncoderOption

(codec roq)

Parameters:

Name Type Description Default
quake3_compat bool | None

Whether to respect known limitations in Quake 3 decoder (default true)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

rpza

rpza(
    skip_frame_thresh: int | None = None,
    continue_one_color_thresh: int | None = None,
    sixteen_color_thresh: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
skip_frame_thresh int | None

(from 0 to 24) (default 1)

None
continue_one_color_thresh int | None

(from 0 to 24) (default 0)

None
sixteen_color_thresh int | None

(from 0 to 24) (default 1)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

rv10

rv10(
    mpv_flags: str | None = None,
    luma_elim_threshold: int | None = None,
    chroma_elim_threshold: int | None = None,
    quantizer_noise_shaping: int | None = None,
    error_rate: int | None = None,
    qsquish: float | None = None,
    rc_qmod_amp: float | None = None,
    rc_qmod_freq: int | None = None,
    rc_eq: str | None = None,
    rc_init_cplx: float | None = None,
    rc_buf_aggressivity: float | None = None,
    border_mask: float | None = None,
    lmin: int | None = None,
    lmax: int | None = None,
    skip_threshold: int | None = None,
    skip_factor: int | None = None,
    skip_exp: int | None = None,
    skip_cmp: (
        int
        | None
        | Literal[
            "sad",
            "sse",
            "satd",
            "dct",
            "psnr",
            "bit",
            "rd",
            "zero",
            "vsad",
            "vsse",
            "nsse",
            "dct264",
            "dctmax",
            "chroma",
            "msad",
        ]
    ) = None,
    sc_threshold: int | None = None,
    noise_reduction: int | None = None,
    ps: int | None = None,
    motion_est: (
        int | None | Literal["zero", "epzs", "xone"]
    ) = None,
    mepc: int | None = None,
    mepre: int | None = None,
    intra_penalty: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
mpv_flags str | None

Flags common for all mpegvideo-based encoders. (default 0)

None
luma_elim_threshold int | None

single coefficient elimination threshold for luminance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
chroma_elim_threshold int | None

single coefficient elimination threshold for chrominance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
quantizer_noise_shaping int | None

(from 0 to INT_MAX) (default 0)

None
error_rate int | None

Simulate errors in the bitstream to test error concealment. (from 0 to INT_MAX) (default 0)

None
qsquish float | None

how to keep quantizer between qmin and qmax (0 = clip, 1 = use differentiable function) (from 0 to 99) (default 0)

None
rc_qmod_amp float | None

experimental quantizer modulation (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_qmod_freq int | None

experimental quantizer modulation (from INT_MIN to INT_MAX) (default 0)

None
rc_eq str | None

Set rate control equation. When computing the expression, besides the standard functions defined in the section 'Expression Evaluation', the following functions are available: bits2qp(bits), qp2bits(qp). Also the following constants are available: iTex pTex tex mv fCode iCount mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex avgTex.

None
rc_init_cplx float | None

initial complexity for 1-pass encoding (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_buf_aggressivity float | None

currently useless (from -FLT_MAX to FLT_MAX) (default 1)

None
border_mask float | None

increase the quantizer for macroblocks close to borders (from -FLT_MAX to FLT_MAX) (default 0)

None
lmin int | None

minimum Lagrange factor (VBR) (from 0 to INT_MAX) (default 236)

None
lmax int | None

maximum Lagrange factor (VBR) (from 0 to INT_MAX) (default 3658)

None
skip_threshold int | None

Frame skip threshold (from INT_MIN to INT_MAX) (default 0)

None
skip_factor int | None

Frame skip factor (from INT_MIN to INT_MAX) (default 0)

None
skip_exp int | None

Frame skip exponent (from INT_MIN to INT_MAX) (default 0)

None
skip_cmp int | None | Literal['sad', 'sse', 'satd', 'dct', 'psnr', 'bit', 'rd', 'zero', 'vsad', 'vsse', 'nsse', 'dct264', 'dctmax', 'chroma', 'msad']

Frame skip compare function (from INT_MIN to INT_MAX) (default dctmax)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default 0)

None
noise_reduction int | None

Noise reduction (from INT_MIN to INT_MAX) (default 0)

None
ps int | None

RTP payload size in bytes (from INT_MIN to INT_MAX) (default 0)

None
motion_est int | None | Literal['zero', 'epzs', 'xone']

motion estimation algorithm (from 0 to 2) (default epzs)

None
mepc int | None

Motion estimation bitrate penalty compensation (1.0 = 256) (from INT_MIN to INT_MAX) (default 256)

None
mepre int | None

pre motion estimation (from INT_MIN to INT_MAX) (default 0)

None
intra_penalty int | None

Penalty for intra blocks in block decision (from 0 to 1.07374e+09) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

rv20

rv20(
    mpv_flags: str | None = None,
    luma_elim_threshold: int | None = None,
    chroma_elim_threshold: int | None = None,
    quantizer_noise_shaping: int | None = None,
    error_rate: int | None = None,
    qsquish: float | None = None,
    rc_qmod_amp: float | None = None,
    rc_qmod_freq: int | None = None,
    rc_eq: str | None = None,
    rc_init_cplx: float | None = None,
    rc_buf_aggressivity: float | None = None,
    border_mask: float | None = None,
    lmin: int | None = None,
    lmax: int | None = None,
    skip_threshold: int | None = None,
    skip_factor: int | None = None,
    skip_exp: int | None = None,
    skip_cmp: (
        int
        | None
        | Literal[
            "sad",
            "sse",
            "satd",
            "dct",
            "psnr",
            "bit",
            "rd",
            "zero",
            "vsad",
            "vsse",
            "nsse",
            "dct264",
            "dctmax",
            "chroma",
            "msad",
        ]
    ) = None,
    sc_threshold: int | None = None,
    noise_reduction: int | None = None,
    ps: int | None = None,
    motion_est: (
        int | None | Literal["zero", "epzs", "xone"]
    ) = None,
    mepc: int | None = None,
    mepre: int | None = None,
    intra_penalty: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
mpv_flags str | None

Flags common for all mpegvideo-based encoders. (default 0)

None
luma_elim_threshold int | None

single coefficient elimination threshold for luminance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
chroma_elim_threshold int | None

single coefficient elimination threshold for chrominance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
quantizer_noise_shaping int | None

(from 0 to INT_MAX) (default 0)

None
error_rate int | None

Simulate errors in the bitstream to test error concealment. (from 0 to INT_MAX) (default 0)

None
qsquish float | None

how to keep quantizer between qmin and qmax (0 = clip, 1 = use differentiable function) (from 0 to 99) (default 0)

None
rc_qmod_amp float | None

experimental quantizer modulation (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_qmod_freq int | None

experimental quantizer modulation (from INT_MIN to INT_MAX) (default 0)

None
rc_eq str | None

Set rate control equation. When computing the expression, besides the standard functions defined in the section 'Expression Evaluation', the following functions are available: bits2qp(bits), qp2bits(qp). Also the following constants are available: iTex pTex tex mv fCode iCount mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex avgTex.

None
rc_init_cplx float | None

initial complexity for 1-pass encoding (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_buf_aggressivity float | None

currently useless (from -FLT_MAX to FLT_MAX) (default 1)

None
border_mask float | None

increase the quantizer for macroblocks close to borders (from -FLT_MAX to FLT_MAX) (default 0)

None
lmin int | None

minimum Lagrange factor (VBR) (from 0 to INT_MAX) (default 236)

None
lmax int | None

maximum Lagrange factor (VBR) (from 0 to INT_MAX) (default 3658)

None
skip_threshold int | None

Frame skip threshold (from INT_MIN to INT_MAX) (default 0)

None
skip_factor int | None

Frame skip factor (from INT_MIN to INT_MAX) (default 0)

None
skip_exp int | None

Frame skip exponent (from INT_MIN to INT_MAX) (default 0)

None
skip_cmp int | None | Literal['sad', 'sse', 'satd', 'dct', 'psnr', 'bit', 'rd', 'zero', 'vsad', 'vsse', 'nsse', 'dct264', 'dctmax', 'chroma', 'msad']

Frame skip compare function (from INT_MIN to INT_MAX) (default dctmax)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default 0)

None
noise_reduction int | None

Noise reduction (from INT_MIN to INT_MAX) (default 0)

None
ps int | None

RTP payload size in bytes (from INT_MIN to INT_MAX) (default 0)

None
motion_est int | None | Literal['zero', 'epzs', 'xone']

motion estimation algorithm (from 0 to 2) (default epzs)

None
mepc int | None

Motion estimation bitrate penalty compensation (1.0 = 256) (from INT_MIN to INT_MAX) (default 256)

None
mepre int | None

pre motion estimation (from INT_MIN to INT_MAX) (default 0)

None
intra_penalty int | None

Penalty for intra blocks in block decision (from 0 to 1.07374e+09) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

s302m

Returns:

Type Description
FFMpegEncoderOption

the set codec options

sbc

sbc(
    sbc_delay: str | None = None, msbc: bool | None = None
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
sbc_delay str | None

set maximum algorithmic latency (default 0.013)

None
msbc bool | None

use mSBC mode (wideband speech mono SBC) (default false)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

sgi

sgi(rle: int | None = None) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
rle int | None

Use run-length compression (from 0 to 1) (default 1)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

smc

Returns:

Type Description
FFMpegEncoderOption

the set codec options

snow

snow(
    motion_est: (
        int | None | Literal["zero", "epzs", "xone", "iter"]
    ) = None,
    memc_only: bool | None = None,
    no_bitstream: bool | None = None,
    intra_penalty: int | None = None,
    iterative_dia_size: int | None = None,
    sc_threshold: int | None = None,
    pred: int | None | Literal["dwt97", "dwt53"] = None,
    rc_eq: str | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
motion_est int | None | Literal['zero', 'epzs', 'xone', 'iter']

motion estimation algorithm (from 0 to 3) (default epzs)

None
memc_only bool | None

Only do ME/MC (I frames -> ref, P frame -> ME+MC). (default false)

None
no_bitstream bool | None

Skip final bitstream writeout. (default false)

None
intra_penalty int | None

Penalty for intra blocks in block decission (from 0 to INT_MAX) (default 0)

None
iterative_dia_size int | None

Dia size for the iterative ME (from 0 to INT_MAX) (default 0)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default 0)

None
pred int | None | Literal['dwt97', 'dwt53']

Spatial decomposition type (from 0 to 1) (default dwt97)

None
rc_eq str | None

Set rate control equation. When computing the expression, besides the standard functions defined in the section 'Expression Evaluation', the following functions are available: bits2qp(bits), qp2bits(qp). Also the following constants are available: iTex pTex tex mv fCode iCount mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex avgTex.

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

sonic

Returns:

Type Description
FFMpegEncoderOption

the set codec options

sonicls

sonicls() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

speedhq

speedhq(
    mpv_flags: str | None = None,
    luma_elim_threshold: int | None = None,
    chroma_elim_threshold: int | None = None,
    quantizer_noise_shaping: int | None = None,
    error_rate: int | None = None,
    qsquish: float | None = None,
    rc_qmod_amp: float | None = None,
    rc_qmod_freq: int | None = None,
    rc_eq: str | None = None,
    rc_init_cplx: float | None = None,
    rc_buf_aggressivity: float | None = None,
    border_mask: float | None = None,
    lmin: int | None = None,
    lmax: int | None = None,
    skip_threshold: int | None = None,
    skip_factor: int | None = None,
    skip_exp: int | None = None,
    skip_cmp: (
        int
        | None
        | Literal[
            "sad",
            "sse",
            "satd",
            "dct",
            "psnr",
            "bit",
            "rd",
            "zero",
            "vsad",
            "vsse",
            "nsse",
            "dct264",
            "dctmax",
            "chroma",
            "msad",
        ]
    ) = None,
    sc_threshold: int | None = None,
    noise_reduction: int | None = None,
    ps: int | None = None,
    motion_est: (
        int | None | Literal["zero", "epzs", "xone"]
    ) = None,
    mepc: int | None = None,
    mepre: int | None = None,
    intra_penalty: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
mpv_flags str | None

Flags common for all mpegvideo-based encoders. (default 0)

None
luma_elim_threshold int | None

single coefficient elimination threshold for luminance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
chroma_elim_threshold int | None

single coefficient elimination threshold for chrominance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
quantizer_noise_shaping int | None

(from 0 to INT_MAX) (default 0)

None
error_rate int | None

Simulate errors in the bitstream to test error concealment. (from 0 to INT_MAX) (default 0)

None
qsquish float | None

how to keep quantizer between qmin and qmax (0 = clip, 1 = use differentiable function) (from 0 to 99) (default 0)

None
rc_qmod_amp float | None

experimental quantizer modulation (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_qmod_freq int | None

experimental quantizer modulation (from INT_MIN to INT_MAX) (default 0)

None
rc_eq str | None

Set rate control equation. When computing the expression, besides the standard functions defined in the section 'Expression Evaluation', the following functions are available: bits2qp(bits), qp2bits(qp). Also the following constants are available: iTex pTex tex mv fCode iCount mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex avgTex.

None
rc_init_cplx float | None

initial complexity for 1-pass encoding (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_buf_aggressivity float | None

currently useless (from -FLT_MAX to FLT_MAX) (default 1)

None
border_mask float | None

increase the quantizer for macroblocks close to borders (from -FLT_MAX to FLT_MAX) (default 0)

None
lmin int | None

minimum Lagrange factor (VBR) (from 0 to INT_MAX) (default 236)

None
lmax int | None

maximum Lagrange factor (VBR) (from 0 to INT_MAX) (default 3658)

None
skip_threshold int | None

Frame skip threshold (from INT_MIN to INT_MAX) (default 0)

None
skip_factor int | None

Frame skip factor (from INT_MIN to INT_MAX) (default 0)

None
skip_exp int | None

Frame skip exponent (from INT_MIN to INT_MAX) (default 0)

None
skip_cmp int | None | Literal['sad', 'sse', 'satd', 'dct', 'psnr', 'bit', 'rd', 'zero', 'vsad', 'vsse', 'nsse', 'dct264', 'dctmax', 'chroma', 'msad']

Frame skip compare function (from INT_MIN to INT_MAX) (default dctmax)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default 0)

None
noise_reduction int | None

Noise reduction (from INT_MIN to INT_MAX) (default 0)

None
ps int | None

RTP payload size in bytes (from INT_MIN to INT_MAX) (default 0)

None
motion_est int | None | Literal['zero', 'epzs', 'xone']

motion estimation algorithm (from 0 to 2) (default epzs)

None
mepc int | None

Motion estimation bitrate penalty compensation (1.0 = 256) (from INT_MIN to INT_MAX) (default 256)

None
mepre int | None

pre motion estimation (from INT_MIN to INT_MAX) (default 0)

None
intra_penalty int | None

Penalty for intra blocks in block decision (from 0 to 1.07374e+09) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

srt

(codec subrip)

Returns:

Type Description
FFMpegEncoderOption

the set codec options

ssa

(codec ass)

Returns:

Type Description
FFMpegEncoderOption

the set codec options

subrip

subrip() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

sunrast

sunrast(rle: int | None = None) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
rle int | None

Use run-length compression (from 0 to 1) (default 1)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

svq1

svq1(
    motion_est: (
        int | None | Literal["zero", "epzs", "xone"]
    ) = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
motion_est int | None | Literal['zero', 'epzs', 'xone']

Motion estimation algorithm (from 0 to 2) (default epzs)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

targa

targa(rle: int | None = None) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
rle int | None

Use run-length compression (from 0 to 1) (default 1)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

text

Returns:

Type Description
FFMpegEncoderOption

the set codec options

tiff

tiff(
    dpi: int | None = None,
    compression_algo: (
        int
        | None
        | Literal["packbits", "raw", "lzw", "deflate"]
    ) = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
dpi int | None

set the image resolution (in dpi) (from 1 to 65536) (default 72)

None
compression_algo int | None | Literal['packbits', 'raw', 'lzw', 'deflate']

(from 1 to 32946) (default packbits)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

truehd

truehd() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

tta

Returns:

Type Description
FFMpegEncoderOption

the set codec options

ttml

Returns:

Type Description
FFMpegEncoderOption

the set codec options

utvideo

utvideo(
    pred: (
        int
        | None
        | Literal["none", "left", "gradient", "median"]
    ) = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
pred int | None | Literal['none', 'left', 'gradient', 'median']

Prediction method (from 0 to 3) (default left)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

v210

Returns:

Type Description
FFMpegEncoderOption

the set codec options

v308

Returns:

Type Description
FFMpegEncoderOption

the set codec options

v408

Returns:

Type Description
FFMpegEncoderOption

the set codec options

v410

Returns:

Type Description
FFMpegEncoderOption

the set codec options

vbn

vbn(
    format: (
        int | None | Literal["raw", "dxt1", "dxt5"]
    ) = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
format int | None | Literal['raw', 'dxt1', 'dxt5']

Texture format (from 0 to 3) (default dxt5)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

vc2

vc2(
    tolerance: float | None = None,
    slice_width: int | None = None,
    slice_height: int | None = None,
    wavelet_depth: int | None = None,
    wavelet_type: (
        int
        | None
        | Literal["9_7", "5_3", "haar", "haar_noshift"]
    ) = None,
    qm: (
        int | None | Literal["default", "color", "flat"]
    ) = None,
) -> FFMpegEncoderOption

(codec dirac)

Parameters:

Name Type Description Default
tolerance float | None

Max undershoot in percent (from 0 to 45) (default 5)

None
slice_width int | None

Slice width (from 32 to 1024) (default 32)

None
slice_height int | None

Slice height (from 8 to 1024) (default 16)

None
wavelet_depth int | None

Transform depth (from 1 to 5) (default 4)

None
wavelet_type int | None | Literal['9_7', '5_3', 'haar', 'haar_noshift']

Transform type (from 0 to 7) (default 9_7)

None
qm int | None | Literal['default', 'color', 'flat']

Custom quantization matrix (from 0 to 3) (default default)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

vorbis

vorbis() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

vp8_v4l2m2m

vp8_v4l2m2m(
    num_output_buffers: int | None = None,
    num_capture_buffers: int | None = None,
) -> FFMpegEncoderOption

(codec vp8)

Parameters:

Name Type Description Default
num_output_buffers int | None

Number of buffers in the output context (from 6 to INT_MAX) (default 16)

None
num_capture_buffers int | None

Number of buffers in the capture context (from 4 to INT_MAX) (default 4)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

wavpack

wavpack(
    joint_stereo: bool | None = None,
    optimize_mono: bool | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
joint_stereo bool | None

(default auto)

None
optimize_mono bool | None

(default false)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

webvtt

webvtt() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

wmav1

Returns:

Type Description
FFMpegEncoderOption

the set codec options

wmav2

Returns:

Type Description
FFMpegEncoderOption

the set codec options

wmv1

wmv1(
    mpv_flags: str | None = None,
    luma_elim_threshold: int | None = None,
    chroma_elim_threshold: int | None = None,
    quantizer_noise_shaping: int | None = None,
    error_rate: int | None = None,
    qsquish: float | None = None,
    rc_qmod_amp: float | None = None,
    rc_qmod_freq: int | None = None,
    rc_eq: str | None = None,
    rc_init_cplx: float | None = None,
    rc_buf_aggressivity: float | None = None,
    border_mask: float | None = None,
    lmin: int | None = None,
    lmax: int | None = None,
    skip_threshold: int | None = None,
    skip_factor: int | None = None,
    skip_exp: int | None = None,
    skip_cmp: (
        int
        | None
        | Literal[
            "sad",
            "sse",
            "satd",
            "dct",
            "psnr",
            "bit",
            "rd",
            "zero",
            "vsad",
            "vsse",
            "nsse",
            "dct264",
            "dctmax",
            "chroma",
            "msad",
        ]
    ) = None,
    sc_threshold: int | None = None,
    noise_reduction: int | None = None,
    ps: int | None = None,
    motion_est: (
        int | None | Literal["zero", "epzs", "xone"]
    ) = None,
    mepc: int | None = None,
    mepre: int | None = None,
    intra_penalty: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
mpv_flags str | None

Flags common for all mpegvideo-based encoders. (default 0)

None
luma_elim_threshold int | None

single coefficient elimination threshold for luminance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
chroma_elim_threshold int | None

single coefficient elimination threshold for chrominance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
quantizer_noise_shaping int | None

(from 0 to INT_MAX) (default 0)

None
error_rate int | None

Simulate errors in the bitstream to test error concealment. (from 0 to INT_MAX) (default 0)

None
qsquish float | None

how to keep quantizer between qmin and qmax (0 = clip, 1 = use differentiable function) (from 0 to 99) (default 0)

None
rc_qmod_amp float | None

experimental quantizer modulation (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_qmod_freq int | None

experimental quantizer modulation (from INT_MIN to INT_MAX) (default 0)

None
rc_eq str | None

Set rate control equation. When computing the expression, besides the standard functions defined in the section 'Expression Evaluation', the following functions are available: bits2qp(bits), qp2bits(qp). Also the following constants are available: iTex pTex tex mv fCode iCount mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex avgTex.

None
rc_init_cplx float | None

initial complexity for 1-pass encoding (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_buf_aggressivity float | None

currently useless (from -FLT_MAX to FLT_MAX) (default 1)

None
border_mask float | None

increase the quantizer for macroblocks close to borders (from -FLT_MAX to FLT_MAX) (default 0)

None
lmin int | None

minimum Lagrange factor (VBR) (from 0 to INT_MAX) (default 236)

None
lmax int | None

maximum Lagrange factor (VBR) (from 0 to INT_MAX) (default 3658)

None
skip_threshold int | None

Frame skip threshold (from INT_MIN to INT_MAX) (default 0)

None
skip_factor int | None

Frame skip factor (from INT_MIN to INT_MAX) (default 0)

None
skip_exp int | None

Frame skip exponent (from INT_MIN to INT_MAX) (default 0)

None
skip_cmp int | None | Literal['sad', 'sse', 'satd', 'dct', 'psnr', 'bit', 'rd', 'zero', 'vsad', 'vsse', 'nsse', 'dct264', 'dctmax', 'chroma', 'msad']

Frame skip compare function (from INT_MIN to INT_MAX) (default dctmax)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default 0)

None
noise_reduction int | None

Noise reduction (from INT_MIN to INT_MAX) (default 0)

None
ps int | None

RTP payload size in bytes (from INT_MIN to INT_MAX) (default 0)

None
motion_est int | None | Literal['zero', 'epzs', 'xone']

motion estimation algorithm (from 0 to 2) (default epzs)

None
mepc int | None

Motion estimation bitrate penalty compensation (1.0 = 256) (from INT_MIN to INT_MAX) (default 256)

None
mepre int | None

pre motion estimation (from INT_MIN to INT_MAX) (default 0)

None
intra_penalty int | None

Penalty for intra blocks in block decision (from 0 to 1.07374e+09) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

wmv2

wmv2(
    mpv_flags: str | None = None,
    luma_elim_threshold: int | None = None,
    chroma_elim_threshold: int | None = None,
    quantizer_noise_shaping: int | None = None,
    error_rate: int | None = None,
    qsquish: float | None = None,
    rc_qmod_amp: float | None = None,
    rc_qmod_freq: int | None = None,
    rc_eq: str | None = None,
    rc_init_cplx: float | None = None,
    rc_buf_aggressivity: float | None = None,
    border_mask: float | None = None,
    lmin: int | None = None,
    lmax: int | None = None,
    skip_threshold: int | None = None,
    skip_factor: int | None = None,
    skip_exp: int | None = None,
    skip_cmp: (
        int
        | None
        | Literal[
            "sad",
            "sse",
            "satd",
            "dct",
            "psnr",
            "bit",
            "rd",
            "zero",
            "vsad",
            "vsse",
            "nsse",
            "dct264",
            "dctmax",
            "chroma",
            "msad",
        ]
    ) = None,
    sc_threshold: int | None = None,
    noise_reduction: int | None = None,
    ps: int | None = None,
    motion_est: (
        int | None | Literal["zero", "epzs", "xone"]
    ) = None,
    mepc: int | None = None,
    mepre: int | None = None,
    intra_penalty: int | None = None,
) -> FFMpegEncoderOption

Parameters:

Name Type Description Default
mpv_flags str | None

Flags common for all mpegvideo-based encoders. (default 0)

None
luma_elim_threshold int | None

single coefficient elimination threshold for luminance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
chroma_elim_threshold int | None

single coefficient elimination threshold for chrominance (negative values also consider dc coefficient) (from INT_MIN to INT_MAX) (default 0)

None
quantizer_noise_shaping int | None

(from 0 to INT_MAX) (default 0)

None
error_rate int | None

Simulate errors in the bitstream to test error concealment. (from 0 to INT_MAX) (default 0)

None
qsquish float | None

how to keep quantizer between qmin and qmax (0 = clip, 1 = use differentiable function) (from 0 to 99) (default 0)

None
rc_qmod_amp float | None

experimental quantizer modulation (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_qmod_freq int | None

experimental quantizer modulation (from INT_MIN to INT_MAX) (default 0)

None
rc_eq str | None

Set rate control equation. When computing the expression, besides the standard functions defined in the section 'Expression Evaluation', the following functions are available: bits2qp(bits), qp2bits(qp). Also the following constants are available: iTex pTex tex mv fCode iCount mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex avgTex.

None
rc_init_cplx float | None

initial complexity for 1-pass encoding (from -FLT_MAX to FLT_MAX) (default 0)

None
rc_buf_aggressivity float | None

currently useless (from -FLT_MAX to FLT_MAX) (default 1)

None
border_mask float | None

increase the quantizer for macroblocks close to borders (from -FLT_MAX to FLT_MAX) (default 0)

None
lmin int | None

minimum Lagrange factor (VBR) (from 0 to INT_MAX) (default 236)

None
lmax int | None

maximum Lagrange factor (VBR) (from 0 to INT_MAX) (default 3658)

None
skip_threshold int | None

Frame skip threshold (from INT_MIN to INT_MAX) (default 0)

None
skip_factor int | None

Frame skip factor (from INT_MIN to INT_MAX) (default 0)

None
skip_exp int | None

Frame skip exponent (from INT_MIN to INT_MAX) (default 0)

None
skip_cmp int | None | Literal['sad', 'sse', 'satd', 'dct', 'psnr', 'bit', 'rd', 'zero', 'vsad', 'vsse', 'nsse', 'dct264', 'dctmax', 'chroma', 'msad']

Frame skip compare function (from INT_MIN to INT_MAX) (default dctmax)

None
sc_threshold int | None

Scene change threshold (from INT_MIN to INT_MAX) (default 0)

None
noise_reduction int | None

Noise reduction (from INT_MIN to INT_MAX) (default 0)

None
ps int | None

RTP payload size in bytes (from INT_MIN to INT_MAX) (default 0)

None
motion_est int | None | Literal['zero', 'epzs', 'xone']

motion estimation algorithm (from 0 to 2) (default epzs)

None
mepc int | None

Motion estimation bitrate penalty compensation (1.0 = 256) (from INT_MIN to INT_MAX) (default 256)

None
mepre int | None

pre motion estimation (from INT_MIN to INT_MAX) (default 0)

None
intra_penalty int | None

Penalty for intra blocks in block decision (from 0 to 1.07374e+09) (default 0)

None

Returns:

Type Description
FFMpegEncoderOption

the set codec options

wrapped_avframe

wrapped_avframe() -> FFMpegEncoderOption

Returns:

Type Description
FFMpegEncoderOption

the set codec options

xbm

Returns:

Type Description
FFMpegEncoderOption

the set codec options

xface

Returns:

Type Description
FFMpegEncoderOption

the set codec options

xsub

Returns:

Type Description
FFMpegEncoderOption

the set codec options

xwd

Returns:

Type Description
FFMpegEncoderOption

the set codec options

y41p

Returns:

Type Description
FFMpegEncoderOption

the set codec options

yuv4

Returns:

Type Description
FFMpegEncoderOption

the set codec options

zlib

Returns:

Type Description
FFMpegEncoderOption

the set codec options

zmbv

Returns:

Type Description
FFMpegEncoderOption

the set codec options