MAN page from Rawhide libav-avconv-12.1-7.245.x86_64.rpm

AVPROBE

Section: (1)
Updated: 2018-09-25
Index

NAME

avprobe - avprobe media prober

SYNOPSIS

avprobe [options] [input_file]

DESCRIPTION

avprobe gathers information from multimedia streams and prints it inhuman- and machine-readable fashion.

For example it can be used to check the format of the container usedby a multimedia stream and the format and type of each media streamcontained in it.

If a filename is specified in input, avprobe will try to open andprobe the file content. If the file cannot be opened or recognized asa multimedia file, a positive exit code is returned.

avprobe may be employed both as a standalone application or incombination with a textual filter, which may perform moresophisticated processing, e.g. statistical processing or plotting.

Options are used to list some of the formats supported by avprobe orfor specifying which information to display, and for setting howavprobe will show it.

avprobe output is designed to be easily parsable by any INI or JSONparsers.

OPTIONS

All the numerical options, if not specified otherwise, accept in inputa string representing a number, which may contain one of theSI unit prefixes, for example 'K', 'M', 'G'.If 'i' is appended after the prefix, binary prefixes are used,which are based on powers of 1024 instead of powers of 1000.The 'B' postfix multiplies the value by 8, and can beappended after a unit prefix or used alone. This allows using forexample 'KB', 'MiB', 'G' and 'B' as number postfix.

Options which do not take arguments are boolean options, and set thecorresponding value to true. They can be set to false by prefixingwith ``no'' the option name, for example using ``-nofoo'' in thecommand line will set to false the boolean option with name ``foo''.

Stream specifiers

Some options are applied per-stream, e.g. bitrate or codec. Stream specifiersare used to precisely specify which stream(s) does a given option belong to.

A stream specifier is a string generally appended to the option name andseparated from it by a colon. E.g. "-codec:a:1 ac3" option contains"a:1" stream specifier, which matches the second audio stream. Therefore itwould select the ac3 codec for the second audio stream.

A stream specifier can match several stream, the option is then applied to allof them. E.g. the stream specifier in "-b:a 128k" matches all audiostreams.

An empty stream specifier matches all streams, for example "-codec copy"or "-codec: copy" would copy all the streams without reencoding.

Possible forms of stream specifiers are:

stream_index: Matches the stream with this index. E.g. "-threads:1 4" would set thethread count for the second stream to 4.
stream_type[:stream_index]: stream_type is one of: 'v' for video, 'a' for audio, 's' for subtitle,'d' for data and 't' for attachments. If stream_index is given, thenmatches stream number stream_index of this type. Otherwise matches allstreams of this type.
p:program_id[:stream_index]: If stream_index is given, then matches stream number stream_index inprogram with id program_id. Otherwise matches all streams in this program.
i:stream_id: Match the stream by stream id (e.g. PID in MPEG-TS container).
m:key[:value]: Matches streams with the metadata tag key having the specified value. Ifvalue is not given, matches streams that contain the given tag with anyvalue.
u: Matches streams with usable configuration, the codec must be defined and theessential information such as video dimension or audio sample rate must be present.
Note that in avconv, matching by metadata will only work properly forinput files.

Generic options

These options are shared amongst the av* tools.

-L

Show license.

-h, -?, -help, --help [arg]

Show help. An optional parameter may be specified to print help about a specificitem.

Possible values of arg are:

decoder=decoder_name: Print detailed information about the decoder named decoder_name. Use the-decoders option to get a list of all decoders.
encoder=encoder_name: Print detailed information about the encoder named encoder_name. Use the-encoders option to get a list of all encoders.
demuxer=demuxer_name: Print detailed information about the demuxer named demuxer_name. Use the-formats option to get a list of all demuxers and muxers.
muxer=muxer_name: Print detailed information about the muxer named muxer_name. Use the-formats option to get a list of all muxers and demuxers.
filter=filter_name: Print detailed information about the filter name filter_name. Use the-filters option to get a list of all filters.

-version

Show version.

-formats

Show available formats.

The fields preceding the format names have the following meanings:

D: Decoding available
E: Encoding available

-codecs

Show all codecs known to libavcodec.

