1All the numerical options, if not specified otherwise, accept a string 2representing a number as input, which may be followed by one of the SI 3unit prefixes, for example: 'K', 'M', or 'G'. 4 5If 'i' is appended to the SI unit prefix, the complete prefix will be 6interpreted as a unit prefix for binary multiples, which are based on 7powers of 1024 instead of powers of 1000. Appending 'B' to the SI unit 8prefix multiplies the value by 8. This allows using, for example: 9'KB', 'MiB', 'G' and 'B' as number suffixes. 10 11Options which do not take arguments are boolean options, and set the 12corresponding value to true. They can be set to false by prefixing 13the option name with "no". For example using "-nofoo" 14will set the boolean option with name "foo" to false. 15 16@anchor{Stream specifiers} 17@section Stream specifiers 18Some options are applied per-stream, e.g. bitrate or codec. Stream specifiers 19are used to precisely specify which stream(s) a given option belongs to. 20 21A stream specifier is a string generally appended to the option name and 22separated from it by a colon. E.g. @code{-codec:a:1 ac3} contains the 23@code{a:1} stream specifier, which matches the second audio stream. Therefore, it 24would select the ac3 codec for the second audio stream. 25 26A stream specifier can match several streams, so that the option is applied to all 27of them. E.g. the stream specifier in @code{-b:a 128k} matches all audio 28streams. 29 30An empty stream specifier matches all streams. For example, @code{-codec copy} 31or @code{-codec: copy} would copy all the streams without reencoding. 32 33Possible forms of stream specifiers are: 34@table @option 35@item @var{stream_index} 36Matches the stream with this index. E.g. @code{-threads:1 4} would set the 37thread count for the second stream to 4. 38@item @var{stream_type}[:@var{stream_index}] 39@var{stream_type} is one of following: 'v' for video, 'a' for audio, 's' for subtitle, 40'd' for data, and 't' for attachments. If @var{stream_index} is given, then it matches 41stream number @var{stream_index} of this type. Otherwise, it matches all 42streams of this type. 43@item p:@var{program_id}[:@var{stream_index}] 44If @var{stream_index} is given, then it matches the stream with number @var{stream_index} 45in the program with the id @var{program_id}. Otherwise, it matches all streams in the 46program. 47@item #@var{stream_id} or i:@var{stream_id} 48Match the stream by stream id (e.g. PID in MPEG-TS container). 49@item m:@var{key}[:@var{value}] 50Matches streams with the metadata tag @var{key} having the specified value. If 51@var{value} is not given, matches streams that contain the given tag with any 52value. 53 54Note that in @command{ffmpeg}, matching by metadata will only work properly for 55input files. 56@end table 57 58@section Generic options 59 60These options are shared amongst the ff* tools. 61 62@table @option 63 64@item -L 65Show license. 66 67@item -h, -?, -help, --help [@var{arg}] 68Show help. An optional parameter may be specified to print help about a specific 69item. If no argument is specified, only basic (non advanced) tool 70options are shown. 71 72Possible values of @var{arg} are: 73@table @option 74@item long 75Print advanced tool options in addition to the basic tool options. 76 77@item full 78Print complete list of options, including shared and private options 79for encoders, decoders, demuxers, muxers, filters, etc. 80 81@item decoder=@var{decoder_name} 82Print detailed information about the decoder named @var{decoder_name}. Use the 83@option{-decoders} option to get a list of all decoders. 84 85@item encoder=@var{encoder_name} 86Print detailed information about the encoder named @var{encoder_name}. Use the 87@option{-encoders} option to get a list of all encoders. 88 89@item demuxer=@var{demuxer_name} 90Print detailed information about the demuxer named @var{demuxer_name}. Use the 91@option{-formats} option to get a list of all demuxers and muxers. 92 93@item muxer=@var{muxer_name} 94Print detailed information about the muxer named @var{muxer_name}. Use the 95@option{-formats} option to get a list of all muxers and demuxers. 96 97@item filter=@var{filter_name} 98Print detailed information about the filter name @var{filter_name}. Use the 99@option{-filters} option to get a list of all filters. 100@end table 101 102@item -version 103Show version. 104 105@item -formats 106Show available formats. 107 108@item -codecs 109Show all codecs known to libavcodec. 110 111Note that the term 'codec' is used throughout this documentation as a shortcut 112for what is more correctly called a media bitstream format. 113 114@item -decoders 115Show available decoders. 116 117@item -encoders 118Show all available encoders. 119 120@item -bsfs 121Show available bitstream filters. 122 123@item -protocols 124Show available protocols. 125 126@item -filters 127Show available libavfilter filters. 128 129@item -pix_fmts 130Show available pixel formats. 131 132@item -sample_fmts 133Show available sample formats. 134 135@item -layouts 136Show channel names and standard channel layouts. 137 138@item -colors 139Show recognized color names. 140 141@item -loglevel [repeat+]@var{loglevel} | -v [repeat+]@var{loglevel} 142Set the logging level used by the library. 143Adding "repeat+" indicates that repeated log output should not be compressed 144to the first line and the "Last message repeated n times" line will be 145omitted. "repeat" can also be used alone. 146If "repeat" is used alone, and with no prior loglevel set, the default 147loglevel will be used. If multiple loglevel parameters are given, using 148'repeat' will not change the loglevel. 149@var{loglevel} is a number or a string containing one of the following values: 150@table @samp 151@item quiet 152Show nothing at all; be silent. 153@item panic 154Only show fatal errors which could lead the process to crash, such as 155and assert failure. This is not currently used for anything. 156@item fatal 157Only show fatal errors. These are errors after which the process absolutely 158cannot continue after. 159@item error 160Show all errors, including ones which can be recovered from. 161@item warning 162Show all warnings and errors. Any message related to possibly 163incorrect or unexpected events will be shown. 164@item info 165Show informative messages during processing. This is in addition to 166warnings and errors. This is the default value. 167@item verbose 168Same as @code{info}, except more verbose. 169@item debug 170Show everything, including debugging information. 171@end table 172 173By default the program logs to stderr, if coloring is supported by the 174terminal, colors are used to mark errors and warnings. Log coloring 175can be disabled setting the environment variable 176@env{AV_LOG_FORCE_NOCOLOR} or @env{NO_COLOR}, or can be forced setting 177the environment variable @env{AV_LOG_FORCE_COLOR}. 178The use of the environment variable @env{NO_COLOR} is deprecated and 179will be dropped in a following FFmpeg version. 180 181@item -report 182Dump full command line and console output to a file named 183@code{@var{program}-@var{YYYYMMDD}-@var{HHMMSS}.log} in the current 184directory. 185This file can be useful for bug reports. 186It also implies @code{-loglevel verbose}. 187 188Setting the environment variable @code{FFREPORT} to any value has the 189same effect. If the value is a ':'-separated key=value sequence, these 190options will affect the report; options values must be escaped if they 191contain special characters or the options delimiter ':' (see the 192``Quoting and escaping'' section in the ffmpeg-utils manual). The 193following option is recognized: 194@table @option 195@item file 196set the file name to use for the report; @code{%p} is expanded to the name 197of the program, @code{%t} is expanded to a timestamp, @code{%%} is expanded 198to a plain @code{%} 199@item level 200set the log level 201@end table 202 203Errors in parsing the environment variable are not fatal, and will not 204appear in the report. 205 206@item -hide_banner 207Suppress printing banner. 208 209All FFmpeg tools will normally show a copyright notice, build options 210and library versions. This option can be used to suppress printing 211this information. 212 213@item -cpuflags flags (@emph{global}) 214Allows setting and clearing cpu flags. This option is intended 215for testing. Do not use it unless you know what you're doing. 216@example 217ffmpeg -cpuflags -sse+mmx ... 218ffmpeg -cpuflags mmx ... 219ffmpeg -cpuflags 0 ... 220@end example 221Possible flags for this option are: 222@table @samp 223@item x86 224@table @samp 225@item mmx 226@item mmxext 227@item sse 228@item sse2 229@item sse2slow 230@item sse3 231@item sse3slow 232@item ssse3 233@item atom 234@item sse4.1 235@item sse4.2 236@item avx 237@item xop 238@item fma4 239@item 3dnow 240@item 3dnowext 241@item cmov 242@end table 243@item ARM 244@table @samp 245@item armv5te 246@item armv6 247@item armv6t2 248@item vfp 249@item vfpv3 250@item neon 251@end table 252@item PowerPC 253@table @samp 254@item altivec 255@end table 256@item Specific Processors 257@table @samp 258@item pentium2 259@item pentium3 260@item pentium4 261@item k6 262@item k62 263@item athlon 264@item athlonxp 265@item k8 266@end table 267@end table 268 269@item -opencl_bench 270Benchmark all available OpenCL devices and show the results. This option 271is only available when FFmpeg has been compiled with @code{--enable-opencl}. 272 273@item -opencl_options options (@emph{global}) 274Set OpenCL environment options. This option is only available when 275FFmpeg has been compiled with @code{--enable-opencl}. 276 277@var{options} must be a list of @var{key}=@var{value} option pairs 278separated by ':'. See the ``OpenCL Options'' section in the 279ffmpeg-utils manual for the list of supported options. 280@end table 281 282@section AVOptions 283 284These options are provided directly by the libavformat, libavdevice and 285libavcodec libraries. To see the list of available AVOptions, use the 286@option{-help} option. They are separated into two categories: 287@table @option 288@item generic 289These options can be set for any container, codec or device. Generic options 290are listed under AVFormatContext options for containers/devices and under 291AVCodecContext options for codecs. 292@item private 293These options are specific to the given container, device or codec. Private 294options are listed under their corresponding containers/devices/codecs. 295@end table 296 297For example to write an ID3v2.3 header instead of a default ID3v2.4 to 298an MP3 file, use the @option{id3v2_version} private option of the MP3 299muxer: 300@example 301ffmpeg -i input.flac -id3v2_version 3 out.mp3 302@end example 303 304All codec AVOptions are per-stream, and thus a stream specifier 305should be attached to them. 306 307Note: the @option{-nooption} syntax cannot be used for boolean 308AVOptions, use @option{-option 0}/@option{-option 1}. 309 310Note: the old undocumented way of specifying per-stream AVOptions by 311prepending v/a/s to the options name is now obsolete and will be 312removed soon. 313