<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd"> <html> <!-- Created on May, 15 2011 by texi2html 1.78 --> <!-- Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author) Karl Berry <karl@freefriends.org> Olaf Bachmann <obachman@mathematik.uni-kl.de> and many others. Maintained by: Many creative people. Send bugs and suggestions to <texi2html-bug@nongnu.org> --> <head> <title>FFprobe Documentation</title> <meta name="description" content="FFprobe Documentation"> <meta name="keywords" content="FFprobe Documentation"> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="texi2html 1.78"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <style type="text/css"> <!-- a.summary-letter {text-decoration: none} pre.display {font-family: serif} pre.format {font-family: serif} pre.menu-comment {font-family: serif} pre.menu-preformatted {font-family: serif} pre.smalldisplay {font-family: serif; font-size: smaller} pre.smallexample {font-size: smaller} pre.smallformat {font-family: serif; font-size: smaller} pre.smalllisp {font-size: smaller} span.roman {font-family:serif; font-weight:normal;} span.sansserif {font-family:sans-serif; font-weight:normal;} ul.toc {list-style: none} --> </style> </head> <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000"> <a name="SEC1"></a> <table cellpadding="1" cellspacing="1" border="0"> <tr><td valign="middle" align="left">[ < ]</td> <td valign="middle" align="left">[<a href="#SEC2" title="Next section in reading order"> > </a>]</td> <td valign="middle" align="left"> </td> <td valign="middle" align="left">[ << ]</td> <td valign="middle" align="left">[ Up ]</td> <td valign="middle" align="left">[<a href="#SEC2" title="Next chapter"> >> </a>]</td> <td valign="middle" align="left"> </td> <td valign="middle" align="left"> </td> <td valign="middle" align="left"> </td> <td valign="middle" align="left"> </td> <td valign="middle" align="left">[<a href="#SEC1" title="Cover (top) of document">Top</a>]</td> <td valign="middle" align="left">[Contents]</td> <td valign="middle" align="left">[Index]</td> <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td> </tr></table> <h1 class="chapter"> 1. Introduction </h1> <p>FFprobe gathers information from multimedia streams and prints it in human- and machine-readable fashion. </p> <p>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. </p> <p>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. </p> <p>FFprobe may be employed both as a standalone application or in combination with a textual filter, which may perform more sophisticated processing, e.g. statistical processing or plotting. </p> <p>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. </p> <p>FFprobe output is designed to be easily parsable by a textual filter, and consists of one or more sections of the form: </p><table><tr><td> </td><td><pre class="example">[SECTION] key1=val1 ... keyN=valN [/SECTION] </pre></td></tr></table> <p>Metadata tags stored in the container or in the streams are recognized and printed in the corresponding “FORMAT” or “STREAM” section, and are prefixed by the string “TAG:”. </p> <hr size="6"> <a name="SEC2"></a> <table cellpadding="1" cellspacing="1" border="0"> <tr><td valign="middle" align="left">[<a href="#SEC1" title="Previous section in reading order"> < </a>]</td> <td valign="middle" align="left">[<a href="#SEC3" title="Next section in reading order"> > </a>]</td> <td valign="middle" align="left"> </td> <td valign="middle" align="left">[<a href="#SEC1" title="Beginning of this chapter or previous chapter"> << </a>]</td> <td valign="middle" align="left">[<a href="#SEC1" title="Up section"> Up </a>]</td> <td valign="middle" align="left">[ >> ]</td> <td valign="middle" align="left"> </td> <td valign="middle" align="left"> </td> <td valign="middle" align="left"> </td> <td valign="middle" align="left"> </td> <td valign="middle" align="left">[<a href="#SEC1" title="Cover (top) of document">Top</a>]</td> <td valign="middle" align="left">[Contents]</td> <td valign="middle" align="left">[Index]</td> <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td> </tr></table> <h1 class="chapter"> 2. Invocation </h1> <hr size="6"> <a name="SEC3"></a> <table cellpadding="1" cellspacing="1" border="0"> <tr><td valign="middle" align="left">[<a href="#SEC2" title="Previous section in reading order"> < </a>]</td> <td valign="middle" align="left">[<a href="#SEC4" title="Next section in reading order"> > </a>]</td> <td valign="middle" align="left"> </td> <td valign="middle" align="left">[<a href="#SEC2" title="Beginning of this chapter or previous chapter"> << </a>]</td> <td valign="middle" align="left">[<a href="#SEC2" title="Up section"> Up </a>]</td> <td valign="middle" align="left">[ >> ]</td> <td valign="middle" align="left"> </td> <td valign="middle" align="left"> </td> <td valign="middle" align="left"> </td> <td valign="middle" align="left"> </td> <td valign="middle" align="left">[<a href="#SEC1" title="Cover (top) of document">Top</a>]</td> <td valign="middle" align="left">[Contents]</td> <td valign="middle" align="left">[Index]</td> <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td> </tr></table> <h2 class="section"> 2.1 Syntax </h2> <p>The generic syntax is: </p> <table><tr><td> </td><td><pre class="example">ffprobe [options] [‘<tt>input_file</tt>’] </pre></td></tr></table> <hr size="6"> <a name="SEC4"></a> <table cellpadding="1" cellspacing="1" border="0"> <tr><td valign="middle" align="left">[<a href="#SEC3" title="Previous section in reading order"> < </a>]</td> <td valign="middle" align="left">[<a href="#SEC5" title="Next section in reading order"> > </a>]</td> <td valign="middle" align="left"> </td> <td valign="middle" align="left">[<a href="#SEC2" title="Beginning of this chapter or previous chapter"> << </a>]</td> <td valign="middle" align="left">[<a href="#SEC2" title="Up section"> Up </a>]</td> <td valign="middle" align="left">[ >> ]</td> <td valign="middle" align="left"> </td> <td valign="middle" align="left"> </td> <td valign="middle" align="left"> </td> <td valign="middle" align="left"> </td> <td valign="middle" align="left">[<a href="#SEC1" title="Cover (top) of document">Top</a>]</td> <td valign="middle" align="left">[Contents]</td> <td valign="middle" align="left">[Index]</td> <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td> </tr></table> <h2 class="section"> 2.2 Generic options </h2> <p>These options are shared amongst the ff* tools. </p> <dl compact="compact"> <dt> ‘<samp>-L</samp>’</dt> <dd><p>Show license. </p> </dd> <dt> ‘<samp>-h, -?, -help, --help</samp>’</dt> <dd><p>Show help. </p> </dd> <dt> ‘<samp>-version</samp>’</dt> <dd><p>Show version. </p> </dd> <dt> ‘<samp>-formats</samp>’</dt> <dd><p>Show available formats. </p> <p>The fields preceding the format names have the following meanings: </p><dl compact="compact"> <dt> ‘<samp>D</samp>’</dt> <dd><p>Decoding available </p></dd> <dt> ‘<samp>E</samp>’</dt> <dd><p>Encoding available </p></dd> </dl> </dd> <dt> ‘<samp>-codecs</samp>’</dt> <dd><p>Show available codecs. </p> <p>The fields preceding the codec names have the following meanings: </p><dl compact="compact"> <dt> ‘<samp>D</samp>’</dt> <dd><p>Decoding available </p></dd> <dt> ‘<samp>E</samp>’</dt> <dd><p>Encoding available </p></dd> <dt> ‘<samp>V/A/S</samp>’</dt> <dd><p>Video/audio/subtitle codec </p></dd> <dt> ‘<samp>S</samp>’</dt> <dd><p>Codec supports slices </p></dd> <dt> ‘<samp>D</samp>’</dt> <dd><p>Codec supports direct rendering </p></dd> <dt> ‘<samp>T</samp>’</dt> <dd><p>Codec can handle input truncated at random locations instead of only at frame boundaries </p></dd> </dl> </dd> <dt> ‘<samp>-bsfs</samp>’</dt> <dd><p>Show available bitstream filters. </p> </dd> <dt> ‘<samp>-protocols</samp>’</dt> <dd><p>Show available protocols. </p> </dd> <dt> ‘<samp>-filters</samp>’</dt> <dd><p>Show available libavfilter filters. </p> </dd> <dt> ‘<samp>-pix_fmts</samp>’</dt> <dd><p>Show available pixel formats. </p> </dd> <dt> ‘<samp>-loglevel <var>loglevel</var></samp>’</dt> <dd><p>Set the logging level used by the library. <var>loglevel</var> is a number or a string containing one of the following values: </p><dl compact="compact"> <dt> ‘<samp>quiet</samp>’</dt> <dt> ‘<samp>panic</samp>’</dt> <dt> ‘<samp>fatal</samp>’</dt> <dt> ‘<samp>error</samp>’</dt> <dt> ‘<samp>warning</samp>’</dt> <dt> ‘<samp>info</samp>’</dt> <dt> ‘<samp>verbose</samp>’</dt> <dt> ‘<samp>debug</samp>’</dt> </dl> </dd> </dl> <hr size="6"> <a name="SEC5"></a> <table cellpadding="1" cellspacing="1" border="0"> <tr><td valign="middle" align="left">[<a href="#SEC4" title="Previous section in reading order"> < </a>]</td> <td valign="middle" align="left">[ > ]</td> <td valign="middle" align="left"> </td> <td valign="middle" align="left">[<a href="#SEC2" title="Beginning of this chapter or previous chapter"> << </a>]</td> <td valign="middle" align="left">[<a href="#SEC2" title="Up section"> Up </a>]</td> <td valign="middle" align="left">[ >> ]</td> <td valign="middle" align="left"> </td> <td valign="middle" align="left"> </td> <td valign="middle" align="left"> </td> <td valign="middle" align="left"> </td> <td valign="middle" align="left">[<a href="#SEC1" title="Cover (top) of document">Top</a>]</td> <td valign="middle" align="left">[Contents]</td> <td valign="middle" align="left">[Index]</td> <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td> </tr></table> <h2 class="section"> 2.3 Main options </h2> <dl compact="compact"> <dt> ‘<samp>-convert_tags</samp>’</dt> <dd><p>Convert the tag names in the format container to the generic FFmpeg tag names. </p> </dd> <dt> ‘<samp>-f <var>format</var></samp>’</dt> <dd><p>Force format to use. </p> </dd> <dt> ‘<samp>-unit</samp>’</dt> <dd><p>Show the unit of the displayed values. </p> </dd> <dt> ‘<samp>-prefix</samp>’</dt> <dd><p>Show a SI prefixes of the displayed values. Unless “-byte_binary_prefix” option is used all the prefix are decimal. </p> </dd> <dt> ‘<samp>-byte_binary_prefix</samp>’</dt> <dd><p>Force the use of binary prefixes for byte values. </p> </dd> <dt> ‘<samp>-sexagesimal</samp>’</dt> <dd><p>Use sexagesimal format HH:MM:SS.MICROSECONDS for time values. </p> </dd> <dt> ‘<samp>-pretty</samp>’</dt> <dd><p>Prettify the format of the displayed values, it corresponds to the options “-unit -prefix -byte_binary_prefix -sexagesimal”. </p> </dd> <dt> ‘<samp>-show_format</samp>’</dt> <dd><p>Show information about the container format of the input multimedia stream. </p> <p>All the container format information is printed within a section with name “FORMAT”. </p> </dd> <dt> ‘<samp>-show_streams</samp>’</dt> <dd><p>Show information about each media stream contained in the input multimedia stream. </p> <p>Each media stream information is printed within a dedicated section with name “STREAM”. </p> </dd> </dl> <hr size="6"> <a name="SEC_About"></a> <table cellpadding="1" cellspacing="1" border="0"> <tr><td valign="middle" align="left">[<a href="#SEC1" title="Cover (top) of document">Top</a>]</td> <td valign="middle" align="left">[Contents]</td> <td valign="middle" align="left">[Index]</td> <td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ? </a>]</td> </tr></table> <h1>About This Document</h1> <p> This document was generated on <i>May, 15 2011</i> using <a href="http://www.nongnu.org/texi2html/"><i>texi2html 1.78</i></a>. </p> <p> The buttons in the navigation panels have the following meaning: </p> <table border="1"> <tr> <th> Button </th> <th> Name </th> <th> Go to </th> <th> From 1.2.3 go to</th> </tr> <tr> <td align="center"> [ < ] </td> <td align="center">Back</td> <td>Previous section in reading order</td> <td>1.2.2</td> </tr> <tr> <td align="center"> [ > ] </td> <td align="center">Forward</td> <td>Next section in reading order</td> <td>1.2.4</td> </tr> <tr> <td align="center"> [ << ] </td> <td align="center">FastBack</td> <td>Beginning of this chapter or previous chapter</td> <td>1</td> </tr> <tr> <td align="center"> [ Up ] </td> <td align="center">Up</td> <td>Up section</td> <td>1.2</td> </tr> <tr> <td align="center"> [ >> ] </td> <td align="center">FastForward</td> <td>Next chapter</td> <td>2</td> </tr> <tr> <td align="center"> [Top] </td> <td align="center">Top</td> <td>Cover (top) of document</td> <td> </td> </tr> <tr> <td align="center"> [Contents] </td> <td align="center">Contents</td> <td>Table of contents</td> <td> </td> </tr> <tr> <td align="center"> [Index] </td> <td align="center">Index</td> <td>Index</td> <td> </td> </tr> <tr> <td align="center"> [ ? ] </td> <td align="center">About</td> <td>About (help)</td> <td> </td> </tr> </table> <p> where the <strong> Example </strong> assumes that the current position is at <strong> Subsubsection One-Two-Three </strong> of a document of the following structure: </p> <ul> <li> 1. Section One <ul> <li>1.1 Subsection One-One <ul> <li>...</li> </ul> </li> <li>1.2 Subsection One-Two <ul> <li>1.2.1 Subsubsection One-Two-One</li> <li>1.2.2 Subsubsection One-Two-Two</li> <li>1.2.3 Subsubsection One-Two-Three <strong><== Current Position </strong></li> <li>1.2.4 Subsubsection One-Two-Four</li> </ul> </li> <li>1.3 Subsection One-Three <ul> <li>...</li> </ul> </li> <li>1.4 Subsection One-Four</li> </ul> </li> </ul> <hr size="1"> <p> <font size="-1"> This document was generated on <i>May, 15 2011</i> using <a href="http://www.nongnu.org/texi2html/"><i>texi2html 1.78</i></a>. </font> <br> </p> </body> </html>