Note that the term 'codec' is used throughout this documentation as a shortcutfor what is more correctly called a media bitstream format.

-decoders

Show available decoders.

-encoders

Show all available encoders.

-bsfs

Show available bitstream filters.

-protocols

Show available protocols.

-filters

Show available libavfilter filters.

-pix_fmts

Show available pixel formats.

-sample_fmts

Show available sample formats.

-loglevel loglevel | -v loglevel

Set the logging level used by the library.loglevel is a number or a string containing one of the following values:

quiet
panic
fatal
error
warning
info
verbose
debug
trace

: By default the program logs to stderr, if coloring is supported by theterminal, colors are used to mark errors and warnings. Log coloringcan be disabled setting the environment variableAV_LOG_FORCE_NOCOLOR or NO_COLOR, or can be forced settingthe environment variable AV_LOG_FORCE_COLOR.The use of the environment variable NO_COLOR is deprecated andwill be dropped in a following Libav version.

-cpuflags mask (global)

Set a mask that's applied to autodetected CPU flags. This option is intendedfor testing. Do not use it unless you know what you're doing.

AVOptions

These options are provided directly by the libavformat, libavdevice andlibavcodec libraries. To see the list of available AVOptions, use the-help option. They are separated into two categories:

generic: These options can be set for any container, codec or device. Generic optionsare listed under AVFormatContext options for containers/devices and underAVCodecContext options for codecs.
private: These options are specific to the given container, device or codec. Privateoptions are listed under their corresponding containers/devices/codecs.

For example to write an ID3v2.3 header instead of a default ID3v2.4 toan MP3 file, use the id3v2_version private option of the MP3muxer:

        avconv -i input.flac -id3v2_version 3 out.mp3

All codec AVOptions are obviously per-stream, so the chapter on streamspecifiers applies to them

Note -nooption syntax cannot be used for boolean AVOptions,use -option 0/-option 1.

Note2 old undocumented way of specifying per-stream AVOptions by prependingv/a/s to the options name is now obsolete and will be removed soon.

Codec AVOptions

-b[:stream_specifier] integer (output,audio,video)

set bitrate (in bits/s)

-bt[:stream_specifier] integer (output,video)

Set video bitrate tolerance (in bits/s). In 1-pass mode, bitrate tolerance specifies how far ratecontrol is willing to deviate from the target average bitrate value. This is not related to minimum/maximum bitrate. Lowering tolerance too much has an adverse effect on quality.

-flags[:stream_specifier] flags (input/output,audio,video)

Possible values:

unaligned: allow decoders to produce unaligned output
mv4: use four motion vectors per macroblock (MPEG-4)
qpel: use 1/4-pel motion compensation
loop: use loop filter
qscale: use fixed qscale
gmc: use gmc
mv0: always try a mb with mv=<0,0>
input_preserved
pass1: use internal 2-pass ratecontrol in first pass mode
pass2: use internal 2-pass ratecontrol in second pass mode
gray: only decode/encode grayscale
emu_edge: do not draw edges
psnr: error[?] variables will be set during encoding
truncated
naq: normalize adaptive quantization
ildct: use interlaced DCT
low_delay: force low delay
global_header: place global headers in extradata instead of every keyframe
bitexact: use only bitexact functions (except (I)DCT)
aic: H.263 advanced intra coding / MPEG-4 AC prediction
ilme: interlaced motion estimation
cgop: closed GOP
output_corrupt: Output even potentially corrupted frames

-me_method[:stream_specifier] integer (output,video)

set motion estimation method

Possible values:

zero: zero motion estimation (fastest)
full: full motion estimation (slowest)
epzs: EPZS motion estimation (default)
esa: esa motion estimation (alias for full)
tesa: tesa motion estimation
dia: diamond motion estimation (alias for EPZS)
log: log motion estimation
phods: phods motion estimation
x1: X1 motion estimation
hex: hex motion estimation
umh: umh motion estimation

-g[:stream_specifier] integer (output,video)

set the group of picture (GOP) size

-ar[:stream_specifier] integer (input/output,audio)

set audio sampling rate (in Hz)

-ac[:stream_specifier] integer (input/output,audio)

set number of audio channels

-cutoff[:stream_specifier] integer (output,audio)

set cutoff bandwidth

