Scroll to navigation

VPXENC(1) General Commands Manual VPXENC(1)

NAME

vpxenc - VP8 and VP9 video codec encoding tool

SYNOPSIS

vpxenc <options> -o dst_filename src_filename

OPTIONS

Debug mode (makes output deterministic)
Output filename
Codec to use
Number of passes (1/2)
Pass to execute (1/2)
First pass statistics file name
Stop encoding after n input frames
Skip the first n input frames
Deadline per frame (usec)
Use Best Quality Deadline
Use Good Quality Deadline
Use Realtime Quality Deadline
Do not print encode progress
Show encoder parameters
Show PSNR in status line
Output WebM (default when WebM IO is enabled)
Output IVF
Makes encoder output partitions. Requires IVF output!
Show quantizer histogram (n-buckets)
Show rate histogram (n-buckets)
Disable warnings about potentially incorrect encode settings.
Display warnings, but do not prompt user to continue.
Test encode/decode mismatch
off, fatal, warn

Encoder Global Options:

Input file is YV12
Input file is I420 (default)
Input file is I422
Input file is I444
Input file is I440
Usage profile number to use
Max number of threads to use
Bitstream profile number to use
Frame width
Frame height
Stereo 3D video format
mono, left-right, bottom-top, top-bottom, right-left
Output timestamp precision (fractional seconds)
Stream frame rate (rate/scale)
Enable error resiliency features
Max number of frames to lag

Rate Control Options:

Temporal resampling threshold (buf %)
Spatial resampling enabled (bool)
Width of encoded frame
Height of encoded frame
Upscale threshold (buf %)
Downscale threshold (buf %)
Rate control mode
vbr, cbr, cq, q
Bitrate (kbps)
Minimum (best) quantizer
Maximum (worst) quantizer
Datarate undershoot (min) target (%)
Datarate overshoot (max) target (%)
Client buffer size (ms)
Client initial buffer size (ms)
Client optimal buffer size (ms)

Twopass Rate Control Options:

CBR/VBR bias (0=CBR, 100=VBR)
GOP min bitrate (% of target)
GOP max bitrate (% of target)

Keyframe Placement Options:

Minimum keyframe interval (frames)
Maximum keyframe interval (frames)
Disable keyframe placement

VP8 Specific Options:

CPU Used (-16..16)
Enable automatic alt reference frames
Noise sensitivity (frames to blur)
Loop filter sharpness (0..7)
Motion detection threshold
Number of token partitions to use, log2
AltRef max frames (0..15)
AltRef filter strength (0..6)
AltRef type
Material to favor
psnr, ssim
Constant/Constrained Quality level
Max I-frame bitrate (pct)
Screen content mode

VP9 Specific Options:

CPU Used (-8..8)
Enable automatic alt reference frames
Loop filter sharpness (0..7)
Motion detection threshold
Number of tile columns to use, log2
Number of tile rows to use, log2 (set to 0 while threads > 1)
AltRef max frames (0..15)
AltRef filter strength (0..6)
AltRef type
Material to favor
psnr, ssim
Constant/Constrained Quality level
Max I-frame bitrate (pct)
Max P-frame bitrate (pct)
Boost for Golden Frame in CBR mode (pct)
Lossless mode (0: false (default), 1: true)
Enable frame parallel decodability features
Adaptive quantization mode (0: off (default), 1: variance 2: complexity, 3: cyclic refresh, 4: equator360)
Enable frame periodic boost (0: off (default), 1: on)
Noise sensitivity (frames to blur)
Tune content type
default, screen
The color space of input content:
unknown, bt601, bt709, smpte170, smpte240, bt2020, reserved, sRGB
min gf/arf frame interval (default 0, indicating in-built behavior)
max gf/arf frame interval (default 0, indicating in-built behavior)
Target level (255: off (default); 0: only keep level stats; 10: level 1.0; 11: level 1.1; ... 62: level 6.2)

Stream timebase (--timebase):

The desired precision of timestamps in the output, expressed in fractional seconds. Default is 1/1000.

Included encoders:

