VPXENC
Section: User Commands (1)
Updated: August 2016
Index
Return to Main Contents
NAME
vpxenc - VP8 and VP9 video codec encoding tool
SYNOPSIS
vpxenc
,<options> -o dst_filename src_filename/
OPTIONS
- -D, --debug
-
Debug mode (makes output deterministic)
- -o <arg>, --output=<arg>
-
Output filename
- --codec=<arg>
-
Codec to use
- -p <arg>, --passes=<arg>
-
Number of passes (1/2)
- --pass=<arg>
-
Pass to execute (1/2)
- --fpf=<arg>
-
First pass statistics file name
- --limit=<arg>
-
Stop encoding after n input frames
- --skip=<arg>
-
Skip the first n input frames
- -d <arg>, --deadline=<arg>
-
Deadline per frame (usec)
- --best
-
Use Best Quality Deadline
- --good
-
Use Good Quality Deadline
- --rt
-
Use Realtime Quality Deadline
- -q, --quiet
-
Do not print encode progress
- -v, --verbose
-
Show encoder parameters
- --psnr
-
Show PSNR in status line
- --webm
-
Output WebM (default when WebM IO is enabled)
- --ivf
-
Output IVF
- -P, --output-partitions
-
Makes encoder output partitions. Requires IVF output!
- --q-hist=<arg>
-
Show quantizer histogram (n-buckets)
- --rate-hist=<arg>
-
Show rate histogram (n-buckets)
- --disable-warnings
-
Disable warnings about potentially incorrect encode settings.
- -y, --disable-warning-prompt
-
Display warnings, but do not prompt user to continue.
- --test-decode=<arg>
-
Test encode/decode mismatch
-
off, fatal, warn
Encoder Global Options:
- --yv12
-
Input file is YV12
- --i420
-
Input file is I420 (default)
- --i422
-
Input file is I422
- --i444
-
Input file is I444
- --i440
-
Input file is I440
- -u <arg>, --usage=<arg>
-
Usage profile number to use
- -t <arg>, --threads=<arg>
-
Max number of threads to use
- --profile=<arg>
-
Bitstream profile number to use
- -w <arg>, --width=<arg>
-
Frame width
- -h <arg>, --height=<arg>
-
Frame height
- --stereo-mode=<arg>
-
Stereo 3D video format
-
mono, left-right, bottom-top, top-bottom, right-left
- --timebase=<arg>
-
Output timestamp precision (fractional seconds)
- --fps=<arg>
-
Stream frame rate (rate/scale)
- --error-resilient=<arg>
-
Enable error resiliency features
- --lag-in-frames=<arg>
-
Max number of frames to lag
Rate Control Options:
- --drop-frame=<arg>
-
Temporal resampling threshold (buf %)
- --resize-allowed=<arg>
-
Spatial resampling enabled (bool)
- --resize-width=<arg>
-
Width of encoded frame
- --resize-height=<arg>
-
Height of encoded frame
- --resize-up=<arg>
-
Upscale threshold (buf %)
- --resize-down=<arg>
-
Downscale threshold (buf %)
- --end-usage=<arg>
-
Rate control mode
-
vbr, cbr, cq, q
- --target-bitrate=<arg>
-
Bitrate (kbps)
- --min-q=<arg>
-
Minimum (best) quantizer
- --max-q=<arg>
-
Maximum (worst) quantizer
- --undershoot-pct=<arg>
-
Datarate undershoot (min) target (%)
- --overshoot-pct=<arg>
-
Datarate overshoot (max) target (%)
- --buf-sz=<arg>
-
Client buffer size (ms)
- --buf-initial-sz=<arg>
-
Client initial buffer size (ms)
- --buf-optimal-sz=<arg>
-
Client optimal buffer size (ms)
Twopass Rate Control Options:
- --bias-pct=<arg>
-
CBR/VBR bias (0=CBR, 100=VBR)
- --minsection-pct=<arg>
-
GOP min bitrate (% of target)
- --maxsection-pct=<arg>
-
GOP max bitrate (% of target)
Keyframe Placement Options:
- --kf-min-dist=<arg>
-
Minimum keyframe interval (frames)
- --kf-max-dist=<arg>
-
Maximum keyframe interval (frames)
- --disable-kf
-
Disable keyframe placement
VP8 Specific Options:
- --cpu-used=<arg>
-
CPU Used (-16..16)
- --auto-alt-ref=<arg>
-
Enable automatic alt reference frames
- --noise-sensitivity=<arg>
-
Noise sensitivity (frames to blur)
- --sharpness=<arg>
-
Loop filter sharpness (0..7)
- --static-thresh=<arg>
-
Motion detection threshold
- --token-parts=<arg>
-
Number of token partitions to use, log2
- --arnr-maxframes=<arg>
-
AltRef max frames (0..15)
- --arnr-strength=<arg>
-
AltRef filter strength (0..6)
- --arnr-type=<arg>
-
AltRef type
- --tune=<arg>
-
Material to favor
-
psnr, ssim
- --cq-level=<arg>
-
Constant/Constrained Quality level
- --max-intra-rate=<arg>
-
Max I-frame bitrate (pct)
- --screen-content-mode=<arg
-
Screen content mode
VP9 Specific Options:
- --cpu-used=<arg>
-
CPU Used (-8..8)
- --auto-alt-ref=<arg>
-
Enable automatic alt reference frames
- --sharpness=<arg>
-
Loop filter sharpness (0..7)
- --static-thresh=<arg>
-
Motion detection threshold
- --tile-columns=<arg>
-
Number of tile columns to use, log2
- --tile-rows=<arg>
-
Number of tile rows to use, log2 (set to 0 while threads > 1)
- --arnr-maxframes=<arg>
-
AltRef max frames (0..15)
- --arnr-strength=<arg>
-
AltRef filter strength (0..6)
- --arnr-type=<arg>
-
AltRef type
- --tune=<arg>
-
Material to favor
-
psnr, ssim
- --cq-level=<arg>
-
Constant/Constrained Quality level
- --max-intra-rate=<arg>
-
Max I-frame bitrate (pct)
- --max-inter-rate=<arg>
-
Max P-frame bitrate (pct)
- --gf-cbr-boost=<arg>
-
Boost for Golden Frame in CBR mode (pct)
- --lossless=<arg>
-
Lossless mode (0: false (default), 1: true)
- --frame-parallel=<arg>
-
Enable frame parallel decodability features
- --aq-mode=<arg>
-
Adaptive quantization mode (0: off (default), 1: variance 2: complexity, 3: cyclic refresh, 4: equator360)
- --frame-boost=<arg>
-
Enable frame periodic boost (0: off (default), 1: on)
- --noise-sensitivity=<arg>
-
Noise sensitivity (frames to blur)
- --tune-content=<arg>
-
Tune content type
-
default, screen
- --color-space=<arg>
-
The color space of input content:
-
unknown, bt601, bt709, smpte170, smpte240, bt2020, reserved, sRGB
- --min-gf-interval=<arg>
-
min gf/arf frame interval (default 0, indicating in-built behavior)
- --max-gf-interval=<arg>
-
max gf/arf frame interval (default 0, indicating in-built behavior)
- --target-level=<arg>
-
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:
- vp8
-
- WebM Project VP8 Encoder v1.6.0
- vp9
-
- WebM Project VP9 Encoder v1.6.0 (default)
-
Use --codec to switch to a non-default encoder.
- -D, --debug
-
Debug mode (makes output deterministic)
- -o <arg>, --output=<arg>
-
Output filename
- --codec=<arg>
-
Codec to use
- -p <arg>, --passes=<arg>
-
Number of passes (1/2)
- --pass=<arg>
-
Pass to execute (1/2)
- --fpf=<arg>
-
First pass statistics file name
- --limit=<arg>
-
Stop encoding after n input frames
- --skip=<arg>
-
Skip the first n input frames
- -d <arg>, --deadline=<arg>
-
Deadline per frame (usec)
- --best
-
Use Best Quality Deadline
- --good
-
Use Good Quality Deadline
- --rt
-
Use Realtime Quality Deadline
- -q, --quiet
-
Do not print encode progress
- -v, --verbose
-
Show encoder parameters
- --psnr
-
Show PSNR in status line
- --webm
-
Output WebM (default when WebM IO is enabled)
- --ivf
-
Output IVF
- -P, --output-partitions
-
Makes encoder output partitions. Requires IVF output!
- --q-hist=<arg>
-
Show quantizer histogram (n-buckets)
- --rate-hist=<arg>
-
Show rate histogram (n-buckets)
- --disable-warnings
-
Disable warnings about potentially incorrect encode settings.
- -y, --disable-warning-prompt
-
Display warnings, but do not prompt user to continue.
- --test-decode=<arg>
-
Test encode/decode mismatch
-
off, fatal, warn
Encoder Global Options:
- --yv12
-
Input file is YV12
- --i420
-
Input file is I420 (default)
- --i422
-
Input file is I422
- --i444
-
Input file is I444
- --i440
-
Input file is I440
- -u <arg>, --usage=<arg>
-
Usage profile number to use
- -t <arg>, --threads=<arg>
-
Max number of threads to use
- --profile=<arg>
-
Bitstream profile number to use
- -w <arg>, --width=<arg>
-
Frame width
- -h <arg>, --height=<arg>
-
Frame height
- --stereo-mode=<arg>
-
Stereo 3D video format
-
mono, left-right, bottom-top, top-bottom, right-left
- --timebase=<arg>
-
Output timestamp precision (fractional seconds)
- --fps=<arg>
-
Stream frame rate (rate/scale)
- --error-resilient=<arg>
-
Enable error resiliency features
- --lag-in-frames=<arg>
-
Max number of frames to lag
Rate Control Options:
- --drop-frame=<arg>
-
Temporal resampling threshold (buf %)
- --resize-allowed=<arg>
-
Spatial resampling enabled (bool)
- --resize-width=<arg>
-
Width of encoded frame
- --resize-height=<arg>
-
Height of encoded frame
- --resize-up=<arg>
-
Upscale threshold (buf %)
- --resize-down=<arg>
-
Downscale threshold (buf %)
- --end-usage=<arg>
-
Rate control mode
-
vbr, cbr, cq, q
- --target-bitrate=<arg>
-
Bitrate (kbps)
- --min-q=<arg>
-
Minimum (best) quantizer
- --max-q=<arg>
-
Maximum (worst) quantizer
- --undershoot-pct=<arg>
-
Datarate undershoot (min) target (%)
- --overshoot-pct=<arg>
-
Datarate overshoot (max) target (%)
- --buf-sz=<arg>
-
Client buffer size (ms)
- --buf-initial-sz=<arg>
-
Client initial buffer size (ms)
- --buf-optimal-sz=<arg>
-
Client optimal buffer size (ms)
Twopass Rate Control Options:
- --bias-pct=<arg>
-
CBR/VBR bias (0=CBR, 100=VBR)
- --minsection-pct=<arg>
-
GOP min bitrate (% of target)
- --maxsection-pct=<arg>
-
GOP max bitrate (% of target)
Keyframe Placement Options:
- --kf-min-dist=<arg>
-
Minimum keyframe interval (frames)
- --kf-max-dist=<arg>
-
Maximum keyframe interval (frames)
- --disable-kf
-
Disable keyframe placement
VP8 Specific Options:
- --cpu-used=<arg>
-
CPU Used (-16..16)
- --auto-alt-ref=<arg>
-
Enable automatic alt reference frames
- --noise-sensitivity=<arg>
-
Noise sensitivity (frames to blur)
- --sharpness=<arg>
-
Loop filter sharpness (0..7)
- --static-thresh=<arg>
-
Motion detection threshold
- --token-parts=<arg>
-
Number of token partitions to use, log2
- --arnr-maxframes=<arg>
-
AltRef max frames (0..15)
- --arnr-strength=<arg>
-
AltRef filter strength (0..6)
- --arnr-type=<arg>
-
AltRef type
- --tune=<arg>
-
Material to favor
-
psnr, ssim
- --cq-level=<arg>
-
Constant/Constrained Quality level
- --max-intra-rate=<arg>
-
Max I-frame bitrate (pct)
- --screen-content-mode=<arg
-
Screen content mode
VP9 Specific Options:
- --cpu-used=<arg>
-
CPU Used (-8..8)
- --auto-alt-ref=<arg>
-
Enable automatic alt reference frames
- --sharpness=<arg>
-
Loop filter sharpness (0..7)
- --static-thresh=<arg>
-
Motion detection threshold
- --tile-columns=<arg>
-
Number of tile columns to use, log2
- --tile-rows=<arg>
-
Number of tile rows to use, log2 (set to 0 while threads > 1)
- --arnr-maxframes=<arg>
-
AltRef max frames (0..15)
- --arnr-strength=<arg>
-
AltRef filter strength (0..6)
- --arnr-type=<arg>
-
AltRef type
- --tune=<arg>
-
Material to favor
-
psnr, ssim
- --cq-level=<arg>
-
Constant/Constrained Quality level
- --max-intra-rate=<arg>
-
Max I-frame bitrate (pct)
- --max-inter-rate=<arg>
-
Max P-frame bitrate (pct)
- --gf-cbr-boost=<arg>
-
Boost for Golden Frame in CBR mode (pct)
- --lossless=<arg>
-
Lossless mode (0: false (default), 1: true)
- --frame-parallel=<arg>
-
Enable frame parallel decodability features
- --aq-mode=<arg>
-
Adaptive quantization mode (0: off (default), 1: variance 2: complexity, 3: cyclic refresh, 4: equator360)
- --frame-boost=<arg>
-
Enable frame periodic boost (0: off (default), 1: on)
- --noise-sensitivity=<arg>
-
Noise sensitivity (frames to blur)
- --tune-content=<arg>
-
Tune content type
-
default, screen
- --color-space=<arg>
-
The color space of input content:
-
unknown, bt601, bt709, smpte170, smpte240, bt2020, reserved, sRGB
- --min-gf-interval=<arg>
-
min gf/arf frame interval (default 0, indicating in-built behavior)
- --max-gf-interval=<arg>
-
max gf/arf frame interval (default 0, indicating in-built behavior)
- --target-level=<arg>
-
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:
- vp8
-
- WebM Project VP8 Encoder v1.6.0
- vp9
-
- WebM Project VP9 Encoder v1.6.0 (default)
-
Use --codec to switch to a non-default encoder.
Index
- NAME
-
- SYNOPSIS
-
- OPTIONS
-
- Encoder Global Options:
-
- Rate Control Options:
-
- Twopass Rate Control Options:
-
- Keyframe Placement Options:
-
- VP8 Specific Options:
-
- VP9 Specific Options:
-
- Stream timebase (--timebase):
-
- Encoder Global Options:
-
- Rate Control Options:
-
- Twopass Rate Control Options:
-
- Keyframe Placement Options:
-
- VP8 Specific Options:
-
- VP9 Specific Options:
-
- Stream timebase (--timebase):
-
- Included encoders:
-
This document was created by
man2html,
using the manual pages.
Time: 13:16:26 GMT, April 18, 2024