-frame_size[:stream_specifier] integer (output,audio)

-qcomp[:stream_specifier] float (output,video)

video quantizer scale compression (VBR). Constant of ratecontrol equation. Recommended range for default rc_eq: 0.0-1.0

-qblur[:stream_specifier] float (output,video)

video quantizer scale blur (VBR)

-qmin[:stream_specifier] integer (output,video)

minimum video quantizer scale (VBR)

-qmax[:stream_specifier] integer (output,video)

maximum video quantizer scale (VBR)

-qdiff[:stream_specifier] integer (output,video)

maximum difference between the quantizer scales (VBR)

-bf[:stream_specifier] integer (output,video)

use 'frames' B-frames

-b_qfactor[:stream_specifier] float (output,video)

QP factor between P- and B-frames

-rc_strategy[:stream_specifier] integer (output,video)

ratecontrol method

-b_strategy[:stream_specifier] integer (output,video)

strategy to choose between I/P/B-frames

-ps[:stream_specifier] integer (output,video)

RTP payload size in bytes

-bug[:stream_specifier] flags (input,video)

work around not autodetected encoder bugs

Possible values:

autodetect
old_msmpeg4: some old lavc-generated MSMPEG4v3 files (no autodetection)
xvid_ilace: Xvid interlacing bug (autodetected if FOURCC == XVIX)
ump4: (autodetected if FOURCC == UMP4)
no_padding: padding bug (autodetected)
amv
ac_vlc: illegal VLC bug (autodetected per FOURCC)
qpel_chroma
std_qpel: old standard qpel (autodetected per FOURCC/version)
qpel_chroma2
direct_blocksize: direct-qpel-blocksize bug (autodetected per FOURCC/version)
edge: edge padding bug (autodetected per FOURCC/version)
hpel_chroma
dc_clip
ms: work around various bugs in Microsoft's broken decoders
trunc: truncated frames

-strict[:stream_specifier] integer (input/output,audio,video)

how strictly to follow the standards

Possible values:

very: strictly conform to a older more strict version of the spec or reference software
strict: strictly conform to all the things in the spec no matter what the consequences
normal
unofficial: allow unofficial extensions
experimental: allow non-standardized experimental things

-b_qoffset[:stream_specifier] float (output,video)

QP offset between P- and B-frames

-err_detect[:stream_specifier] flags (input,audio,video)

set error detection flags

Possible values:

crccheck: verify embedded CRCs
bitstream: detect bitstream specification deviations
buffer: detect improper bitstream length
explode: abort decoding on minor error detection

-mpeg_quant[:stream_specifier] integer (output,video)

use MPEG quantizers instead of H.263

-qsquish[:stream_specifier] float (output,video)

deprecated, use encoder private options instead

-rc_qmod_amp[:stream_specifier] float (output,video)

deprecated, use encoder private options instead

-rc_qmod_freq[:stream_specifier] integer (output,video)

deprecated, use encoder private options instead

-rc_eq[:stream_specifier] string (output,video)

deprecated, use encoder private options instead

-maxrate[:stream_specifier] integer (output,audio,video)

Set maximum bitrate tolerance (in bits/s). Requires bufsize to be set.

-minrate[:stream_specifier] integer (output,audio,video)

Set minimum bitrate tolerance (in bits/s). Most useful in setting up a CBR encode. It is of little use otherwise.

-bufsize[:stream_specifier] integer (output,audio,video)

set ratecontrol buffer size (in bits)

-rc_buf_aggressivity[:stream_specifier] float (output,video)

deprecated, use encoder private options instead

-i_qfactor[:stream_specifier] float (output,video)

QP factor between P- and I-frames

-i_qoffset[:stream_specifier] float (output,video)

QP offset between P- and I-frames

-rc_init_cplx[:stream_specifier] float (output,video)

deprecated, use encoder private options instead

-dct[:stream_specifier] integer (output,video)

DCT algorithm

Possible values:

auto: autoselect a good one (default)
fastint: fast integer
int: accurate integer
mmx
altivec
faan: floating point AAN DCT

-lumi_mask[:stream_specifier] float (output,video)

compresses bright areas stronger than medium ones

-tcplx_mask[:stream_specifier] float (output,video)

