yading@10: All the numerical options, if not specified otherwise, accept a string
yading@10: representing a number as input, which may be followed by one of the SI
yading@10: unit prefixes, for example: 'K', 'M', or 'G'.
yading@10: 
yading@10: If 'i' is appended to the SI unit prefix, the complete prefix will be
yading@10: interpreted as a unit prefix for binary multiplies, which are based on
yading@10: powers of 1024 instead of powers of 1000. Appending 'B' to the SI unit
yading@10: prefix multiplies the value by 8. This allows using, for example:
yading@10: 'KB', 'MiB', 'G' and 'B' as number suffixes.
yading@10: 
yading@10: Options which do not take arguments are boolean options, and set the
yading@10: corresponding value to true. They can be set to false by prefixing
yading@10: the option name with "no". For example using "-nofoo"
yading@10: will set the boolean option with name "foo" to false.
yading@10: 
yading@10: @anchor{Stream specifiers}
yading@10: @section Stream specifiers
yading@10: Some options are applied per-stream, e.g. bitrate or codec. Stream specifiers
yading@10: are used to precisely specify which stream(s) a given option belongs to.
yading@10: 
yading@10: A stream specifier is a string generally appended to the option name and
yading@10: separated from it by a colon. E.g. @code{-codec:a:1 ac3} contains the
yading@10: @code{a:1} stream specifier, which matches the second audio stream. Therefore, it
yading@10: would select the ac3 codec for the second audio stream.
yading@10: 
yading@10: A stream specifier can match several streams, so that the option is applied to all
yading@10: of them. E.g. the stream specifier in @code{-b:a 128k} matches all audio
yading@10: streams.
yading@10: 
yading@10: An empty stream specifier matches all streams. For example, @code{-codec copy}
yading@10: or @code{-codec: copy} would copy all the streams without reencoding.
yading@10: 
yading@10: Possible forms of stream specifiers are:
yading@10: @table @option
yading@10: @item @var{stream_index}
yading@10: Matches the stream with this index. E.g. @code{-threads:1 4} would set the
yading@10: thread count for the second stream to 4.
yading@10: @item @var{stream_type}[:@var{stream_index}]
yading@10: @var{stream_type} is one of following: 'v' for video, 'a' for audio, 's' for subtitle,
yading@10: 'd' for data, and 't' for attachments. If @var{stream_index} is given, then it matches
yading@10: stream number @var{stream_index} of this type. Otherwise, it matches all
yading@10: streams of this type.
yading@10: @item p:@var{program_id}[:@var{stream_index}]
yading@10: If @var{stream_index} is given, then it matches the stream with number @var{stream_index}
yading@10: in the program with the id @var{program_id}. Otherwise, it matches all streams in the
yading@10: program.
yading@10: @item #@var{stream_id}
yading@10: Matches the stream by a format-specific ID.
yading@10: @end table
yading@10: 
yading@10: @section Generic options
yading@10: 
yading@10: These options are shared amongst the ff* tools.
yading@10: 
yading@10: @table @option
yading@10: 
yading@10: @item -L
yading@10: Show license.
yading@10: 
yading@10: @item -h, -?, -help, --help [@var{arg}]
yading@10: Show help. An optional parameter may be specified to print help about a specific
yading@10: item.
yading@10: 
yading@10: Possible values of @var{arg} are:
yading@10: @table @option
yading@10: @item decoder=@var{decoder_name}
yading@10: Print detailed information about the decoder named @var{decoder_name}. Use the
yading@10: @option{-decoders} option to get a list of all decoders.
yading@10: 
yading@10: @item encoder=@var{encoder_name}
yading@10: Print detailed information about the encoder named @var{encoder_name}. Use the
yading@10: @option{-encoders} option to get a list of all encoders.
yading@10: 
yading@10: @item demuxer=@var{demuxer_name}
yading@10: Print detailed information about the demuxer named @var{demuxer_name}. Use the
yading@10: @option{-formats} option to get a list of all demuxers and muxers.
yading@10: 
yading@10: @item muxer=@var{muxer_name}
yading@10: Print detailed information about the muxer named @var{muxer_name}. Use the
yading@10: @option{-formats} option to get a list of all muxers and demuxers.
yading@10: 
yading@10: @item filter=@var{filter_name}
yading@10: Print detailed information about the filter name @var{filter_name}. Use the
yading@10: @option{-filters} option to get a list of all filters.
yading@10: 
yading@10: @end table
yading@10: 
yading@10: @item -version
yading@10: Show version.
yading@10: 
yading@10: @item -formats
yading@10: Show available formats.
yading@10: 
yading@10: @item -codecs
yading@10: Show all codecs known to libavcodec.
yading@10: 
yading@10: Note that the term 'codec' is used throughout this documentation as a shortcut
yading@10: for what is more correctly called a media bitstream format.
yading@10: 
yading@10: @item -decoders
yading@10: Show available decoders.
yading@10: 
yading@10: @item -encoders
yading@10: Show all available encoders.
yading@10: 
yading@10: @item -bsfs
yading@10: Show available bitstream filters.
yading@10: 
yading@10: @item -protocols
yading@10: Show available protocols.
yading@10: 
yading@10: @item -filters
yading@10: Show available libavfilter filters.
yading@10: 
yading@10: @item -pix_fmts
yading@10: Show available pixel formats.
yading@10: 
yading@10: @item -sample_fmts
yading@10: Show available sample formats.
yading@10: 
yading@10: @item -layouts
yading@10: Show channel names and standard channel layouts.
yading@10: 
yading@10: @item -loglevel [repeat+]@var{loglevel} | -v [repeat+]@var{loglevel}
yading@10: Set the logging level used by the library.
yading@10: Adding "repeat+" indicates that repeated log output should not be compressed
yading@10: to the first line and the "Last message repeated n times" line will be
yading@10: omitted. "repeat" can also be used alone.
yading@10: If "repeat" is used alone, and with no prior loglevel set, the default
yading@10: loglevel will be used. If multiple loglevel parameters are given, using
yading@10: 'repeat' will not change the loglevel.
yading@10: @var{loglevel} is a number or a string containing one of the following values:
yading@10: @table @samp
yading@10: @item quiet
yading@10: Show nothing at all; be silent.
yading@10: @item panic
yading@10: Only show fatal errors which could lead the process to crash, such as
yading@10: and assert failure. This is not currently used for anything.
yading@10: @item fatal
yading@10: Only show fatal errors. These are errors after which the process absolutely
yading@10: cannot continue after.
yading@10: @item error
yading@10: Show all errors, including ones which can be recovered from.
yading@10: @item warning
yading@10: Show all warnings and errors. Any message related to possibly
yading@10: incorrect or unexpected events will be shown.
yading@10: @item info
yading@10: Show informative messages during processing. This is in addition to
yading@10: warnings and errors. This is the default value.
yading@10: @item verbose
yading@10: Same as @code{info}, except more verbose.
yading@10: @item debug
yading@10: Show everything, including debugging information.
yading@10: @end table
yading@10: 
yading@10: By default the program logs to stderr, if coloring is supported by the
yading@10: terminal, colors are used to mark errors and warnings. Log coloring
yading@10: can be disabled setting the environment variable
yading@10: @env{AV_LOG_FORCE_NOCOLOR} or @env{NO_COLOR}, or can be forced setting
yading@10: the environment variable @env{AV_LOG_FORCE_COLOR}.
yading@10: The use of the environment variable @env{NO_COLOR} is deprecated and
yading@10: will be dropped in a following FFmpeg version.
yading@10: 
yading@10: @item -report
yading@10: Dump full command line and console output to a file named
yading@10: @code{@var{program}-@var{YYYYMMDD}-@var{HHMMSS}.log} in the current
yading@10: directory.
yading@10: This file can be useful for bug reports.
yading@10: It also implies @code{-loglevel verbose}.
yading@10: 
yading@10: Setting the environment variable @code{FFREPORT} to any value has the
yading@10: same effect. If the value is a ':'-separated key=value sequence, these
yading@10: options will affect the report; options values must be escaped if they
yading@10: contain special characters or the options delimiter ':' (see the
yading@10: ``Quoting and escaping'' section in the ffmpeg-utils manual). The
yading@10: following option is recognized:
yading@10: @table @option
yading@10: @item file
yading@10: set the file name to use for the report; @code{%p} is expanded to the name
yading@10: of the program, @code{%t} is expanded to a timestamp, @code{%%} is expanded
yading@10: to a plain @code{%}
yading@10: @end table
yading@10: 
yading@10: Errors in parsing the environment variable are not fatal, and will not
yading@10: appear in the report.
yading@10: 
yading@10: @item -cpuflags flags (@emph{global})
yading@10: Allows setting and clearing cpu flags. This option is intended
yading@10: for testing. Do not use it unless you know what you're doing.
yading@10: @example
yading@10: ffmpeg -cpuflags -sse+mmx ...
yading@10: ffmpeg -cpuflags mmx ...
yading@10: ffmpeg -cpuflags 0 ...
yading@10: @end example
yading@10: Possible flags for this option are:
yading@10: @table @samp
yading@10: @item x86
yading@10: @table @samp
yading@10: @item mmx
yading@10: @item mmxext
yading@10: @item sse
yading@10: @item sse2
yading@10: @item sse2slow
yading@10: @item sse3
yading@10: @item sse3slow
yading@10: @item ssse3
yading@10: @item atom
yading@10: @item sse4.1
yading@10: @item sse4.2
yading@10: @item avx
yading@10: @item xop
yading@10: @item fma4
yading@10: @item 3dnow
yading@10: @item 3dnowext
yading@10: @item cmov
yading@10: @end table
yading@10: @item ARM
yading@10: @table @samp
yading@10: @item armv5te
yading@10: @item armv6
yading@10: @item armv6t2
yading@10: @item vfp
yading@10: @item vfpv3
yading@10: @item neon
yading@10: @end table
yading@10: @item PowerPC
yading@10: @table @samp
yading@10: @item altivec
yading@10: @end table
yading@10: @item Specific Processors
yading@10: @table @samp
yading@10: @item pentium2
yading@10: @item pentium3
yading@10: @item pentium4
yading@10: @item k6
yading@10: @item k62
yading@10: @item athlon
yading@10: @item athlonxp
yading@10: @item k8
yading@10: @end table
yading@10: @end table
yading@10: 
yading@10: @item -opencl_options options (@emph{global})
yading@10: Set OpenCL environment options. This option is only available when
yading@10: FFmpeg has been compiled with @code{--enable-opencl}.
yading@10: 
yading@10: @var{options} must be a list of @var{key}=@var{value} option pairs
yading@10: separated by ':'. See the ``OpenCL Options'' section in the
yading@10: ffmpeg-utils manual for the list of supported options.
yading@10: @end table
yading@10: 
yading@10: @section AVOptions
yading@10: 
yading@10: These options are provided directly by the libavformat, libavdevice and
yading@10: libavcodec libraries. To see the list of available AVOptions, use the
yading@10: @option{-help} option. They are separated into two categories:
yading@10: @table @option
yading@10: @item generic
yading@10: These options can be set for any container, codec or device. Generic options
yading@10: are listed under AVFormatContext options for containers/devices and under
yading@10: AVCodecContext options for codecs.
yading@10: @item private
yading@10: These options are specific to the given container, device or codec. Private
yading@10: options are listed under their corresponding containers/devices/codecs.
yading@10: @end table
yading@10: 
yading@10: For example to write an ID3v2.3 header instead of a default ID3v2.4 to
yading@10: an MP3 file, use the @option{id3v2_version} private option of the MP3
yading@10: muxer:
yading@10: @example
yading@10: ffmpeg -i input.flac -id3v2_version 3 out.mp3
yading@10: @end example
yading@10: 
yading@10: All codec AVOptions are obviously per-stream, so the chapter on stream
yading@10: specifiers applies to them
yading@10: 
yading@10: Note @option{-nooption} syntax cannot be used for boolean AVOptions,
yading@10: use @option{-option 0}/@option{-option 1}.
yading@10: 
yading@10: Note2 old undocumented way of specifying per-stream AVOptions by prepending
yading@10: v/a/s to the options name is now obsolete and will be removed soon.