2013-03-30 20:21:36 +01:00
|
|
|
All the numerical options, if not specified otherwise, accept a string
|
|
|
|
representing a number as input, which may be followed by one of the SI
|
|
|
|
unit prefixes, for example: 'K', 'M', or 'G'.
|
|
|
|
|
|
|
|
If 'i' is appended to the SI unit prefix, the complete prefix will be
|
2014-08-27 22:39:29 +02:00
|
|
|
interpreted as a unit prefix for binary multiples, which are based on
|
2013-03-30 20:21:36 +01:00
|
|
|
powers of 1024 instead of powers of 1000. Appending 'B' to the SI unit
|
|
|
|
prefix multiplies the value by 8. This allows using, for example:
|
|
|
|
'KB', 'MiB', 'G' and 'B' as number suffixes.
|
2010-06-09 23:28:53 +02:00
|
|
|
|
2010-06-16 21:16:20 +02:00
|
|
|
Options which do not take arguments are boolean options, and set the
|
|
|
|
corresponding value to true. They can be set to false by prefixing
|
2013-03-30 20:21:36 +01:00
|
|
|
the option name with "no". For example using "-nofoo"
|
|
|
|
will set the boolean option with name "foo" to false.
|
2010-06-16 21:16:20 +02:00
|
|
|
|
2011-12-13 11:23:06 +01:00
|
|
|
@anchor{Stream specifiers}
|
2011-09-03 14:55:39 +02:00
|
|
|
@section Stream specifiers
|
|
|
|
Some options are applied per-stream, e.g. bitrate or codec. Stream specifiers
|
2013-03-30 20:26:21 +01:00
|
|
|
are used to precisely specify which stream(s) a given option belongs to.
|
2011-09-03 14:55:39 +02:00
|
|
|
|
|
|
|
A stream specifier is a string generally appended to the option name and
|
2013-03-30 20:26:21 +01:00
|
|
|
separated from it by a colon. E.g. @code{-codec:a:1 ac3} contains the
|
|
|
|
@code{a:1} stream specifier, which matches the second audio stream. Therefore, it
|
2011-09-03 14:55:39 +02:00
|
|
|
would select the ac3 codec for the second audio stream.
|
|
|
|
|
2013-03-30 20:26:21 +01:00
|
|
|
A stream specifier can match several streams, so that the option is applied to all
|
2011-09-03 14:55:39 +02:00
|
|
|
of them. E.g. the stream specifier in @code{-b:a 128k} matches all audio
|
|
|
|
streams.
|
|
|
|
|
2013-03-30 20:26:21 +01:00
|
|
|
An empty stream specifier matches all streams. For example, @code{-codec copy}
|
2011-09-03 14:55:39 +02:00
|
|
|
or @code{-codec: copy} would copy all the streams without reencoding.
|
|
|
|
|
|
|
|
Possible forms of stream specifiers are:
|
|
|
|
@table @option
|
|
|
|
@item @var{stream_index}
|
|
|
|
Matches the stream with this index. E.g. @code{-threads:1 4} would set the
|
|
|
|
thread count for the second stream to 4.
|
|
|
|
@item @var{stream_type}[:@var{stream_index}]
|
2015-08-31 21:22:46 +02:00
|
|
|
@var{stream_type} is one of following: 'v' or 'V' for video, 'a' for audio, 's'
|
|
|
|
for subtitle, 'd' for data, and 't' for attachments. 'v' matches all video
|
|
|
|
streams, 'V' only matches video streams which are not attached pictures, video
|
|
|
|
thumbnails or cover arts. If @var{stream_index} is given, then it matches
|
2013-03-30 20:26:21 +01:00
|
|
|
stream number @var{stream_index} of this type. Otherwise, it matches all
|
2011-09-27 10:37:22 +02:00
|
|
|
streams of this type.
|
2018-04-13 12:11:32 +02:00
|
|
|
@item p:@var{program_id}[:@var{stream_index}] or p:@var{program_id}[:@var{stream_type}[:@var{stream_index}]] or
|
|
|
|
p:@var{program_id}:m:@var{key}[:@var{value}]
|
2018-04-01 23:29:14 +02:00
|
|
|
In first version, if @var{stream_index} is given, then it matches the stream with number @var{stream_index}
|
2013-03-30 20:26:21 +01:00
|
|
|
in the program with the id @var{program_id}. Otherwise, it matches all streams in the
|
2018-04-13 12:11:32 +02:00
|
|
|
program. In the second version, @var{stream_type} is one of following: 'v' for video, 'a' for audio, 's'
|
2018-04-01 23:29:14 +02:00
|
|
|
for subtitle, 'd' for data. If @var{stream_index} is also given, then it matches
|
|
|
|
stream number @var{stream_index} of this type in the program with the id @var{program_id}.
|
|
|
|
Otherwise, if only @var{stream_type} is given, it matches all
|
|
|
|
streams of this type in the program with the id @var{program_id}.
|
2018-04-13 12:11:32 +02:00
|
|
|
In the third version matches streams in the program with the id @var{program_id} with the metadata
|
|
|
|
tag @var{key} having the specified value. If
|
|
|
|
@var{value} is not given, matches streams that contain the given tag with any
|
|
|
|
value.
|
|
|
|
|
2014-03-13 14:16:00 +01:00
|
|
|
@item #@var{stream_id} or i:@var{stream_id}
|
|
|
|
Match the stream by stream id (e.g. PID in MPEG-TS container).
|
2014-08-14 00:41:08 +02:00
|
|
|
@item m:@var{key}[:@var{value}]
|
|
|
|
Matches streams with the metadata tag @var{key} having the specified value. If
|
|
|
|
@var{value} is not given, matches streams that contain the given tag with any
|
|
|
|
value.
|
2015-03-20 19:55:44 +01:00
|
|
|
@item u
|
|
|
|
Matches streams with usable configuration, the codec must be defined and the
|
|
|
|
essential information such as video dimension or audio sample rate must be present.
|
2014-08-14 00:41:08 +02:00
|
|
|
|
2014-08-14 01:00:49 +02:00
|
|
|
Note that in @command{ffmpeg}, matching by metadata will only work properly for
|
2014-08-14 00:41:08 +02:00
|
|
|
input files.
|
2011-09-03 14:55:39 +02:00
|
|
|
@end table
|
2012-07-20 12:55:14 +02:00
|
|
|
|
2010-02-21 11:56:38 +01:00
|
|
|
@section Generic options
|
|
|
|
|
2013-03-27 01:43:37 +01:00
|
|
|
These options are shared amongst the ff* tools.
|
2010-02-21 11:56:38 +01:00
|
|
|
|
|
|
|
@table @option
|
|
|
|
|
2009-12-21 22:32:09 +01:00
|
|
|
@item -L
|
|
|
|
Show license.
|
|
|
|
|
2012-08-13 20:06:25 +02:00
|
|
|
@item -h, -?, -help, --help [@var{arg}]
|
|
|
|
Show help. An optional parameter may be specified to print help about a specific
|
2013-09-17 00:14:54 +02:00
|
|
|
item. If no argument is specified, only basic (non advanced) tool
|
|
|
|
options are shown.
|
2012-08-13 20:06:25 +02:00
|
|
|
|
|
|
|
Possible values of @var{arg} are:
|
|
|
|
@table @option
|
2013-09-17 00:14:54 +02:00
|
|
|
@item long
|
|
|
|
Print advanced tool options in addition to the basic tool options.
|
|
|
|
|
|
|
|
@item full
|
|
|
|
Print complete list of options, including shared and private options
|
|
|
|
for encoders, decoders, demuxers, muxers, filters, etc.
|
|
|
|
|
2012-08-13 20:06:25 +02:00
|
|
|
@item decoder=@var{decoder_name}
|
|
|
|
Print detailed information about the decoder named @var{decoder_name}. Use the
|
|
|
|
@option{-decoders} option to get a list of all decoders.
|
|
|
|
|
|
|
|
@item encoder=@var{encoder_name}
|
|
|
|
Print detailed information about the encoder named @var{encoder_name}. Use the
|
|
|
|
@option{-encoders} option to get a list of all encoders.
|
2012-08-14 07:57:56 +02:00
|
|
|
|
|
|
|
@item demuxer=@var{demuxer_name}
|
|
|
|
Print detailed information about the demuxer named @var{demuxer_name}. Use the
|
|
|
|
@option{-formats} option to get a list of all demuxers and muxers.
|
|
|
|
|
|
|
|
@item muxer=@var{muxer_name}
|
|
|
|
Print detailed information about the muxer named @var{muxer_name}. Use the
|
|
|
|
@option{-formats} option to get a list of all muxers and demuxers.
|
|
|
|
|
2013-03-28 09:29:00 +01:00
|
|
|
@item filter=@var{filter_name}
|
|
|
|
Print detailed information about the filter name @var{filter_name}. Use the
|
|
|
|
@option{-filters} option to get a list of all filters.
|
2012-08-13 20:06:25 +02:00
|
|
|
@end table
|
2009-12-21 22:32:09 +01:00
|
|
|
|
|
|
|
@item -version
|
|
|
|
Show version.
|
|
|
|
|
|
|
|
@item -formats
|
2014-10-24 23:31:03 +02:00
|
|
|
Show available formats (including devices).
|
|
|
|
|
2017-02-10 12:40:14 +01:00
|
|
|
@item -demuxers
|
|
|
|
Show available demuxers.
|
|
|
|
|
|
|
|
@item -muxers
|
|
|
|
Show available muxers.
|
|
|
|
|
2014-10-24 23:31:03 +02:00
|
|
|
@item -devices
|
|
|
|
Show available devices.
|
2009-12-21 22:32:09 +01:00
|
|
|
|
|
|
|
@item -codecs
|
2012-08-11 15:23:22 +02:00
|
|
|
Show all codecs known to libavcodec.
|
2009-12-21 22:32:09 +01:00
|
|
|
|
2012-08-11 15:23:22 +02:00
|
|
|
Note that the term 'codec' is used throughout this documentation as a shortcut
|
|
|
|
for what is more correctly called a media bitstream format.
|
|
|
|
|
|
|
|
@item -decoders
|
|
|
|
Show available decoders.
|
|
|
|
|
|
|
|
@item -encoders
|
|
|
|
Show all available encoders.
|
2009-12-21 22:32:09 +01:00
|
|
|
|
|
|
|
@item -bsfs
|
|
|
|
Show available bitstream filters.
|
|
|
|
|
|
|
|
@item -protocols
|
|
|
|
Show available protocols.
|
|
|
|
|
|
|
|
@item -filters
|
|
|
|
Show available libavfilter filters.
|
|
|
|
|
2009-12-21 22:53:03 +01:00
|
|
|
@item -pix_fmts
|
|
|
|
Show available pixel formats.
|
|
|
|
|
2011-08-31 08:51:15 +02:00
|
|
|
@item -sample_fmts
|
|
|
|
Show available sample formats.
|
|
|
|
|
2012-07-30 00:34:01 +02:00
|
|
|
@item -layouts
|
|
|
|
Show channel names and standard channel layouts.
|
|
|
|
|
2013-10-17 19:04:16 +02:00
|
|
|
@item -colors
|
|
|
|
Show recognized color names.
|
|
|
|
|
2014-08-07 00:45:26 +02:00
|
|
|
@item -sources @var{device}[,@var{opt1}=@var{val1}[,@var{opt2}=@var{val2}]...]
|
2017-04-16 17:29:48 +02:00
|
|
|
Show autodetected sources of the input device.
|
2014-08-07 00:45:26 +02:00
|
|
|
Some devices may provide system-dependent source names that cannot be autodetected.
|
|
|
|
The returned list cannot be assumed to be always complete.
|
|
|
|
@example
|
|
|
|
ffmpeg -sources pulse,server=192.168.0.4
|
|
|
|
@end example
|
|
|
|
|
|
|
|
@item -sinks @var{device}[,@var{opt1}=@var{val1}[,@var{opt2}=@var{val2}]...]
|
|
|
|
Show autodetected sinks of the output device.
|
|
|
|
Some devices may provide system-dependent sink names that cannot be autodetected.
|
|
|
|
The returned list cannot be assumed to be always complete.
|
|
|
|
@example
|
|
|
|
ffmpeg -sinks pulse,server=192.168.0.4
|
|
|
|
@end example
|
|
|
|
|
2018-04-03 09:24:21 +02:00
|
|
|
@item -loglevel [@var{flags}+]@var{loglevel} | -v [@var{flags}+]@var{loglevel}
|
|
|
|
Set logging level and flags used by the library.
|
|
|
|
|
|
|
|
The optional @var{flags} prefix can consist of the following values:
|
|
|
|
@table @samp
|
|
|
|
@item repeat
|
|
|
|
Indicates that repeated log output should not be compressed to the first line
|
|
|
|
and the "Last message repeated n times" line will be omitted.
|
|
|
|
@item level
|
|
|
|
Indicates that log output should add a @code{[level]} prefix to each message
|
|
|
|
line. This can be used as an alternative to log coloring, e.g. when dumping the
|
|
|
|
log to file.
|
|
|
|
@end table
|
|
|
|
Flags can also be used alone by adding a '+'/'-' prefix to set/reset a single
|
|
|
|
flag without affecting other @var{flags} or changing @var{loglevel}. When
|
|
|
|
setting both @var{flags} and @var{loglevel}, a '+' separator is expected
|
|
|
|
between the last @var{flags} value and before @var{loglevel}.
|
|
|
|
|
2014-12-05 22:32:35 +01:00
|
|
|
@var{loglevel} is a string or a number containing one of the following values:
|
2009-12-21 22:32:09 +01:00
|
|
|
@table @samp
|
2014-12-05 22:32:35 +01:00
|
|
|
@item quiet, -8
|
2013-03-30 19:29:33 +01:00
|
|
|
Show nothing at all; be silent.
|
2014-12-05 22:32:35 +01:00
|
|
|
@item panic, 0
|
2013-03-30 19:29:33 +01:00
|
|
|
Only show fatal errors which could lead the process to crash, such as
|
2016-10-09 20:51:57 +02:00
|
|
|
an assertion failure. This is not currently used for anything.
|
2014-12-05 22:32:35 +01:00
|
|
|
@item fatal, 8
|
2013-03-30 19:29:33 +01:00
|
|
|
Only show fatal errors. These are errors after which the process absolutely
|
2016-10-09 20:51:57 +02:00
|
|
|
cannot continue.
|
2014-12-05 22:32:35 +01:00
|
|
|
@item error, 16
|
2013-03-30 19:29:33 +01:00
|
|
|
Show all errors, including ones which can be recovered from.
|
2014-12-05 22:32:35 +01:00
|
|
|
@item warning, 24
|
2013-03-30 19:29:33 +01:00
|
|
|
Show all warnings and errors. Any message related to possibly
|
|
|
|
incorrect or unexpected events will be shown.
|
2014-12-05 22:32:35 +01:00
|
|
|
@item info, 32
|
2013-03-30 19:29:33 +01:00
|
|
|
Show informative messages during processing. This is in addition to
|
|
|
|
warnings and errors. This is the default value.
|
2014-12-05 22:32:35 +01:00
|
|
|
@item verbose, 40
|
2013-03-30 19:29:33 +01:00
|
|
|
Same as @code{info}, except more verbose.
|
2014-12-05 22:32:35 +01:00
|
|
|
@item debug, 48
|
2013-03-30 19:29:33 +01:00
|
|
|
Show everything, including debugging information.
|
2015-04-20 02:48:19 +02:00
|
|
|
@item trace, 56
|
2009-12-21 22:32:09 +01:00
|
|
|
@end table
|
|
|
|
|
2018-04-03 09:24:21 +02:00
|
|
|
For example to enable repeated log output, add the @code{level} prefix, and set
|
|
|
|
@var{loglevel} to @code{verbose}:
|
|
|
|
@example
|
|
|
|
ffmpeg -loglevel repeat+level+verbose -i input output
|
|
|
|
@end example
|
|
|
|
Another example that enables repeated log output without affecting current
|
|
|
|
state of @code{level} prefix flag or @var{loglevel}:
|
|
|
|
@example
|
|
|
|
ffmpeg [...] -loglevel +repeat
|
|
|
|
@end example
|
|
|
|
|
2016-10-09 20:51:57 +02:00
|
|
|
By default the program logs to stderr. If coloring is supported by the
|
2010-06-16 21:16:23 +02:00
|
|
|
terminal, colors are used to mark errors and warnings. Log coloring
|
2010-12-06 22:47:10 +01:00
|
|
|
can be disabled setting the environment variable
|
2012-01-11 10:49:49 +01:00
|
|
|
@env{AV_LOG_FORCE_NOCOLOR} or @env{NO_COLOR}, or can be forced setting
|
|
|
|
the environment variable @env{AV_LOG_FORCE_COLOR}.
|
2010-12-06 23:24:21 +01:00
|
|
|
The use of the environment variable @env{NO_COLOR} is deprecated and
|
2016-10-09 20:51:57 +02:00
|
|
|
will be dropped in a future FFmpeg version.
|
2010-06-16 21:16:23 +02:00
|
|
|
|
2011-12-08 14:42:24 +01:00
|
|
|
@item -report
|
|
|
|
Dump full command line and console output to a file named
|
|
|
|
@code{@var{program}-@var{YYYYMMDD}-@var{HHMMSS}.log} in the current
|
|
|
|
directory.
|
|
|
|
This file can be useful for bug reports.
|
|
|
|
It also implies @code{-loglevel verbose}.
|
|
|
|
|
2014-12-11 21:46:54 +01:00
|
|
|
Setting the environment variable @env{FFREPORT} to any value has the
|
2012-12-16 13:05:08 +01:00
|
|
|
same effect. If the value is a ':'-separated key=value sequence, these
|
2014-12-11 21:46:54 +01:00
|
|
|
options will affect the report; option values must be escaped if they
|
2012-12-16 13:05:08 +01:00
|
|
|
contain special characters or the options delimiter ':' (see the
|
2014-12-11 21:46:54 +01:00
|
|
|
``Quoting and escaping'' section in the ffmpeg-utils manual).
|
|
|
|
|
|
|
|
The following options are recognized:
|
2012-11-02 13:15:51 +01:00
|
|
|
@table @option
|
|
|
|
@item file
|
|
|
|
set the file name to use for the report; @code{%p} is expanded to the name
|
|
|
|
of the program, @code{%t} is expanded to a timestamp, @code{%%} is expanded
|
|
|
|
to a plain @code{%}
|
2014-05-12 22:23:36 +02:00
|
|
|
@item level
|
2014-12-11 21:46:54 +01:00
|
|
|
set the log verbosity level using a numerical value (see @code{-loglevel}).
|
2012-11-02 13:15:51 +01:00
|
|
|
@end table
|
|
|
|
|
2014-12-11 21:46:54 +01:00
|
|
|
For example, to output a report to a file named @file{ffreport.log}
|
|
|
|
using a log level of @code{32} (alias for log level @code{info}):
|
|
|
|
|
|
|
|
@example
|
|
|
|
FFREPORT=file=ffreport.log:level=32 ffmpeg -i input output
|
|
|
|
@end example
|
|
|
|
|
2012-11-02 13:15:51 +01:00
|
|
|
Errors in parsing the environment variable are not fatal, and will not
|
|
|
|
appear in the report.
|
2011-12-08 14:42:24 +01:00
|
|
|
|
2013-12-28 05:18:39 +01:00
|
|
|
@item -hide_banner
|
|
|
|
Suppress printing banner.
|
|
|
|
|
|
|
|
All FFmpeg tools will normally show a copyright notice, build options
|
|
|
|
and library versions. This option can be used to suppress printing
|
|
|
|
this information.
|
|
|
|
|
2012-03-07 02:57:53 +01:00
|
|
|
@item -cpuflags flags (@emph{global})
|
|
|
|
Allows setting and clearing cpu flags. This option is intended
|
|
|
|
for testing. Do not use it unless you know what you're doing.
|
2012-03-07 06:15:45 +01:00
|
|
|
@example
|
|
|
|
ffmpeg -cpuflags -sse+mmx ...
|
|
|
|
ffmpeg -cpuflags mmx ...
|
|
|
|
ffmpeg -cpuflags 0 ...
|
|
|
|
@end example
|
2013-03-30 19:41:45 +01:00
|
|
|
Possible flags for this option are:
|
|
|
|
@table @samp
|
|
|
|
@item x86
|
|
|
|
@table @samp
|
|
|
|
@item mmx
|
|
|
|
@item mmxext
|
|
|
|
@item sse
|
|
|
|
@item sse2
|
|
|
|
@item sse2slow
|
|
|
|
@item sse3
|
|
|
|
@item sse3slow
|
|
|
|
@item ssse3
|
|
|
|
@item atom
|
|
|
|
@item sse4.1
|
|
|
|
@item sse4.2
|
|
|
|
@item avx
|
2015-04-11 01:51:11 +02:00
|
|
|
@item avx2
|
2013-03-30 19:41:45 +01:00
|
|
|
@item xop
|
2015-04-11 01:51:11 +02:00
|
|
|
@item fma3
|
2013-03-30 19:41:45 +01:00
|
|
|
@item fma4
|
|
|
|
@item 3dnow
|
|
|
|
@item 3dnowext
|
2015-04-11 01:51:11 +02:00
|
|
|
@item bmi1
|
|
|
|
@item bmi2
|
2013-03-30 19:41:45 +01:00
|
|
|
@item cmov
|
|
|
|
@end table
|
|
|
|
@item ARM
|
|
|
|
@table @samp
|
|
|
|
@item armv5te
|
|
|
|
@item armv6
|
|
|
|
@item armv6t2
|
|
|
|
@item vfp
|
|
|
|
@item vfpv3
|
|
|
|
@item neon
|
2015-04-11 01:51:35 +02:00
|
|
|
@item setend
|
2013-03-30 19:41:45 +01:00
|
|
|
@end table
|
2015-04-11 01:52:29 +02:00
|
|
|
@item AArch64
|
|
|
|
@table @samp
|
|
|
|
@item armv8
|
|
|
|
@item vfp
|
|
|
|
@item neon
|
|
|
|
@end table
|
2013-03-30 19:41:45 +01:00
|
|
|
@item PowerPC
|
|
|
|
@table @samp
|
|
|
|
@item altivec
|
|
|
|
@end table
|
|
|
|
@item Specific Processors
|
|
|
|
@table @samp
|
|
|
|
@item pentium2
|
|
|
|
@item pentium3
|
|
|
|
@item pentium4
|
|
|
|
@item k6
|
|
|
|
@item k62
|
|
|
|
@item athlon
|
|
|
|
@item athlonxp
|
|
|
|
@item k8
|
|
|
|
@end table
|
|
|
|
@end table
|
2010-02-21 11:56:38 +01:00
|
|
|
@end table
|
2011-07-17 14:54:20 +02:00
|
|
|
|
|
|
|
@section AVOptions
|
|
|
|
|
2011-07-28 17:43:24 +02:00
|
|
|
These options are provided directly by the libavformat, libavdevice and
|
|
|
|
libavcodec libraries. To see the list of available AVOptions, use the
|
2011-07-17 14:54:20 +02:00
|
|
|
@option{-help} option. They are separated into two categories:
|
|
|
|
@table @option
|
|
|
|
@item generic
|
2011-12-08 17:39:28 +01:00
|
|
|
These options can be set for any container, codec or device. Generic options
|
|
|
|
are listed under AVFormatContext options for containers/devices and under
|
2011-07-28 17:43:24 +02:00
|
|
|
AVCodecContext options for codecs.
|
2011-07-17 14:54:20 +02:00
|
|
|
@item private
|
2011-07-28 17:43:24 +02:00
|
|
|
These options are specific to the given container, device or codec. Private
|
|
|
|
options are listed under their corresponding containers/devices/codecs.
|
2011-07-17 14:54:20 +02:00
|
|
|
@end table
|
|
|
|
|
|
|
|
For example to write an ID3v2.3 header instead of a default ID3v2.4 to
|
|
|
|
an MP3 file, use the @option{id3v2_version} private option of the MP3
|
|
|
|
muxer:
|
|
|
|
@example
|
|
|
|
ffmpeg -i input.flac -id3v2_version 3 out.mp3
|
|
|
|
@end example
|
|
|
|
|
2013-09-21 10:19:21 +02:00
|
|
|
All codec AVOptions are per-stream, and thus a stream specifier
|
|
|
|
should be attached to them.
|
2011-07-28 16:47:38 +02:00
|
|
|
|
2013-09-21 10:19:21 +02:00
|
|
|
Note: the @option{-nooption} syntax cannot be used for boolean
|
|
|
|
AVOptions, use @option{-option 0}/@option{-option 1}.
|
2011-07-28 16:47:38 +02:00
|
|
|
|
2013-09-21 10:19:21 +02:00
|
|
|
Note: the old undocumented way of specifying per-stream AVOptions by
|
|
|
|
prepending v/a/s to the options name is now obsolete and will be
|
|
|
|
removed soon.
|