temporal complexity masking

-scplx_mask[:stream_specifier] float (output,video)

spatial complexity masking

-p_mask[:stream_specifier] float (output,video)

inter masking

-dark_mask[:stream_specifier] float (output,video)

compresses dark areas stronger than medium ones

-idct[:stream_specifier] integer (input/output,video)

select IDCT implementation

Possible values:

auto
int
simple
simplemmx
arm
altivec
sh4
simplearm
simplearmv5te
simplearmv6
simpleneon
simplealpha
ipp
xvid
xvidmmx
faani: floating point AAN IDCT

-ec[:stream_specifier] flags (input,video)

set error concealment strategy

Possible values:

guess_mvs: iterative motion vector (MV) search (slow)
deblock: use strong deblock filter for damaged MBs

-pred[:stream_specifier] integer (output,video)

prediction method

Possible values:

left
plane
median

-aspect[:stream_specifier] rational number (output,video)

sample aspect ratio

-debug[:stream_specifier] flags (input/output,audio,video,subtitles)

print specific debug info

Possible values:

pict: picture info
rc: rate control
bitstream
mb_type: macroblock (MB) type
qp: per-block quantization parameter (QP)
mv: motion vector
dct_coeff
skip
startcode
pts
er: error recognition
mmco: memory management control operations (H.264)
bugs
vis_qp: visualize quantization parameter (QP), lower QP are tinted greener
vis_mb_type: visualize block types
buffers: picture buffer allocations
thread_ops: threading operations

-vismv[:stream_specifier] integer (input,video)

visualize motion vectors (MVs)

Possible values:

pf: forward predicted MVs of P-frames
bf: forward predicted MVs of B-frames
bb: backward predicted MVs of B-frames

-cmp[:stream_specifier] integer (output,video)

full-pel ME compare function

Possible values:

sad: sum of absolute differences, fast (default)
sse: sum of squared errors
satd: sum of absolute Hadamard transformed differences
dct: sum of absolute DCT transformed differences
psnr: sum of squared quantization errors (avoid, low quality)
bit: number of bits needed for the block
rd: rate distortion optimal, slow
zero: 0
vsad: sum of absolute vertical differences
vsse: sum of squared vertical differences
nsse: noise preserving sum of squared differences
dctmax
chroma

-subcmp[:stream_specifier] integer (output,video)

sub-pel ME compare function

Possible values:

sad: sum of absolute differences, fast (default)
sse: sum of squared errors
satd: sum of absolute Hadamard transformed differences
dct: sum of absolute DCT transformed differences
psnr: sum of squared quantization errors (avoid, low quality)
bit: number of bits needed for the block
rd: rate distortion optimal, slow
zero: 0
vsad: sum of absolute vertical differences
vsse: sum of squared vertical differences
nsse: noise preserving sum of squared differences
dctmax
chroma

-mbcmp[:stream_specifier] integer (output,video)

macroblock compare function

Possible values:

sad: sum of absolute differences, fast (default)
sse: sum of squared errors
satd: sum of absolute Hadamard transformed differences
dct: sum of absolute DCT transformed differences
psnr: sum of squared quantization errors (avoid, low quality)
bit: number of bits needed for the block
rd: rate distortion optimal, slow
zero: 0
vsad: sum of absolute vertical differences
vsse: sum of squared vertical differences
nsse: noise preserving sum of squared differences
dctmax
chroma

-ildctcmp[:stream_specifier] integer (output,video)

interlaced DCT compare function

Possible values:

sad: sum of absolute differences, fast (default)
sse: sum of squared errors
satd: sum of absolute Hadamard transformed differences
dct: sum of absolute DCT transformed differences
psnr: sum of squared quantization errors (avoid, low quality)
bit: number of bits needed for the block
rd: rate distortion optimal, slow
zero: 0
vsad: sum of absolute vertical differences
vsse: sum of squared vertical differences
nsse: noise preserving sum of squared differences
dctmax
chroma

-dia_size[:stream_specifier] integer (output,video)

diamond type & size for motion estimation

-last_pred[:stream_specifier] integer (output,video)

amount of motion predictors from the previous frame

-preme[:stream_specifier] integer (output,video)

pre motion estimation

