2010-02-21 11:43:01 +00:00
|
|
|
\input texinfo @c -*- texinfo -*-
|
|
|
|
|
2011-04-23 13:19:17 +00:00
|
|
|
@settitle ffprobe Documentation
|
2010-02-21 11:43:01 +00:00
|
|
|
@titlepage
|
2011-04-23 13:19:17 +00:00
|
|
|
@center @titlefont{ffprobe Documentation}
|
2010-02-21 11:43:01 +00:00
|
|
|
@end titlepage
|
|
|
|
|
2011-01-29 12:24:13 +00:00
|
|
|
@top
|
|
|
|
|
|
|
|
@contents
|
|
|
|
|
2010-06-08 22:32:29 +00:00
|
|
|
@chapter Synopsis
|
|
|
|
|
|
|
|
The generic syntax is:
|
|
|
|
|
|
|
|
@example
|
|
|
|
@c man begin SYNOPSIS
|
|
|
|
ffprobe [options] [@file{input_file}]
|
|
|
|
@c man end
|
|
|
|
@end example
|
|
|
|
|
2010-06-03 21:23:05 +00:00
|
|
|
@chapter Description
|
2010-02-21 11:43:01 +00:00
|
|
|
@c man begin DESCRIPTION
|
|
|
|
|
2011-04-23 14:40:01 +00:00
|
|
|
ffprobe gathers information from multimedia streams and prints it in
|
2010-02-21 11:43:01 +00:00
|
|
|
human- and machine-readable fashion.
|
|
|
|
|
|
|
|
For example it can be used to check the format of the container used
|
|
|
|
by a multimedia stream and the format and type of each media stream
|
|
|
|
contained in it.
|
|
|
|
|
|
|
|
If a filename is specified in input, ffprobe will try to open and
|
|
|
|
probe the file content. If the file cannot be opened or recognized as
|
|
|
|
a multimedia file, a positive exit code is returned.
|
|
|
|
|
2011-04-23 14:40:01 +00:00
|
|
|
ffprobe may be employed both as a standalone application or in
|
2010-02-21 11:43:01 +00:00
|
|
|
combination with a textual filter, which may perform more
|
|
|
|
sophisticated processing, e.g. statistical processing or plotting.
|
|
|
|
|
|
|
|
Options are used to list some of the formats supported by ffprobe or
|
|
|
|
for specifying which information to display, and for setting how
|
|
|
|
ffprobe will show it.
|
|
|
|
|
2011-04-23 14:40:01 +00:00
|
|
|
ffprobe output is designed to be easily parsable by a textual filter,
|
2010-02-21 11:43:01 +00:00
|
|
|
and consists of one or more sections of the form:
|
|
|
|
@example
|
|
|
|
[SECTION]
|
|
|
|
key1=val1
|
|
|
|
...
|
|
|
|
keyN=valN
|
|
|
|
[/SECTION]
|
|
|
|
@end example
|
|
|
|
|
|
|
|
Metadata tags stored in the container or in the streams are recognized
|
2010-09-07 09:10:50 +00:00
|
|
|
and printed in the corresponding "FORMAT" or "STREAM" section, and
|
|
|
|
are prefixed by the string "TAG:".
|
2010-02-21 11:43:01 +00:00
|
|
|
|
|
|
|
@c man end
|
|
|
|
|
2010-06-08 22:32:29 +00:00
|
|
|
@chapter Options
|
2010-02-21 11:43:01 +00:00
|
|
|
@c man begin OPTIONS
|
|
|
|
|
2011-09-02 20:17:38 +00:00
|
|
|
@include avtools-common-opts.texi
|
2010-02-21 11:43:01 +00:00
|
|
|
|
|
|
|
@section Main options
|
|
|
|
|
|
|
|
@table @option
|
2010-02-21 18:33:24 +00:00
|
|
|
|
|
|
|
@item -f @var{format}
|
|
|
|
Force format to use.
|
|
|
|
|
2010-02-21 11:43:01 +00:00
|
|
|
@item -unit
|
|
|
|
Show the unit of the displayed values.
|
|
|
|
|
|
|
|
@item -prefix
|
2010-09-07 09:10:56 +00:00
|
|
|
Use SI prefixes for the displayed values.
|
|
|
|
Unless the "-byte_binary_prefix" option is used all the prefixes
|
2010-02-21 11:43:01 +00:00
|
|
|
are decimal.
|
|
|
|
|
|
|
|
@item -byte_binary_prefix
|
|
|
|
Force the use of binary prefixes for byte values.
|
|
|
|
|
|
|
|
@item -sexagesimal
|
|
|
|
Use sexagesimal format HH:MM:SS.MICROSECONDS for time values.
|
|
|
|
|
|
|
|
@item -pretty
|
|
|
|
Prettify the format of the displayed values, it corresponds to the
|
2010-09-07 09:10:50 +00:00
|
|
|
options "-unit -prefix -byte_binary_prefix -sexagesimal".
|
2010-02-21 11:43:01 +00:00
|
|
|
|
|
|
|
@item -show_format
|
|
|
|
Show information about the container format of the input multimedia
|
|
|
|
stream.
|
|
|
|
|
|
|
|
All the container format information is printed within a section with
|
2010-09-07 09:10:50 +00:00
|
|
|
name "FORMAT".
|
2010-02-21 11:43:01 +00:00
|
|
|
|
2010-07-28 23:17:59 +00:00
|
|
|
@item -show_packets
|
|
|
|
Show information about each packet contained in the input multimedia
|
|
|
|
stream.
|
|
|
|
|
|
|
|
The information for each single packet is printed within a dedicated
|
2010-09-07 09:10:50 +00:00
|
|
|
section with name "PACKET".
|
2010-07-28 23:17:59 +00:00
|
|
|
|
2010-02-21 11:43:01 +00:00
|
|
|
@item -show_streams
|
|
|
|
Show information about each media stream contained in the input
|
|
|
|
multimedia stream.
|
|
|
|
|
|
|
|
Each media stream information is printed within a dedicated section
|
2010-09-07 09:10:50 +00:00
|
|
|
with name "STREAM".
|
2010-02-21 11:43:01 +00:00
|
|
|
|
2011-06-04 22:09:04 +00:00
|
|
|
@item -i @var{input_file}
|
|
|
|
Read @var{input_file}.
|
|
|
|
|
2010-02-21 11:43:01 +00:00
|
|
|
@end table
|
|
|
|
@c man end
|
|
|
|
|
2011-05-19 18:34:56 +00:00
|
|
|
@include decoders.texi
|
2011-01-09 10:22:21 +00:00
|
|
|
@include demuxers.texi
|
2010-07-31 15:45:29 +00:00
|
|
|
@include protocols.texi
|
2010-07-27 13:10:59 +00:00
|
|
|
@include indevs.texi
|
|
|
|
|
2010-02-21 11:43:01 +00:00
|
|
|
@ignore
|
|
|
|
|
|
|
|
@setfilename ffprobe
|
2011-04-23 13:19:17 +00:00
|
|
|
@settitle ffprobe media prober
|
2010-02-21 11:43:01 +00:00
|
|
|
|
|
|
|
@c man begin SEEALSO
|
2011-03-17 15:55:58 +00:00
|
|
|
ffmpeg(1), ffplay(1), ffserver(1) and the FFmpeg HTML documentation
|
2010-02-21 11:43:01 +00:00
|
|
|
@c man end
|
|
|
|
|
2010-06-05 16:21:17 +00:00
|
|
|
@c man begin AUTHORS
|
2011-03-17 15:55:58 +00:00
|
|
|
The FFmpeg developers
|
2010-06-05 16:21:17 +00:00
|
|
|
@c man end
|
|
|
|
|
2010-02-21 11:43:01 +00:00
|
|
|
@end ignore
|
|
|
|
|
|
|
|
@bye
|