--- name: "vpxenc" section: "1" platform: "linux" package: "vpx-tools" version: "1.15.0-2.1+deb13u1" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/vpxenc" --- # vpxenc(1) VP8 and VP9 video codec encoding tool ## NAME vpxenc - VP8 and VP9 video codec encoding tool ## SYNOPSIS **vpxenc** *\ -o dst\_filename src\_filename* ## OPTIONS - **-D**, **--debug** Debug mode (makes output deterministic) - **-o** \, **--output=**\ Output filename - **--codec=**\ Codec to use - **-p** \, **--passes=**\ Number of passes (1/2) - **--pass=**\ Pass to execute (1/2) - **--fpf=**\ First pass statistics file name - **--limit=**\ Stop encoding after n input frames - **--skip=**\ Skip the first n input frames - **-d** \, **--deadline=**\ 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=**\ Show quantizer histogram (n-buckets) - **--rate-hist=**\ 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=**\ 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** \, **--usage=**\ Usage profile number to use - **-t** \, **--threads=**\ Max number of threads to use - **--profile=**\ Bitstream profile number to use - **-w** \, **--width=**\ Frame width - **-h** \, **--height=**\ Frame height - **--stereo-mode=**\ Stereo 3D video format - mono, left-right, bottom-top, top-bottom, right-left - **--timebase=**\ Output timestamp precision (fractional seconds) - **--fps=**\ Stream frame rate (rate/scale) - **--error-resilient=**\ Enable error resiliency features - **--lag-in-frames=**\ Max number of frames to lag ### Rate Control Options: - **--drop-frame=**\ Temporal resampling threshold (buf %) - **--resize-allowed=**\ Spatial resampling enabled (bool) - **--resize-width=**\ Width of encoded frame - **--resize-height=**\ Height of encoded frame - **--resize-up=**\ Upscale threshold (buf %) - **--resize-down=**\ Downscale threshold (buf %) - **--end-usage=**\ Rate control mode - vbr, cbr, cq, q - **--target-bitrate=**\ Bitrate (kbps) - **--min-q=**\ Minimum (best) quantizer - **--max-q=**\ Maximum (worst) quantizer - **--undershoot-pct=**\ Datarate undershoot (min) target (%) - **--overshoot-pct=**\ Datarate overshoot (max) target (%) - **--buf-sz=**\ Client buffer size (ms) - **--buf-initial-sz=**\ Client initial buffer size (ms) - **--buf-optimal-sz=**\ Client optimal buffer size (ms) ### Twopass Rate Control Options: - **--bias-pct=**\ CBR/VBR bias (0=CBR, 100=VBR) - **--minsection-pct=**\ GOP min bitrate (% of target) - **--maxsection-pct=**\ GOP max bitrate (% of target) ### Keyframe Placement Options: - **--kf-min-dist=**\ Minimum keyframe interval (frames) - **--kf-max-dist=**\ Maximum keyframe interval (frames) - **--disable-kf** Disable keyframe placement ### VP8 Specific Options: - **--cpu-used=**\ CPU Used (**-16**..16) - **--auto-alt-ref=**\ Enable automatic alt reference frames - **--noise-sensitivity=**\ Noise sensitivity (frames to blur) - **--sharpness=**\ Loop filter sharpness (0..7) - **--static-thresh=**\ Motion detection threshold - **--token-parts=**\ Number of token partitions to use, log2 - **--arnr-maxframes=**\ AltRef max frames (0..15) - **--arnr-strength=**\ AltRef filter strength (0..6) - **--arnr-type=**\ AltRef type - **--tune=**\ Material to favor - psnr, ssim - **--cq-level=**\ Constant/Constrained Quality level - **--max-intra-rate=**\ Max I-frame bitrate (pct) - **--screen-content-mode=**\ CPU Used (**-8**..8) - **--auto-alt-ref=**\ Enable automatic alt reference frames - **--sharpness=**\ Loop filter sharpness (0..7) - **--static-thresh=**\ Motion detection threshold - **--tile-columns=**\ Number of tile columns to use, log2 - **--tile-rows=**\ Number of tile rows to use, log2 (set to 0 while threads \> 1) - **--arnr-maxframes=**\ AltRef max frames (0..15) - **--arnr-strength=**\ AltRef filter strength (0..6) - **--arnr-type=**\ AltRef type - **--tune=**\ Material to favor - psnr, ssim - **--cq-level=**\ Constant/Constrained Quality level - **--max-intra-rate=**\ Max I-frame bitrate (pct) - **--max-inter-rate=**\ Max P-frame bitrate (pct) - **--gf-cbr-boost=**\ Boost for Golden Frame in CBR mode (pct) - **--lossless=**\ Lossless mode (0: false (default), 1: true) - **--frame-parallel=**\ Enable frame parallel decodability features - **--aq-mode=**\ Adaptive quantization mode (0: off (default), 1: variance 2: complexity, 3: cyclic refresh, 4: equator360) - **--frame-boost=**\ Enable frame periodic boost (0: off (default), 1: on) - **--noise-sensitivity=**\ Noise sensitivity (frames to blur) - **--tune-content=**\ Tune content type - default, screen - **--color-space=**\ The color space of input content: - unknown, bt601, bt709, smpte170, smpte240, bt2020, reserved, sRGB - **--min-gf-interval=**\ min gf/arf frame interval (default 0, indicating in-built behavior) - **--max-gf-interval=**\ max gf/arf frame interval (default 0, indicating in-built behavior) - **--target-level=**\ 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** \, **--output=**\ Output filename - **--codec=**\ Codec to use - **-p** \, **--passes=**\ Number of passes (1/2) - **--pass=**\ Pass to execute (1/2) - **--fpf=**\ First pass statistics file name - **--limit=**\ Stop encoding after n input frames - **--skip=**\ Skip the first n input frames - **-d** \, **--deadline=**\ 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=**\ Show quantizer histogram (n-buckets) - **--rate-hist=**\ 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=**\ 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** \, **--usage=**\ Usage profile number to use - **-t** \, **--threads=**\ Max number of threads to use - **--profile=**\ Bitstream profile number to use - **-w** \, **--width=**\ Frame width - **-h** \, **--height=**\ Frame height - **--stereo-mode=**\ Stereo 3D video format - mono, left-right, bottom-top, top-bottom, right-left - **--timebase=**\ Output timestamp precision (fractional seconds) - **--fps=**\ Stream frame rate (rate/scale) - **--error-resilient=**\ Enable error resiliency features - **--lag-in-frames=**\ Max number of frames to lag ### Rate Control Options: - **--drop-frame=**\ Temporal resampling threshold (buf %) - **--resize-allowed=**\ Spatial resampling enabled (bool) - **--resize-width=**\ Width of encoded frame - **--resize-height=**\ Height of encoded frame - **--resize-up=**\ Upscale threshold (buf %) - **--resize-down=**\ Downscale threshold (buf %) - **--end-usage=**\ Rate control mode - vbr, cbr, cq, q - **--target-bitrate=**\ Bitrate (kbps) - **--min-q=**\ Minimum (best) quantizer - **--max-q=**\ Maximum (worst) quantizer - **--undershoot-pct=**\ Datarate undershoot (min) target (%) - **--overshoot-pct=**\ Datarate overshoot (max) target (%) - **--buf-sz=**\ Client buffer size (ms) - **--buf-initial-sz=**\ Client initial buffer size (ms) - **--buf-optimal-sz=**\ Client optimal buffer size (ms) ### Twopass Rate Control Options: - **--bias-pct=**\ CBR/VBR bias (0=CBR, 100=VBR) - **--minsection-pct=**\ GOP min bitrate (% of target) - **--maxsection-pct=**\ GOP max bitrate (% of target) ### Keyframe Placement Options: - **--kf-min-dist=**\ Minimum keyframe interval (frames) - **--kf-max-dist=**\ Maximum keyframe interval (frames) - **--disable-kf** Disable keyframe placement ### VP8 Specific Options: - **--cpu-used=**\ CPU Used (**-16**..16) - **--auto-alt-ref=**\ Enable automatic alt reference frames - **--noise-sensitivity=**\ Noise sensitivity (frames to blur) - **--sharpness=**\ Loop filter sharpness (0..7) - **--static-thresh=**\ Motion detection threshold - **--token-parts=**\ Number of token partitions to use, log2 - **--arnr-maxframes=**\ AltRef max frames (0..15) - **--arnr-strength=**\ AltRef filter strength (0..6) - **--arnr-type=**\ AltRef type - **--tune=**\ Material to favor - psnr, ssim - **--cq-level=**\ Constant/Constrained Quality level - **--max-intra-rate=**\ Max I-frame bitrate (pct) - **--screen-content-mode=**\ CPU Used (**-8**..8) - **--auto-alt-ref=**\ Enable automatic alt reference frames - **--sharpness=**\ Loop filter sharpness (0..7) - **--static-thresh=**\ Motion detection threshold - **--tile-columns=**\ Number of tile columns to use, log2 - **--tile-rows=**\ Number of tile rows to use, log2 (set to 0 while threads \> 1) - **--arnr-maxframes=**\ AltRef max frames (0..15) - **--arnr-strength=**\ AltRef filter strength (0..6) - **--arnr-type=**\ AltRef type - **--tune=**\ Material to favor - psnr, ssim - **--cq-level=**\ Constant/Constrained Quality level - **--max-intra-rate=**\ Max I-frame bitrate (pct) - **--max-inter-rate=**\ Max P-frame bitrate (pct) - **--gf-cbr-boost=**\ Boost for Golden Frame in CBR mode (pct) - **--lossless=**\ Lossless mode (0: false (default), 1: true) - **--frame-parallel=**\ Enable frame parallel decodability features - **--aq-mode=**\ Adaptive quantization mode (0: off (default), 1: variance 2: complexity, 3: cyclic refresh, 4: equator360) - **--frame-boost=**\ Enable frame periodic boost (0: off (default), 1: on) - **--noise-sensitivity=**\ Noise sensitivity (frames to blur) - **--tune-content=**\ Tune content type - default, screen - **--color-space=**\ The color space of input content: - unknown, bt601, bt709, smpte170, smpte240, bt2020, reserved, sRGB - **--min-gf-interval=**\ min gf/arf frame interval (default 0, indicating in-built behavior) - **--max-gf-interval=**\ max gf/arf frame interval (default 0, indicating in-built behavior) - **--target-level=**\ 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.