-precmp[:stream_specifier] integer (output,video)

pre motion estimation compare function

Possible values:

sad: sum of absolute differences, fast (default)
sse: sum of squared errors
satd: sum of absolute Hadamard transformed differences
dct: sum of absolute DCT transformed differences
psnr: sum of squared quantization errors (avoid, low quality)
bit: number of bits needed for the block
rd: rate distortion optimal, slow
zero: 0
vsad: sum of absolute vertical differences
vsse: sum of squared vertical differences
nsse: noise preserving sum of squared differences
dctmax
chroma

-pre_dia_size[:stream_specifier] integer (output,video)

diamond type & size for motion estimation pre-pass

-subq[:stream_specifier] integer (output,video)

sub-pel motion estimation quality

-me_range[:stream_specifier] integer (output,video)

limit motion vectors range (1023 for DivX player)

-ibias[:stream_specifier] integer (output,video)

intra quant bias

-pbias[:stream_specifier] integer (output,video)

inter quant bias

-global_quality[:stream_specifier] integer (output,audio,video)

-coder[:stream_specifier] integer (output,video)

Possible values:

vlc: variable length coder / Huffman coder
ac: arithmetic coder
raw: raw (no encoding)
rle: run-length coder
deflate: deflate-based coder

-context[:stream_specifier] integer (output,video)

context model

-mbd[:stream_specifier] integer (output,video)

macroblock decision algorithm (high quality mode)

Possible values:

simple: use mbcmp (default)
bits: use fewest bits
rd: use best rate distortion

-sc_threshold[:stream_specifier] integer (output,video)

scene change threshold

-lmin[:stream_specifier] integer (output,video)

deprecated, use encoder private options instead

-lmax[:stream_specifier] integer (output,video)

deprecated, use encoder private options instead

-nr[:stream_specifier] integer (output,video)

noise reduction

-rc_init_occupancy[:stream_specifier] integer (output,video)

number of bits which should be loaded into the rc buffer before decoding starts

-flags2[:stream_specifier] flags (input/output,audio,video)

Possible values:

fast: allow non-spec-compliant speedup tricks
noout: skip bitstream encoding
ignorecrop: ignore cropping information from sps
local_header: place global headers at every keyframe instead of in extradata

-error[:stream_specifier] integer (output,video)

-threads[:stream_specifier] integer (input/output,video)

Possible values:

auto: autodetect a suitable number of threads to use

-me_threshold[:stream_specifier] integer (output,video)

motion estimation threshold

-mb_threshold[:stream_specifier] integer (output,video)

macroblock threshold

-dc[:stream_specifier] integer (output,video)

intra_dc_precision

-nssew[:stream_specifier] integer (output,video)

nsse weight

-skip_top[:stream_specifier] integer (input,video)

number of macroblock rows at the top which are skipped

-skip_bottom[:stream_specifier] integer (input,video)

number of macroblock rows at the bottom which are skipped

-profile[:stream_specifier] integer (output,audio,video)

Possible values:

unknown
aac_main
aac_low
aac_ssr
aac_ltp
aac_he
aac_he_v2
aac_ld
aac_eld
mpeg2_aac_low
mpeg2_aac_he
dts
dts_es
dts_96_24
dts_hd_hra
dts_hd_ma

-level[:stream_specifier] integer (output,audio,video)

Possible values:

unknown

-skip_threshold[:stream_specifier] integer (output,video)

frame skip threshold

-skip_factor[:stream_specifier] integer (output,video)

frame skip factor

-skip_exp[:stream_specifier] integer (output,video)

frame skip exponent

-skipcmp[:stream_specifier] integer (output,video)

frame skip compare function

Possible values:

sad: sum of absolute differences, fast (default)
sse: sum of squared errors
satd: sum of absolute Hadamard transformed differences
dct: sum of absolute DCT transformed differences
psnr: sum of squared quantization errors (avoid, low quality)
bit: number of bits needed for the block
rd: rate distortion optimal, slow
zero: 0
vsad: sum of absolute vertical differences
vsse: sum of squared vertical differences
nsse: noise preserving sum of squared differences
dctmax
chroma

-border_mask[:stream_specifier] float (output,video)

deprecated, use encoder private options instead