- WebM Project VP8 Encoder v1.6.0
- WebM Project VP9 Encoder v1.6.0 (default)
Use --codec to switch to a non-default encoder.
Debug mode (makes output deterministic)
Output filename
Codec to use
Number of passes (1/2)
Pass to execute (1/2)
First pass statistics file name
Stop encoding after n input frames
Skip the first n input frames
Deadline per frame (usec)
Use Best Quality Deadline
Use Good Quality Deadline
Use Realtime Quality Deadline
Do not print encode progress
Show encoder parameters
Show PSNR in status line
Output WebM (default when WebM IO is enabled)
Output IVF
Makes encoder output partitions. Requires IVF output!
Show quantizer histogram (n-buckets)
Show rate histogram (n-buckets)
Disable warnings about potentially incorrect encode settings.
Display warnings, but do not prompt user to continue.
Test encode/decode mismatch
off, fatal, warn

Encoder Global Options:

Input file is YV12
Input file is I420 (default)
Input file is I422
Input file is I444
Input file is I440
Usage profile number to use
Max number of threads to use
Bitstream profile number to use
Frame width
Frame height
Stereo 3D video format
mono, left-right, bottom-top, top-bottom, right-left
Output timestamp precision (fractional seconds)
Stream frame rate (rate/scale)
Enable error resiliency features
Max number of frames to lag

Rate Control Options:

Temporal resampling threshold (buf %)
Spatial resampling enabled (bool)
Width of encoded frame
Height of encoded frame
Upscale threshold (buf %)
Downscale threshold (buf %)
Rate control mode
vbr, cbr, cq, q
Bitrate (kbps)
Minimum (best) quantizer
Maximum (worst) quantizer
Datarate undershoot (min) target (%)
Datarate overshoot (max) target (%)
Client buffer size (ms)
Client initial buffer size (ms)
Client optimal buffer size (ms)

Twopass Rate Control Options:

CBR/VBR bias (0=CBR, 100=VBR)
GOP min bitrate (% of target)
GOP max bitrate (% of target)

Keyframe Placement Options:

Minimum keyframe interval (frames)
Maximum keyframe interval (frames)
Disable keyframe placement

VP8 Specific Options:

CPU Used (-16..16)
Enable automatic alt reference frames
Noise sensitivity (frames to blur)
Loop filter sharpness (0..7)
Motion detection threshold
Number of token partitions to use, log2
AltRef max frames (0..15)
AltRef filter strength (0..6)
AltRef type
Material to favor
psnr, ssim
Constant/Constrained Quality level
Max I-frame bitrate (pct)
Screen content mode

VP9 Specific Options:

CPU Used (-8..8)
Enable automatic alt reference frames
Loop filter sharpness (0..7)
Motion detection threshold
Number of tile columns to use, log2
Number of tile rows to use, log2 (set to 0 while threads > 1)
AltRef max frames (0..15)
AltRef filter strength (0..6)
AltRef type
Material to favor
psnr, ssim
Constant/Constrained Quality level
Max I-frame bitrate (pct)
Max P-frame bitrate (pct)
Boost for Golden Frame in CBR mode (pct)
Lossless mode (0: false (default), 1: true)
Enable frame parallel decodability features
Adaptive quantization mode (0: off (default), 1: variance 2: complexity, 3: cyclic refresh, 4: equator360)
Enable frame periodic boost (0: off (default), 1: on)
Noise sensitivity (frames to blur)
Tune content type
default, screen
The color space of input content:
unknown, bt601, bt709, smpte170, smpte240, bt2020, reserved, sRGB
min gf/arf frame interval (default 0, indicating in-built behavior)
max gf/arf frame interval (default 0, indicating in-built behavior)
Target level (255: off (default); 0: only keep level stats; 10: level 1.0; 11: level 1.1; ... 62: level 6.2)

Stream timebase (--timebase):

The desired precision of timestamps in the output, expressed in fractional seconds. Default is 1/1000.

Included encoders:

- WebM Project VP8 Encoder v1.6.0
- WebM Project VP9 Encoder v1.6.0 (default)
Use --codec to switch to a non-default encoder.
August 2016