--- name: "aomenc" section: "1" platform: "linux" package: "aom-tools" version: "3.12.1-1+deb13u1" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/aomenc" --- # aomenc(1) AOMedia Project AV1 Encoder ## NAME aomenc - AOMedia Project AV1 Encoder ## SYNOPSIS **aomenc** *\ -o dst\_filename src\_filename* ## OPTIONS - **--help** Show usage options and exit - **-c** \, **--cfg=**\ Config file to use - **-D**, **--debug** Debug mode (makes output deterministic) - **-o** \, **--output=**\ Output filename - **--codec=**\ Codec to use - **-p** \, **--passes=**\ Number of passes (1/2/3) - **--pass=**\ Pass to execute (1/2/3) - **--fpf=**\ First pass statistics file name - **--limit=**\ Stop encoding after n input frames - **--skip=**\ Skip the first n input frames - **--good** Use Good Quality Deadline - **--rt** Use Realtime Quality Deadline - **--allintra** Use all intra mode - **-q**, **--quiet** Do not print encode progress - **-v**, **--verbose** Show encoder parameters - **--psnr=**\ Show PSNR in status line (0: Disable PSNR status line display, 1: PSNR calculated using input bit-depth (default), 2: PSNR calculated using stream bit-depth); takes default option when arguments are not specified - **--webm** Output WebM (default when WebM IO is enabled) - **--ivf** Output IVF - **--obu** Output OBU - **--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: - **--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 - **-u** \, **--usage=**\ Usage profile number to use (0: good, 1: rt, 2: allintra) - **-t** \, **--threads=**\ Max number of threads to use - **--profile=**\ Bitstream profile number to use - **-w** \, **--width=**\ Frame width - **-h** \, **--height=**\ Frame height - **--forced\_max\_frame\_width=**\ Maximum frame width value to force - **--forced\_max\_frame\_height=**\ Maximum frame height value to force - **--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) - **--global-error-resilient=**\ Enable global error resiliency features - **-b** \, **--bit-depth=**\ Bit depth for codec 8, 10, 12 - **--input-bit-depth=**\ Bit depth of input - **--lag-in-frames=**\ Max number of frames to lag - **--large-scale-tile=**\ Large scale tile coding (0: off (default), 1: on (ivf output only)) - **--monochrome** Monochrome video (no chroma planes) - **--full-still-picture-hdr** Use full header for still picture - **--use-16bit-internal** Force use of 16-bit pipeline - **--annexb=**\ Save as Annex-B ### Rate Control Options: - **--drop-frame=**\ Temporal resampling threshold (buf %) - **--resize-mode=**\ Frame resize mode (0: off (default), 1: fixed, 2: random, 3: dynamic) - **--resize-denominator=**\ Frame resize denominator - **--resize-kf-denominator=**\ Frame resize keyframe denominator - **--superres-mode=**\ Frame super-resolution mode (0: disabled (default), 1: fixed, 2: random, 3: qthresh, 4: auto) - **--superres-denominator=**\ Frame super-resolution denominator - **--superres-kf-denominator=**\ Frame super-resolution keyframe denominator - **--superres-qthresh=**\ Frame super-resolution qindex threshold - **--superres-kf-qthresh=**\ Frame super-resolution keyframe qindex threshold **--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) - **--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: - **--enable-fwd-kf=**\ Enable forward reference keyframes - **--kf-min-dist=**\ Minimum keyframe interval (frames) - **--kf-max-dist=**\ Maximum keyframe interval (frames) - **--disable-kf** Disable keyframe placement - **--sframe-dist=**\ S-Frame interval (frames) - **--sframe-mode=**\ S-Frame insertion mode (1..2) ### AV1 Specific Options: - **--cpu-used=**\ Speed setting (0..6 in good mode, 5..10 in realtime mode, 0..9 in all intra mode) - **--auto-alt-ref=**\ Enable automatic alt reference frames - **--sharpness=**\ Bias towards block sharpness in rate-distortion optimization of transform coefficients (0..7), default is 0 - **--static-thresh=**\ Motion detection threshold - **--row-mt=**\ Enable row based multi-threading (0: off, 1: on (default)) - **--fp-mt=**\ Enable frame parallel multi-threading (0: off (default), 1: on) - **--tile-columns=**\ Number of tile columns to use, log2 - **--tile-rows=**\ Number of tile rows to use, log2 - **--enable-tpl-model=**\ RDO based on frame temporal dependency (0: off, 1: backward source based); required for deltaq mode - **--enable-keyframe-filtering=**\ Apply temporal filtering on key frame (0: no filter, 1: filter without overlay (default), 2: filter with overlay - experimental, may break random access in players) - **--arnr-maxframes=**\ AltRef max frames (0..15) - **--arnr-strength=**\ AltRef filter strength (0..6) - **--tune=**\ Distortion metric tuned with - psnr, ssim, vmaf\_with\_preprocessing, vmaf\_without\_preprocessing, vmaf, vmaf\_neg, butteraugli, vmaf\_saliency\_map - **--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) - **--enable-cdef=**\ Enable the constrained directional enhancement filter (0: false, 1: true (default), 2: disable for non-reference frames) - **--enable-restoration=**\ Enable the loop restoration filter (0: false (default in realtime mode), 1: true (default in non-realtime mode)) - **--enable-rect-partitions=**\ Enable rectangular partitions (0: false, 1: true (default)) - **--enable-ab-partitions=**\ Enable ab partitions (0: false, 1: true (default)) - **--enable-1to4-partitions=**\ Enable 1:4 and 4:1 partitions (0: false, 1: true (default)) - **--min-partition-size=**\ Set min partition size (4:4x4, 8:8x8, 16:16x16, 32:32x32, 64:64x64, 128:128x128); with 4k+ resolutions or higher speed settings, min partition size will have a minimum of 8 - **--max-partition-size=**\ Set max partition size (4:4x4, 8:8x8, 16:16x16, 32:32x32, 64:64x64, 128:128x128) - **--enable-dual-filter=**\ Enable dual filter (0: false, 1: true (default)) - **--enable-chroma-deltaq=**\ Enable chroma delta quant (0: false (default), 1: true) - **--enable-intra-edge-filter=**\ Enable intra edge filtering (0: false, 1: true (default)) - **--enable-order-hint=**\ Enable order hint (0: false, 1: true (default)) - **--enable-tx64=**\ Enable 64-pt transform (0: false, 1: true (default)) - **--enable-flip-idtx=**\ Enable extended transform type (0: false, 1: true (default)) including FLIPADST\_DCT, DCT\_FLIPADST, FLIPADST\_FLIPADST, ADST\_FLIPADST, FLIPADST\_ADST, IDTX, V\_DCT, H\_DCT, V\_ADST, H\_ADST, V\_FLIPADST, H\_FLIPADST - **--enable-rect-tx=**\ Enable rectangular transform (0: false, 1: true (default)) - **--enable-dist-wtd-comp=**\ Enable distance-weighted compound (0: false, 1: true (default)) - **--enable-masked-comp=**\ Enable masked (wedge/diff-wtd) compound (0: false, 1: true (default)) - **--enable-onesided-comp=**\ Enable one sided compound (0: false, 1: true (default)) - **--enable-interintra-comp=**\ Enable interintra compound (0: false, 1: true (default)) - **--enable-smooth-interintra=**\ Enable smooth interintra mode (0: false, 1: true (default)) - **--enable-diff-wtd-comp=**\ Enable difference-weighted compound (0: false, 1: true (default)) - **--enable-interinter-wedge=**\ Enable interinter wedge compound (0: false, 1: true (default)) - **--enable-interintra-wedge=**\ Enable interintra wedge compound (0: false, 1: true (default)) - **--enable-global-motion=**\ Enable global motion (0: false, 1: true (default)) - **--enable-warped-motion=**\ Enable local warped motion (0: false, 1: true (default)) - **--enable-filter-intra=**\ Enable filter intra prediction mode (0: false, 1: true (default)) **--enable-smooth-intra=**\ Enable smooth intra prediction modes (0: false, 1: true (default)) **--enable-paeth-intra=**\ Enable Paeth intra prediction mode (0: false, 1: true (default)) **--enable-cfl-intra=**\ Enable chroma from luma intra prediction mode (0: false, 1: true (default)) **--enable-diagonal-intra=**\ - Enable diagonal (D45 to D203) intra prediction modes, which are a subset of directional modes; has no effect if enable-directional-intra is 0 (0: false, 1: true (default)) - **--force-video-mode=**\ Force video mode even for a single frame (0: false (default), 1: true) - **--enable-obmc=**\ Enable OBMC (0: false, 1: true (default)) - **--enable-overlay=**\ Enable coding overlay frames (0: false, 1: true (default)) - **--enable-palette=**\ Enable palette prediction mode (0: false, 1: true (default)) - **--enable-intrabc=**\ Enable intra block copy prediction mode (0: false, 1: true (default)) - **--enable-angle-delta=**\ Enable intra angle delta (0: false, 1: true (default)) - **--disable-trellis-quant=**\ Disable trellis optimization of quantized coefficients (0: false 1: true 2: true for rd search 3: true for estimate yrd search (default)) - **--enable-qm=**\ Enable quantisation matrices (0: false (default), 1: true) - **--qm-min=**\ Min quant matrix flatness (0..15), default is 8 - **--qm-max=**\ Max quant matrix flatness (0..15), default is 15 - **--reduced-tx-type-set=**\ Use reduced set of transform types **--use-intra-dct-only=**\ Use DCT only for INTRA modes **--use-inter-dct-only=**\ Use DCT only for INTER modes **--use-intra-default-tx-only=**\ - Use Default-transform only for INTRA modes - **--quant-b-adapt=**\ Use adaptive quantize\_b - **--coeff-cost-upd-freq=**\ Update freq for coeff costs. 0: SB, 1: SB Row per Tile, 2: Tile, 3: Off **--mode-cost-upd-freq=**\ Update freq for mode costs. 0: SB, 1: SB Row per Tile, 2: Tile, 3: Off **--mv-cost-upd-freq=**\ Update freq for mv costs. 0: SB, 1: SB Row per Tile, 2: Tile, 3: Off **--frame-parallel=**\ Enable frame parallel decodability features (0: false (default), 1: true) **--error-resilient=**\ Enable error resilient features (0: false (default), 1: true) **--aq-mode=**\ Adaptive quantization mode (0: off (default), 1: variance 2: complexity, 3: cyclic refresh) **--deltaq-mode=**\ Delta qindex mode (0: off, 1: deltaq objective (default), 2: deltaq placeholder, 3: key frame visual quality, 4: user rating based visual quality optimization); requires **--enable-tpl-model**=*1* **--deltaq-strength=**\ Deltaq strength for **--deltaq-mode**=*4* (%) **--delta-lf-mode=**\ Enable delta-lf-mode (0: off (default), 1: on) **--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, film - **--cdf-update-mode=**\ CDF update mode for entropy coding (0: no CDF update, 1: update CDF on all frames (default), 2: selectively update CDF on some frames) - **--color-primaries=**\ Color primaries (CICP) of input content: - bt709, unspecified, bt601, bt470m, bt470bg, smpte240, film, bt2020, xyz, smpte431, smpte432, ebu3213 - **--transfer-characteristics=**\ Transfer characteristics (CICP) of input content: - unspecified, bt709, bt470m, bt470bg, bt601, smpte240, lin, log100, log100sq10, iec61966, bt1361, srgb, bt2020-10bit, bt2020-12bit, smpte2084, hlg, smpte428 - **--matrix-coefficients=**\ Matrix coefficients (CICP) of input content: identity, bt709, unspecified, fcc73, bt470bg, bt601, smpte240, ycgco, bt2020ncl, bt2020cl, smpte2085, chromncl, chromcl, ictcp - **--chroma-sample-position=**\ The chroma sample position when chroma 4:2:0 is signaled: - unknown, vertical, colocated - **--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) - **--gf-min-pyr-height=**\ Min height for GF group pyramid structure (0 (default) to 5) - **--gf-max-pyr-height=**\ Maximum height for GF group pyramid structure (0 to 5 (default)) - **--sb-size=**\ Superblock size to use - dynamic, 64, 128 - **--num-tile-groups=**\ Maximum number of tile groups, default is 1 - **--mtu-size=**\ MTU size for a tile group, default is 0 (no MTU targeting), overrides maximum number of tile groups - **--timing-info=**\ Signal timing info in the bitstream (model only works for no hidden frames, no super-res yet): - unspecified, constant, model - **--film-grain-test=**\ Film grain test vectors (0: none (default), 1: test-1 2: test-2, ... 16: test-16) - **--film-grain-table=**\ Path to file containing film grain parameters - **--denoise-noise-level=**\ Amount of noise (from 0 = don't denoise, to 50) **--denoise-block-size=**\ Denoise block size (default = 32) **--enable-dnl-denoising=**\ - Apply denoising to the frame being encoded when denoise-noise-level is enabled (0: false, 1: true (default)) - **--max-reference-frames=**\ Maximum number of reference frames allowed per frame (3 to 7 (default)) - **--reduced-reference-set=**\ Use reduced set of single and compound references (0: off (default), 1: on) - **--enable-ref-frame-mvs=**\ Enable temporal mv prediction (default is 1) - **--target-seq-level-idx=**\ Target sequence level index. Possible values are in the form of "ABxy". AB: Operating point (OP) index, xy: Target level index for the OP. E.g. "0" means target level index 0 (2.0) for the 0th OP, "1019" means target level index 19 (6.3) for the 10th OP. - **--set-tier-mask=**\ Set bit mask to specify which tier each of the 32 possible operating points conforms to. Bit value 0 (default): Main Tier, 1: High Tier. - **--min-cr=**\ Set minimum compression ratio. Take integer values. Default is 0. If non-zero, encoder will try to keep the compression ratio of each frame to be higher than the given value divided by 100. - **--vbr-corpus-complexity-lap=**\ Set average corpus complexity per mb for single pass VBR using lap. (0..10000), default is 0 - **--input-chroma-subsampling-x=**\ Chroma subsampling x value - **--input-chroma-subsampling-y=**\ Chroma subsampling y value - **--dv-cost-upd-freq=**\ Update freq for dv costs. 0: SB, 1: SB Row per Tile, 2: Tile, 3: Off - **--partition-info-path=**\ Partition information read and write path **--enable-rate-guide-deltaq=**\ - Enable rate guide deltaq (1), by default off (0). It requires **--deltaq-mode**=*3*. If turned on, it requires an input file specified by **--rate-distribution-info**. - **--rate-distribution-info=**\ Rate distribution information input.It requires **--enable-rate-guide-deltaq**=*1*. - **--enable-directional-intra=**\ Enable directional intra prediction modes (0: false, 1: true (default)) - **--enable-tx-size-search=**\ Enable transform size search to find the best size for each block. If false, transforms always have the largest possible size (0: false, 1: true (default)). Ignored in non rd pick mode in real-time coding. - **--loopfilter-control=**\ Control loop filtering (0: Loopfilter disabled for all frames, 1: Enable loopfilter for all frames (default), 2: Disable loopfilter for non-reference frames, 3: Disable loopfilter for frames with low motion) - **--auto-intra-tools-off=**\ Automatically turn off several intra coding tools for allintra mode; only in effect if **--deltaq-mode**=*3* - **-p** \, **--passes=**\ Number of passes (1/2/3) - **--two-pass-output=**\ The output file for the first two passes for three-pass encoding - **-spf** \, **--second-pass-log=**\ Log file from second pass - **--fwd-kf-dist=**\ Set distance between forward keyframes. A value of **-1** (default) means no repetitive forward keyframes. - **--strict-level-conformance=**\ When set to 1, exit the encoder when it fails to encode to a given target level - **--sb-qp-sweep=**\ When set to 1, enable the superblock level qp sweep for a given lambda to minimize the rdcost. - **--dist-metric=**\ Distortion metric to use for in-block optimization - psnr, qm-psnr - **--kf-max-pyr-height=**\ Maximum height of pyramid structure used for the GOP starting with a key frame (**-1** to 5). When set to **-1** (default), it does not have any effect. The actual maximum pyramid height will be the minimum of this value and the value of gf\_max\_pyr\_height. ### Stream timebase (--timebase): - The desired precision of timestamps in the output, expressed in fractional seconds. Default is 1/1000. Included encoders: - av1 \- AOMedia Project AV1 Encoder v3.7.0 (default) - Use **--codec** to switch to a non-default encoder.