-mblmin[:stream_specifier] integer (output,video)

minimum macroblock Lagrange factor (VBR)

-mblmax[:stream_specifier] integer (output,video)

maximum macroblock Lagrange factor (VBR)

-mepc[:stream_specifier] integer (output,video)

motion estimation bitrate penalty compensation (1.0 = 256)

-skip_loop_filter[:stream_specifier] integer (input,video)

Possible values:

none
default
noref
bidir
nokey
all

-skip_idct[:stream_specifier] integer (input,video)

Possible values:

none
default
noref
bidir
nokey
all

-skip_frame[:stream_specifier] integer (input,video)

Possible values:

none
default
noref
bidir
nokey
all

-bidir_refine[:stream_specifier] integer (output,video)

refine the two motion vectors used in bidirectional macroblocks

-brd_scale[:stream_specifier] integer (output,video)

downscale frames for dynamic B-frame decision

-keyint_min[:stream_specifier] integer (output,video)

minimum interval between IDR-frames (x264)

-refs[:stream_specifier] integer (output,video)

reference frames to consider for motion compensation

-chromaoffset[:stream_specifier] integer (output,video)

chroma QP offset from luma

-trellis[:stream_specifier] integer (output,audio,video)

rate-distortion optimal quantization

-sc_factor[:stream_specifier] integer (output,video)

multiplied by qscale for each frame and added to scene_change_score

-mv0_threshold[:stream_specifier] integer (output,video)

-b_sensitivity[:stream_specifier] integer (output,video)

adjust sensitivity of b_frame_strategy 1

-compression_level[:stream_specifier] integer (output,audio,video)

-min_prediction_order[:stream_specifier] integer (output,audio)

-max_prediction_order[:stream_specifier] integer (output,audio)

-timecode_frame_start[:stream_specifier] integer (output,video)

GOP timecode frame start number, in non-drop-frame format

-channel_layout[:stream_specifier] integer (input/output,audio)

Possible values:

-request_channel_layout[:stream_specifier] integer (input,audio)

Possible values:

-rc_max_vbv_use[:stream_specifier] float (output,video)

-rc_min_vbv_use[:stream_specifier] float (output,video)

-ticks_per_frame[:stream_specifier] integer (input/output,audio,video)

-color_primaries[:stream_specifier] integer (input/output,video)

color primaries

Possible values:

bt709: BT.709
unknown: Unspecified
bt470m: BT.470 M
bt470bg: BT.470 BG
smpte170m: SMPTE 170 M
smpte240m: SMPTE 240 M
film: Film
bt2020: BT.2020
smpte428: SMPTE 428-1
smpte431: SMPTE 431-2
smpte432: SMPTE 422-1
unspecified: Unspecified
smptest428_1: SMPTE 428-1

-color_trc[:stream_specifier] integer (input/output,video)

color transfer characteristics

Possible values:

bt709: BT.709
unknown: Unspecified
gamma22: BT.470 M
gamma28: BT.470 BG
smpte170m: SMPTE 170 M
smpte240m: SMPTE 240 M
linear: Linear
log100: Log
log316: Log square root
iec61966-2-4: IEC 61966-2-4
bt1361e: BT.1361
iec61966-2-1: IEC 61966-2-1
bt2020-10: BT.2020 - 10 bit
bt2020-12: BT.2020 - 12 bit
smpte2084: SMPTE 2084
smpte428: SMPTE 428-1
arib-std-b67: ARIB STD-B67
unspecified: Unspecified
log: Log
log_sqrt: Log square root
iec61966_2_4: IEC 61966-2-4
bt1361: BT.1361
iec61966_2_1: IEC 61966-2-1
bt2020_10bit: BT.2020 - 10 bit
bt2020_12bit: BT.2020 - 12 bit
smptest2084: SMPTE 2084
smptest428_1: SMPTE 428-1

-colorspace[:stream_specifier] integer (input/output,video)

color space

Possible values:

rgb: RGB
bt709: BT.709
unknown: Unspecified
fcc: FCC
bt470bg: BT.470 BG
smpte170m: SMPTE 170 M
smpte240m: SMPTE 240 M
ycocg: YCOCG
bt2020nc: BT.2020 NCL
bt2020c: BT.2020 CL
smpte2085: SMPTE 2085
unspecified: Unspecified
bt2020_ncl: BT.2020 NCL
bt2020_cl: BT.2020 CL

