Usage: /usr/bin/vpxenc <options> -o dst_filename src_filename
Options:
--help Show usage options and exit
-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:
--nv12 Input file is NV12
--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
--test-16bit-internal Force use of 16 bit internal buffer
--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)
--corpus-complexity=<arg> corpus vbr complexity midpoint
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. (0..1)
--noise-sensitivity=<arg> Noise sensitivity (frames to blur)
--sharpness=<arg> Increase sharpness at the expense of lower PSNR. (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 filter type (1..3)
--tune=<arg> Material to favor
psnr, ssim
--cq-level=<arg> Constant/Constrained Quality level
--max-intra-rate=<arg> Max I-frame bitrate (pct)
--gf-cbr-boost=<arg> Boost for Golden Frame in CBR mode (pct)
--screen-content-mode=<arg> Screen content mode
VP9 Specific Options:
--cpu-used=<arg> CPU Used (-9..9)
--auto-alt-ref=<arg> Enable automatic alt reference frames, 2+ enables multi-layer. (0..6)
--sharpness=<arg> Increase sharpness at the expense of lower PSNR. (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)
--enable-tpl=<arg> Enable temporal dependency model
--enable-keyframe-filtering=<arg>
Enable key frame temporal filtering (0: off (default), 1: on)
--arnr-maxframes=<arg> AltRef max frames (0..15)
--arnr-strength=<arg> AltRef filter strength (0..6)
--arnr-type=<arg> AltRef filter type (1..3)
--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)
--alt-ref-aq=<arg> Special adaptive quantization for the alternate reference frames.
--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, film
--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
1: adaptively set alt-ref distance and column tile limit based on picture size, and keep level stats
10: level 1.0 11: level 1.1 ... 62: level 6.2
--row-mt=<arg> Enable row based non-deterministic multi-threading in VP9
--disable-loopfilter=<arg> Control Loopfilter in VP9:
0: Loopfilter on for all frames (default)
1: Loopfilter off for non reference frames
2: Loopfilter off for all frames
--validate-hbd-input=<arg> Check that input samples are within the valid range for the chosen bit depth with high bit depth encoding (0: disabled, 1: enabled (default))
-b <arg>, --bit-depth=<arg> Bit depth for codec (8 for version <=1, 10 or 12 for version 2)
8, 10, 12
--input-bit-depth=<arg> Actual bit depth of input source
Vizier Rate Control Options:
--use-vizier-rc-params=<arg>
Use vizier rc params
--active-wq-factor=<arg> Active worst quality factor
--err-per-mb-factor=<arg> Error per macroblock factor
--sr-default-decay-limit=<arg>
Second reference default decay limit
--sr-diff-factor=<arg> Second reference diff factor
--kf-err-per-mb-factor=<arg>
Keyframe error per macroblock factor
--kf-frame-min-boost-factor=<arg>
Keyframe min boost
--kf-frame-max-boost-first-factor=<arg>
Max keyframe boost adjustment factor for first frame
--kf-frame-max-boost-subs-factor=<arg>
Max boost adjustment factor for subsequent KFs
--kf-max-total-boost-factor=<arg>
Keyframe max total boost factor
--gf-max-total-boost-factor=<arg>
Golden frame max total boost factor
--gf-frame-max-boost-factor=<arg>
Golden frame max per frame boost factor
--zm-factor=<arg> Zero motion power factor
--rd-mult-inter-qp-fac=<arg>
RD multiplier adjustment for inter frames
--rd-mult-arf-qp-fac=<arg> RD multiplier adjustment for alt-ref frames
--rd-mult-key-qp-fac=<arg> RD multiplier adjustment for key frames
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.17.0
vp9 - WebM Project VP9 Encoder v1.17.0 (default)
Use --codec to switch to a non-default encoder.
Options (112)
| Option | Description | Source |
|---|---|---|
--help | Show usage options and exit | help |
-D | --debug Debug mode (makes output deterministic) | help |
-o, --output arg | Output filename | help |
--codec arg | Codec to use | help |
-p, --passes arg | Number of passes (1/2) | help |
--pass arg | Pass to execute (1/2) | help |
--fpf arg | First pass statistics file name | help |
--limit arg | Stop encoding after n input frames | help |
--skip arg | Skip the first n input frames | help |
-d, --deadline arg | Deadline per frame (usec) | help |
--best | Use Best Quality Deadline | help |
--good | Use Good Quality Deadline | help |
--rt | Use Realtime Quality Deadline | help |
-q | --quiet Do not print encode progress | help |
-v | --verbose Show encoder parameters | help |
--psnr | Show PSNR in status line | help |
--webm | Output WebM (default when WebM IO is enabled) | help |
--ivf | Output IVF | help |
-P | --output-partitions Makes encoder output partitions. | help |
--q-hist arg | Show quantizer histogram (n-buckets) | help |
--rate-hist arg | Show rate histogram (n-buckets) | help |
--disable-warnings | Disable warnings about potentially incorrect encode settings. | help |
-y | --disable-warning-prompt Display warnings, but do not prompt user to continue. | help |
--test-decode arg | Test encode/decode mismatch off, fatal, warn | help |
--nv12 | Input file is NV12 | help |
--yv12 | Input file is YV12 | help |
--i420 | Input file is I420 (default) | help |
--i422 | Input file is I422 | help |
--i444 | Input file is I444 | help |
--i440 | Input file is I440 | help |
-u, --usage arg | Usage profile number to use | help |
-t, --threads arg | Max number of threads to use | help |
--profile arg | Bitstream profile number to use | help |
-w, --width arg | Frame width | help |
-h, --height arg | Frame height | help |
--stereo-mode arg | Stereo 3D video format mono, left-right, bottom-top, top-bottom, right-left | help |
--timebase arg | Output timestamp precision (fractional seconds) | help |
--fps arg | Stream frame rate (rate/scale) | help |
--error-resilient arg | Enable error resiliency features | help |
--test-16bit-internal | Force use of 16 bit internal buffer | help |
--lag-in-frames arg | Max number of frames to lag | help |
--drop-frame arg | Temporal resampling threshold (buf %) | help |
--resize-allowed arg | Spatial resampling enabled (bool) | help |
--resize-width arg | Width of encoded frame | help |
--resize-height arg | Height of encoded frame | help |
--resize-up arg | Upscale threshold (buf %) | help |
--resize-down arg | Downscale threshold (buf %) | help |
--end-usage arg | Rate control mode vbr, cbr, cq, q | help |
--target-bitrate arg | Bitrate (kbps) | help |
--min-q arg | Minimum (best) quantizer | help |
--max-q arg | Maximum (worst) quantizer | help |
--undershoot-pct arg | Datarate undershoot (min) target (%) | help |
--overshoot-pct arg | Datarate overshoot (max) target (%) | help |
--buf-sz arg | Client buffer size (ms) | help |
--buf-initial-sz arg | Client initial buffer size (ms) | help |
--buf-optimal-sz arg | Client optimal buffer size (ms) | help |
--bias-pct arg | CBR/VBR bias (0=CBR, 100=VBR) | help |
--minsection-pct arg | GOP min bitrate (% of target) | help |
--maxsection-pct arg | GOP max bitrate (% of target) | help |
--corpus-complexity arg | corpus vbr complexity midpoint | help |
--kf-min-dist arg | Minimum keyframe interval (frames) | help |
--kf-max-dist arg | Maximum keyframe interval (frames) | help |
--disable-kf | Disable keyframe placement | help |
--cpu-used arg | CPU Used (-16..16) | help |
--auto-alt-ref arg | Enable automatic alt reference frames. | help |
--noise-sensitivity arg | Noise sensitivity (frames to blur) | help |
--sharpness arg | Increase sharpness at the expense of lower PSNR. | help |
--static-thresh arg | Motion detection threshold | help |
--token-parts arg | Number of token partitions to use, log2 | help |
--arnr-maxframes arg | AltRef max frames (0..15) | help |
--arnr-strength arg | AltRef filter strength (0..6) | help |
--arnr-type arg | AltRef filter type (1..3) | help |
--tune arg | Material to favor psnr, ssim | help |
--cq-level arg | Constant/Constrained Quality level | help |
--max-intra-rate arg | Max I-frame bitrate (pct) | help |
--gf-cbr-boost arg | Boost for Golden Frame in CBR mode (pct) | help |
--tile-columns arg | Number of tile columns to use, log2 | help |
--tile-rows arg | Number of tile rows to use, log2 (set to 0 while threads > 1) | help |
--enable-tpl arg | Enable temporal dependency model | help |
--enable-keyframe-filtering arg | Enable key frame temporal filtering (0: off (default), 1: on) | help |
--max-inter-rate arg | Max P-frame bitrate (pct) | help |
--lossless arg | Lossless mode (0: false (default), 1: true) | help |
--frame-parallel arg | Enable frame parallel decodability features | help |
--aq-mode arg | Adaptive quantization mode (0: off (default), 1: variance 2: complexity, 3: cyclic refresh, 4: equator360) | help |
--alt-ref-aq arg | Special adaptive quantization for the alternate reference frames. | help |
--frame-boost arg | Enable frame periodic boost (0: off (default), 1: on) | help |
--tune-content arg | Tune content type default, screen, film | help |
--color-space arg | The color space of input content: unknown, bt601, bt709, smpte170, smpte240, bt2020, reserved, sRGB | help |
--min-gf-interval arg | min gf/arf frame interval (default 0, indicating in-built behavior) | help |
--max-gf-interval arg | max gf/arf frame interval (default 0, indicating in-built behavior) | help |
--target-level arg | Target level 255: off (default) 0: only keep level stats 1: adaptively set alt-ref distance and column tile limit based on picture size, and keep level stats 10: level 1.0 11: level 1.1 ... | help |
--row-mt arg | Enable row based non-deterministic multi-threading in VP9 | help |
--disable-loopfilter arg | Control Loopfilter in VP9: 0: Loopfilter on for all frames (default) 1: Loopfilter off for non reference frames 2: Loopfilter off for all frames | help |
--validate-hbd-input arg | Check that input samples are within the valid range for the chosen bit depth with high bit depth encoding (0: disabled, 1: enabled (default)) | help |
-b, --bit-depth arg | Bit depth for codec (8 for version <=1, 10 or 12 for version 2) 8, 10, 12 | help |
--input-bit-depth arg | Actual bit depth of input source | help |
--use-vizier-rc-params arg | Use vizier rc params | help |
--active-wq-factor arg | Active worst quality factor | help |
--err-per-mb-factor arg | Error per macroblock factor | help |
--sr-default-decay-limit arg | Second reference default decay limit | help |
--sr-diff-factor arg | Second reference diff factor | help |
--kf-err-per-mb-factor arg | Keyframe error per macroblock factor | help |
--kf-frame-min-boost-factor arg | Keyframe min boost | help |
--kf-frame-max-boost-first-factor arg | Max keyframe boost adjustment factor for first frame | help |
--kf-frame-max-boost-subs-factor arg | Max boost adjustment factor for subsequent KFs | help |
--kf-max-total-boost-factor arg | Keyframe max total boost factor | help |
--gf-max-total-boost-factor arg | Golden frame max total boost factor | help |
--gf-frame-max-boost-factor arg | Golden frame max per frame boost factor | help |
--zm-factor arg | Zero motion power factor | help |
--rd-mult-inter-qp-fac arg | RD multiplier adjustment for inter frames | help |
--rd-mult-arf-qp-fac arg | RD multiplier adjustment for alt-ref frames | help |
--rd-mult-key-qp-fac arg | RD multiplier adjustment for key frames | help |