-color_range[:stream_specifier] integer (input/output,video)

color range

Possible values:

unknown: Unspecified
tv: MPEG (219*2^(n-8))
pc: JPEG (2^n-1)
unspecified: Unspecified
mpeg: MPEG (219*2^(n-8))
jpeg: JPEG (2^n-1)

-chroma_sample_location[:stream_specifier] integer (input/output,video)

chroma sample location

Possible values:

unknown: Unspecified
left: Left
center: Center
topleft: Top-left
top: Top
bottomleft: Bottom-left
bottom: Bottom
unspecified: Unspecified

-slices[:stream_specifier] integer (output,video)

number of slices, used in parallelized encoding

-thread_type[:stream_specifier] flags (input/output,video)

select multithreading type

Possible values:

slice
frame

-audio_service_type[:stream_specifier] integer (output,audio)

audio service type

Possible values:

ma: Main Audio Service
ef: Effects
vi: Visually Impaired
hi: Hearing Impaired
di: Dialogue
co: Commentary
em: Emergency
vo: Voice Over
ka: Karaoke

-request_sample_fmt[:stream_specifier] integer (input,audio)

Possible values:

u8: 8-bit unsigned integer
s16: 16-bit signed integer
s32: 32-bit signed integer
flt: 32-bit float
dbl: 64-bit double
u8p: 8-bit unsigned integer planar
s16p: 16-bit signed integer planar
s32p: 32-bit signed integer planar
fltp: 32-bit float planar
dblp: 64-bit double planar

-refcounted_frames[:stream_specifier] integer (input,audio,video)

-side_data_only_packets[:stream_specifier] integer (output,audio,video)

Format AVOptions

-probesize integer (input)

set probing size

-packetsize integer (output)

set packet size

-fflags flags (input/output)

Possible values:

flush_packets: reduce the latency by flushing out packets immediately
ignidx: ignore index
genpts: generate pts
nofillin: do not fill in missing values that can be exactly calculated
noparse: disable AVParsers, this needs nofillin too
igndts: ignore dts
discardcorrupt: discard corrupted frames
nobuffer: reduce the latency introduced by optional buffering
bitexact: do not write random/volatile data

-analyzeduration integer (input)

how many microseconds are analyzed to estimate duration

-cryptokey hexadecimal string (input)

decryption key

-indexmem integer (input)

max memory used for timestamp index (per stream)

-rtbufsize integer (input)

max memory used for buffering real-time frames

-fdebug flags (input/output)

print specific debug info

Possible values:

ts

-max_delay integer (input/output)

maximum muxing or demuxing delay in microseconds

-fpsprobesize integer (input)

number of frames used to probe fps

-f_err_detect flags (input)

set error detection flags (deprecated; use err_detect, save via avconv)

Possible values:

crccheck: verify embedded CRCs
bitstream: detect bitstream specification deviations
buffer: detect improper bitstream length
explode: abort decoding on minor error detection

-err_detect flags (input)

set error detection flags

Possible values:

crccheck: verify embedded CRCs
bitstream: detect bitstream specification deviations
buffer: detect improper bitstream length
explode: abort decoding on minor error detection

-max_interleave_delta integer (output)

maximum buffering duration for interleaving

-f_strict integer (input/output)

how strictly to follow the standards (deprecated; use strict, save via avconv)

Possible values:

strict: strictly conform to all the things in the spec no matter what the consequences
normal
experimental: allow non-standardized experimental variants

-strict integer (input/output)

how strictly to follow the standards

Possible values:

strict: strictly conform to all the things in the spec no matter what the consequences
normal
experimental: allow non-standardized experimental variants

-max_ts_probe integer (input)

maximum number of packets to read while waiting for the first timestamp

-avoid_negative_ts integer (output)

shift timestamps so they start at 0

Possible values:

auto: enabled when required by target format
make_non_negative: shift timestamps so they are non negative
make_zero: shift timestamps so they start at 0

-protocol_blacklist string (input/output)

A comma-separated list of blacklisted protocols used for opening files internally by lavf

-protocol_whitelist string (input/output)

A comma-separated list of whitelisted protocols used for opening files internally by lavf

Main options

-f format

Force format to use.

-of formatter

Use a specific formatter to output the document. The followingformatters are available

ini
json
old: Pseudo-INI format that used to be the only one available in oldavprobe versions.

-unit

Show the unit of the displayed values.

-prefix

Use SI prefixes for the displayed values.Unless the ``-byte_binary_prefix'' option is used all the prefixesare decimal.

-byte_binary_prefix

Force the use of binary prefixes for byte values.

-sexagesimal

Use sexagesimal format HH:MM:SS.MICROSECONDS for time values.

-pretty

Prettify the format of the displayed values, it corresponds to theoptions ``-unit -prefix -byte_binary_prefix -sexagesimal''.

-show_format

Show information about the container format of the input multimediastream.

All the container format information is printed within a section withname ``FORMAT''.

-show_format_entry name

Like -show_format, but only prints the specified entry of thecontainer format information, rather than all. This option may be given morethan once, then all specified entries will be shown.

-show_packets

Show information about each packet contained in the input multimediastream.

The information for each single packet is printed within a dedicatedsection with name ``PACKET''.

-show_streams

Show information about each media stream contained in the inputmultimedia stream.

Each media stream information is printed within a dedicated sectionwith name ``STREAM''.

DEMUXERS

Demuxers are configured elements in Libav which allow to read themultimedia streams from a particular type of file.

When you configure your Libav build, all the supported demuxersare enabled by default. You can list all available ones using theconfigure option ``--list-demuxers''.

You can disable all the demuxers using the configure option``--disable-demuxers'', and selectively enable a single demuxer withthe option "--enable-demuxer=DEMUXER``, or disable itwith the option ''--disable-demuxer=DEMUXER".

The option ``-formats'' of the av* tools will display the list ofenabled demuxers.

The description of some of the currently available demuxers follows.

image2

Image file demuxer.

This demuxer reads from a list of image files specified by a pattern.

The pattern may contain the string ``%d'' or "%0Nd``, whichspecifies the position of the characters representing a sequentialnumber in each filename matched by the pattern. If the form''%d0Nd" is used, the string representing the number in eachfilename is 0-padded and N is the total number of 0-paddeddigits representing the number. The literal character '%' can bespecified in the pattern with the string ``%%''.

If the pattern contains ``%d'' or "%0Nd", the first filename ofthe file list specified by the pattern must contain a numberinclusively contained between 0 and 4, all the following numbers mustbe sequential. This limitation may be hopefully fixed.

The pattern may contain a suffix which is used to automaticallydetermine the format of the images contained in the files.

For example the pattern ``img-%03d.bmp'' will match a sequence offilenames of the form img-001.bmp, img-002.bmp, ...,img-010.bmp, etc.; the pattern ``i%%m%%g-%d.jpg'' will match asequence of filenames of the form i%m%g-1.jpg,i%m%g-2.jpg, ..., i%m%g-10.jpg, etc.

The size, the pixel format, and the format of each image must be thesame for all the files in the sequence.

The following example shows how to use avconv for creating avideo from the images in the file sequence img-001.jpeg,img-002.jpeg, ..., assuming an input framerate of 10 frames persecond:

        avconv -i 'img-%03d.jpeg' -r 10 out.mkv

Note that the pattern must not necessarily contain ``%d'' or"%0Nd", for example to convert a single image fileimg.jpeg you can employ the command:

        avconv -i img.jpeg img.png

-pixel_format format: Set the pixel format (for raw image)
-video_size size: Set the frame size (for raw image)
-framerate rate: Set the frame rate
-loop bool: Loop over the images
-start_number start: Specify the first number in the sequence

applehttp

Apple HTTP Live Streaming demuxer.

This demuxer presents all AVStreams from all variant streams.The id field is set to the bitrate variant index number. By settingthe discard flags on AVStreams (by pressing 'a' or 'v' in avplay),the caller can decide which variant streams to actually receive.The total bitrate of the variant that the stream belongs to isavailable in a metadata key named ``variant_bitrate''.

flv

Adobe Flash Video Format demuxer.

This demuxer is used to demux FLV files and RTMP<