gitadmin
/
tuoheng_airport_stream_discard_20240715
Watch 1
Star 0
Fork 0
Code Issues 0 Pull Requests 0 Releases 0 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
9 Commits
3 Branches
Branch: release
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'release'
${ noResults }
tuoheng_airport_stream_disc.../ffmpeg/doc/ffprobe.html

1220 lines
50KB
Raw Permalink Blame History 

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

  2. <html>

  3. <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->

  4.   <head>

  5.     <meta charset="utf-8">

  6.     <title>

  7.       ffprobe Documentation

  8.     </title>

  9.     <meta name="viewport" content="width=device-width,initial-scale=1.0">

  10.     <link rel="stylesheet" type="text/css" href="bootstrap.min.css">

  11.     <link rel="stylesheet" type="text/css" href="style.min.css">

  12.   </head>

  13.   <body>

  14.     <div class="container">

  15.       <h1>

  16.       ffprobe Documentation

  17.       </h1>

  18. <div align="center">

  19. </div>

  20. 

  21. 

  22. <a name="SEC_Top"></a>

  23. 

  24. <div class="Contents_element" id="SEC_Contents">

  25. <h2 class="contents-heading">Table of Contents</h2>

  26. 

  27. <div class="contents">

  28. 

  29. <ul class="no-bullet">

  30.   <li><a id="toc-Synopsis" href="#Synopsis">1 Synopsis</a></li>

  31.   <li><a id="toc-Description" href="#Description">2 Description</a></li>

  32.   <li><a id="toc-Options" href="#Options">3 Options</a>

  33.   <ul class="no-bullet">

  34.     <li><a id="toc-Stream-specifiers-1" href="#Stream-specifiers-1">3.1 Stream specifiers</a></li>

  35.     <li><a id="toc-Generic-options" href="#Generic-options">3.2 Generic options</a></li>

  36.     <li><a id="toc-AVOptions" href="#AVOptions">3.3 AVOptions</a></li>

  37.     <li><a id="toc-Main-options" href="#Main-options">3.4 Main options</a></li>

  38.   </ul></li>

  39.   <li><a id="toc-Writers" href="#Writers">4 Writers</a>

  40.   <ul class="no-bullet">

  41.     <li><a id="toc-default" href="#default">4.1 default</a></li>

  42.     <li><a id="toc-compact_002c-csv" href="#compact_002c-csv">4.2 compact, csv</a></li>

  43.     <li><a id="toc-flat" href="#flat">4.3 flat</a></li>

  44.     <li><a id="toc-ini" href="#ini">4.4 ini</a></li>

  45.     <li><a id="toc-json" href="#json">4.5 json</a></li>

  46.     <li><a id="toc-xml" href="#xml">4.6 xml</a></li>

  47.   </ul></li>

  48.   <li><a id="toc-Timecode" href="#Timecode">5 Timecode</a></li>

  49.   <li><a id="toc-See-Also" href="#See-Also">6 See Also</a></li>

  50.   <li><a id="toc-Authors" href="#Authors">7 Authors</a></li>

  51. </ul>

  52. </div>

  53. </div>

  54. 

  55. <a name="Synopsis"></a>

  56. <h2 class="chapter">1 Synopsis<span class="pull-right"><a class="anchor hidden-xs" href="#Synopsis" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Synopsis" aria-hidden="true">TOC</a></span></h2>

  57. 

  58. <p>ffprobe [<var>options</var>] <samp>input_url</samp>

  59. </p>

  60. <a name="Description"></a>

  61. <h2 class="chapter">2 Description<span class="pull-right"><a class="anchor hidden-xs" href="#Description" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Description" aria-hidden="true">TOC</a></span></h2>

  62. 

  63. <p>ffprobe gathers information from multimedia streams and prints it in

  64. human- and machine-readable fashion.

  65. </p>

  66. <p>For example it can be used to check the format of the container used

  67. by a multimedia stream and the format and type of each media stream

  68. contained in it.

  69. </p>

  70. <p>If a url is specified in input, ffprobe will try to open and

  71. probe the url content. If the url cannot be opened or recognized as

  72. a multimedia file, a positive exit code is returned.

  73. </p>

  74. <p>If no output is specified as output with <samp>o</samp> ffprobe will write

  75. to stdout.

  76. </p>

  77. <p>ffprobe may be employed both as a standalone application or in

  78. combination with a textual filter, which may perform more

  79. sophisticated processing, e.g. statistical processing or plotting.

  80. </p>

  81. <p>Options are used to list some of the formats supported by ffprobe or

  82. for specifying which information to display, and for setting how

  83. ffprobe will show it.

  84. </p>

  85. <p>ffprobe output is designed to be easily parsable by a textual filter,

  86. and consists of one or more sections of a form defined by the selected

  87. writer, which is specified by the <samp>print_format</samp> option.

  88. </p>

  89. <p>Sections may contain other nested sections, and are identified by a

  90. name (which may be shared by other sections), and an unique

  91. name. See the output of <samp>sections</samp>.

  92. </p>

  93. <p>Metadata tags stored in the container or in the streams are recognized

  94. and printed in the corresponding &quot;FORMAT&quot;, &quot;STREAM&quot; or &quot;PROGRAM_STREAM&quot;

  95. section.

  96. </p>

  97. 

  98. <a name="Options"></a>

  99. <h2 class="chapter">3 Options<span class="pull-right"><a class="anchor hidden-xs" href="#Options" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Options" aria-hidden="true">TOC</a></span></h2>

  100. 

  101. <p>All the numerical options, if not specified otherwise, accept a string

  102. representing a number as input, which may be followed by one of the SI

  103. unit prefixes, for example: &rsquo;K&rsquo;, &rsquo;M&rsquo;, or &rsquo;G&rsquo;.

  104. </p>

  105. <p>If &rsquo;i&rsquo; is appended to the SI unit prefix, the complete prefix will be

  106. interpreted as a unit prefix for binary multiples, which are based on

  107. powers of 1024 instead of powers of 1000. Appending &rsquo;B&rsquo; to the SI unit

  108. prefix multiplies the value by 8. This allows using, for example:

  109. &rsquo;KB&rsquo;, &rsquo;MiB&rsquo;, &rsquo;G&rsquo; and &rsquo;B&rsquo; as number suffixes.

  110. </p>

  111. <p>Options which do not take arguments are boolean options, and set the

  112. corresponding value to true. They can be set to false by prefixing

  113. the option name with &quot;no&quot;. For example using &quot;-nofoo&quot;

  114. will set the boolean option with name &quot;foo&quot; to false.

  115. </p>

  116. <span id="Stream-specifiers"></span><a name="Stream-specifiers-1"></a>

  117. <h3 class="section">3.1 Stream specifiers<span class="pull-right"><a class="anchor hidden-xs" href="#Stream-specifiers-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Stream-specifiers-1" aria-hidden="true">TOC</a></span></h3>

  118. <p>Some options are applied per-stream, e.g. bitrate or codec. Stream specifiers

  119. are used to precisely specify which stream(s) a given option belongs to.

  120. </p>

  121. <p>A stream specifier is a string generally appended to the option name and

  122. separated from it by a colon. E.g. <code>-codec:a:1 ac3</code> contains the

  123. <code>a:1</code> stream specifier, which matches the second audio stream. Therefore, it

  124. would select the ac3 codec for the second audio stream.

  125. </p>

  126. <p>A stream specifier can match several streams, so that the option is applied to all

  127. of them. E.g. the stream specifier in <code>-b:a 128k</code> matches all audio

  128. streams.

  129. </p>

  130. <p>An empty stream specifier matches all streams. For example, <code>-codec copy</code>

  131. or <code>-codec: copy</code> would copy all the streams without reencoding.

  132. </p>

  133. <p>Possible forms of stream specifiers are:

  134. </p><dl compact="compact">

  135. <dt><span><samp><var>stream_index</var></samp></span></dt>

  136. <dd><p>Matches the stream with this index. E.g. <code>-threads:1 4</code> would set the

  137. thread count for the second stream to 4. If <var>stream_index</var> is used as an

  138. additional stream specifier (see below), then it selects stream number

  139. <var>stream_index</var> from the matching streams. Stream numbering is based on the

  140. order of the streams as detected by libavformat except when a program ID is

  141. also specified. In this case it is based on the ordering of the streams in the

  142. program.

  143. </p></dd>

  144. <dt><span><samp><var>stream_type</var>[:<var>additional_stream_specifier</var>]</samp></span></dt>

  145. <dd><p><var>stream_type</var> is one of following: &rsquo;v&rsquo; or &rsquo;V&rsquo; for video, &rsquo;a&rsquo; for audio, &rsquo;s&rsquo;

  146. for subtitle, &rsquo;d&rsquo; for data, and &rsquo;t&rsquo; for attachments. &rsquo;v&rsquo; matches all video

  147. streams, &rsquo;V&rsquo; only matches video streams which are not attached pictures, video

  148. thumbnails or cover arts. If <var>additional_stream_specifier</var> is used, then

  149. it matches streams which both have this type and match the

  150. <var>additional_stream_specifier</var>. Otherwise, it matches all streams of the

  151. specified type.

  152. </p></dd>

  153. <dt><span><samp>p:<var>program_id</var>[:<var>additional_stream_specifier</var>]</samp></span></dt>

  154. <dd><p>Matches streams which are in the program with the id <var>program_id</var>. If

  155. <var>additional_stream_specifier</var> is used, then it matches streams which both

  156. are part of the program and match the <var>additional_stream_specifier</var>.

  157. </p>

  158. </dd>

  159. <dt><span><samp>#<var>stream_id</var> or i:<var>stream_id</var></samp></span></dt>

  160. <dd><p>Match the stream by stream id (e.g. PID in MPEG-TS container).

  161. </p></dd>

  162. <dt><span><samp>m:<var>key</var>[:<var>value</var>]</samp></span></dt>

  163. <dd><p>Matches streams with the metadata tag <var>key</var> having the specified value. If

  164. <var>value</var> is not given, matches streams that contain the given tag with any

  165. value.

  166. </p></dd>

  167. <dt><span><samp>u</samp></span></dt>

  168. <dd><p>Matches streams with usable configuration, the codec must be defined and the

  169. essential information such as video dimension or audio sample rate must be present.

  170. </p>

  171. <p>Note that in <code>ffmpeg</code>, matching by metadata will only work properly for

  172. input files.

  173. </p></dd>

  174. </dl>

  175. 

  176. <a name="Generic-options"></a>

  177. <h3 class="section">3.2 Generic options<span class="pull-right"><a class="anchor hidden-xs" href="#Generic-options" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Generic-options" aria-hidden="true">TOC</a></span></h3>

  178. 

  179. <p>These options are shared amongst the ff* tools.

  180. </p>

  181. <dl compact="compact">

  182. <dt><span><samp>-L</samp></span></dt>

  183. <dd><p>Show license.

  184. </p>

  185. </dd>

  186. <dt><span><samp>-h, -?, -help, --help [<var>arg</var>]</samp></span></dt>

  187. <dd><p>Show help. An optional parameter may be specified to print help about a specific

  188. item. If no argument is specified, only basic (non advanced) tool

  189. options are shown.

  190. </p>

  191. <p>Possible values of <var>arg</var> are:

  192. </p><dl compact="compact">

  193. <dt><span><samp>long</samp></span></dt>

  194. <dd><p>Print advanced tool options in addition to the basic tool options.

  195. </p>

  196. </dd>

  197. <dt><span><samp>full</samp></span></dt>

  198. <dd><p>Print complete list of options, including shared and private options

  199. for encoders, decoders, demuxers, muxers, filters, etc.

  200. </p>

  201. </dd>

  202. <dt><span><samp>decoder=<var>decoder_name</var></samp></span></dt>

  203. <dd><p>Print detailed information about the decoder named <var>decoder_name</var>. Use the

  204. <samp>-decoders</samp> option to get a list of all decoders.

  205. </p>

  206. </dd>

  207. <dt><span><samp>encoder=<var>encoder_name</var></samp></span></dt>

  208. <dd><p>Print detailed information about the encoder named <var>encoder_name</var>. Use the

  209. <samp>-encoders</samp> option to get a list of all encoders.

  210. </p>

  211. </dd>

  212. <dt><span><samp>demuxer=<var>demuxer_name</var></samp></span></dt>

  213. <dd><p>Print detailed information about the demuxer named <var>demuxer_name</var>. Use the

  214. <samp>-formats</samp> option to get a list of all demuxers and muxers.

  215. </p>

  216. </dd>

  217. <dt><span><samp>muxer=<var>muxer_name</var></samp></span></dt>

  218. <dd><p>Print detailed information about the muxer named <var>muxer_name</var>. Use the

  219. <samp>-formats</samp> option to get a list of all muxers and demuxers.

  220. </p>

  221. </dd>

  222. <dt><span><samp>filter=<var>filter_name</var></samp></span></dt>

  223. <dd><p>Print detailed information about the filter named <var>filter_name</var>. Use the

  224. <samp>-filters</samp> option to get a list of all filters.

  225. </p>

  226. </dd>

  227. <dt><span><samp>bsf=<var>bitstream_filter_name</var></samp></span></dt>

  228. <dd><p>Print detailed information about the bitstream filter named <var>bitstream_filter_name</var>.

  229. Use the <samp>-bsfs</samp> option to get a list of all bitstream filters.

  230. </p>

  231. </dd>

  232. <dt><span><samp>protocol=<var>protocol_name</var></samp></span></dt>

  233. <dd><p>Print detailed information about the protocol named <var>protocol_name</var>.

  234. Use the <samp>-protocols</samp> option to get a list of all protocols.

  235. </p></dd>

  236. </dl>

  237. 

  238. </dd>

  239. <dt><span><samp>-version</samp></span></dt>

  240. <dd><p>Show version.

  241. </p>

  242. </dd>

  243. <dt><span><samp>-buildconf</samp></span></dt>

  244. <dd><p>Show the build configuration, one option per line.

  245. </p>

  246. </dd>

  247. <dt><span><samp>-formats</samp></span></dt>

  248. <dd><p>Show available formats (including devices).

  249. </p>

  250. </dd>

  251. <dt><span><samp>-demuxers</samp></span></dt>

  252. <dd><p>Show available demuxers.

  253. </p>

  254. </dd>

  255. <dt><span><samp>-muxers</samp></span></dt>

  256. <dd><p>Show available muxers.

  257. </p>

  258. </dd>

  259. <dt><span><samp>-devices</samp></span></dt>

  260. <dd><p>Show available devices.

  261. </p>

  262. </dd>

  263. <dt><span><samp>-codecs</samp></span></dt>

  264. <dd><p>Show all codecs known to libavcodec.

  265. </p>

  266. <p>Note that the term &rsquo;codec&rsquo; is used throughout this documentation as a shortcut

  267. for what is more correctly called a media bitstream format.

  268. </p>

  269. </dd>

  270. <dt><span><samp>-decoders</samp></span></dt>

  271. <dd><p>Show available decoders.

  272. </p>

  273. </dd>

  274. <dt><span><samp>-encoders</samp></span></dt>

  275. <dd><p>Show all available encoders.

  276. </p>

  277. </dd>

  278. <dt><span><samp>-bsfs</samp></span></dt>

  279. <dd><p>Show available bitstream filters.

  280. </p>

  281. </dd>

  282. <dt><span><samp>-protocols</samp></span></dt>

  283. <dd><p>Show available protocols.

  284. </p>

  285. </dd>

  286. <dt><span><samp>-filters</samp></span></dt>

  287. <dd><p>Show available libavfilter filters.

  288. </p>

  289. </dd>

  290. <dt><span><samp>-pix_fmts</samp></span></dt>

  291. <dd><p>Show available pixel formats.

  292. </p>

  293. </dd>

  294. <dt><span><samp>-sample_fmts</samp></span></dt>

  295. <dd><p>Show available sample formats.

  296. </p>

  297. </dd>

  298. <dt><span><samp>-layouts</samp></span></dt>

  299. <dd><p>Show channel names and standard channel layouts.

  300. </p>

  301. </dd>

  302. <dt><span><samp>-dispositions</samp></span></dt>

  303. <dd><p>Show stream dispositions.

  304. </p>

  305. </dd>

  306. <dt><span><samp>-colors</samp></span></dt>

  307. <dd><p>Show recognized color names.

  308. </p>

  309. </dd>

  310. <dt><span><samp>-sources <var>device</var>[,<var>opt1</var>=<var>val1</var>[,<var>opt2</var>=<var>val2</var>]...]</samp></span></dt>

  311. <dd><p>Show autodetected sources of the input device.

  312. Some devices may provide system-dependent source names that cannot be autodetected.

  313. The returned list cannot be assumed to be always complete.

  314. </p><div class="example">

  315. <pre class="example">ffmpeg -sources pulse,server=192.168.0.4

  316. </pre></div>

  317. 

  318. </dd>

  319. <dt><span><samp>-sinks <var>device</var>[,<var>opt1</var>=<var>val1</var>[,<var>opt2</var>=<var>val2</var>]...]</samp></span></dt>

  320. <dd><p>Show autodetected sinks of the output device.

  321. Some devices may provide system-dependent sink names that cannot be autodetected.

  322. The returned list cannot be assumed to be always complete.

  323. </p><div class="example">

  324. <pre class="example">ffmpeg -sinks pulse,server=192.168.0.4

  325. </pre></div>

  326. 

  327. </dd>

  328. <dt><span><samp>-loglevel [<var>flags</var>+]<var>loglevel</var> | -v [<var>flags</var>+]<var>loglevel</var></samp></span></dt>

  329. <dd><p>Set logging level and flags used by the library.

  330. </p>

  331. <p>The optional <var>flags</var> prefix can consist of the following values:

  332. </p><dl compact="compact">

  333. <dt><span>&lsquo;<samp>repeat</samp>&rsquo;</span></dt>

  334. <dd><p>Indicates that repeated log output should not be compressed to the first line

  335. and the &quot;Last message repeated n times&quot; line will be omitted.

  336. </p></dd>

  337. <dt><span>&lsquo;<samp>level</samp>&rsquo;</span></dt>

  338. <dd><p>Indicates that log output should add a <code>[level]</code> prefix to each message

  339. line. This can be used as an alternative to log coloring, e.g. when dumping the

  340. log to file.

  341. </p></dd>

  342. </dl>

  343. <p>Flags can also be used alone by adding a &rsquo;+&rsquo;/&rsquo;-&rsquo; prefix to set/reset a single

  344. flag without affecting other <var>flags</var> or changing <var>loglevel</var>. When

  345. setting both <var>flags</var> and <var>loglevel</var>, a &rsquo;+&rsquo; separator is expected

  346. between the last <var>flags</var> value and before <var>loglevel</var>.

  347. </p>

  348. <p><var>loglevel</var> is a string or a number containing one of the following values:

  349. </p><dl compact="compact">

  350. <dt><span>&lsquo;<samp>quiet, -8</samp>&rsquo;</span></dt>

  351. <dd><p>Show nothing at all; be silent.

  352. </p></dd>

  353. <dt><span>&lsquo;<samp>panic, 0</samp>&rsquo;</span></dt>

  354. <dd><p>Only show fatal errors which could lead the process to crash, such as

  355. an assertion failure. This is not currently used for anything.

  356. </p></dd>

  357. <dt><span>&lsquo;<samp>fatal, 8</samp>&rsquo;</span></dt>

  358. <dd><p>Only show fatal errors. These are errors after which the process absolutely

  359. cannot continue.

  360. </p></dd>

  361. <dt><span>&lsquo;<samp>error, 16</samp>&rsquo;</span></dt>

  362. <dd><p>Show all errors, including ones which can be recovered from.

  363. </p></dd>

  364. <dt><span>&lsquo;<samp>warning, 24</samp>&rsquo;</span></dt>

  365. <dd><p>Show all warnings and errors. Any message related to possibly

  366. incorrect or unexpected events will be shown.

  367. </p></dd>

  368. <dt><span>&lsquo;<samp>info, 32</samp>&rsquo;</span></dt>

  369. <dd><p>Show informative messages during processing. This is in addition to

  370. warnings and errors. This is the default value.

  371. </p></dd>

  372. <dt><span>&lsquo;<samp>verbose, 40</samp>&rsquo;</span></dt>

  373. <dd><p>Same as <code>info</code>, except more verbose.

  374. </p></dd>

  375. <dt><span>&lsquo;<samp>debug, 48</samp>&rsquo;</span></dt>

  376. <dd><p>Show everything, including debugging information.

  377. </p></dd>

  378. <dt><span>&lsquo;<samp>trace, 56</samp>&rsquo;</span></dt>

  379. </dl>

  380. 

  381. <p>For example to enable repeated log output, add the <code>level</code> prefix, and set

  382. <var>loglevel</var> to <code>verbose</code>:

  383. </p><div class="example">

  384. <pre class="example">ffmpeg -loglevel repeat+level+verbose -i input output

  385. </pre></div>

  386. <p>Another example that enables repeated log output without affecting current

  387. state of <code>level</code> prefix flag or <var>loglevel</var>:

  388. </p><div class="example">

  389. <pre class="example">ffmpeg [...] -loglevel +repeat

  390. </pre></div>

  391. 

  392. <p>By default the program logs to stderr. If coloring is supported by the

  393. terminal, colors are used to mark errors and warnings. Log coloring

  394. can be disabled setting the environment variable

  395. <code>AV_LOG_FORCE_NOCOLOR</code>, or can be forced setting

  396. the environment variable <code>AV_LOG_FORCE_COLOR</code>.

  397. </p>

  398. </dd>

  399. <dt><span><samp>-report</samp></span></dt>

  400. <dd><p>Dump full command line and log output to a file named

  401. <code><var>program</var>-<var>YYYYMMDD</var>-<var>HHMMSS</var>.log</code> in the current

  402. directory.

  403. This file can be useful for bug reports.

  404. It also implies <code>-loglevel debug</code>.

  405. </p>

  406. <p>Setting the environment variable <code>FFREPORT</code> to any value has the

  407. same effect. If the value is a &rsquo;:&rsquo;-separated key=value sequence, these

  408. options will affect the report; option values must be escaped if they

  409. contain special characters or the options delimiter &rsquo;:&rsquo; (see the

  410. &ldquo;Quoting and escaping&rdquo; section in the ffmpeg-utils manual).

  411. </p>

  412. <p>The following options are recognized:

  413. </p><dl compact="compact">

  414. <dt><span><samp>file</samp></span></dt>

  415. <dd><p>set the file name to use for the report; <code>%p</code> is expanded to the name

  416. of the program, <code>%t</code> is expanded to a timestamp, <code>%%</code> is expanded

  417. to a plain <code>%</code>

  418. </p></dd>

  419. <dt><span><samp>level</samp></span></dt>

  420. <dd><p>set the log verbosity level using a numerical value (see <code>-loglevel</code>).

  421. </p></dd>

  422. </dl>

  423. 

  424. <p>For example, to output a report to a file named <samp>ffreport.log</samp>

  425. using a log level of <code>32</code> (alias for log level <code>info</code>):

  426. </p>

  427. <div class="example">

  428. <pre class="example">FFREPORT=file=ffreport.log:level=32 ffmpeg -i input output

  429. </pre></div>

  430. 

  431. <p>Errors in parsing the environment variable are not fatal, and will not

  432. appear in the report.

  433. </p>

  434. </dd>

  435. <dt><span><samp>-hide_banner</samp></span></dt>

  436. <dd><p>Suppress printing banner.

  437. </p>

  438. <p>All FFmpeg tools will normally show a copyright notice, build options

  439. and library versions. This option can be used to suppress printing

  440. this information.

  441. </p>

  442. </dd>

  443. <dt><span><samp>-cpuflags flags (<em>global</em>)</samp></span></dt>

  444. <dd><p>Allows setting and clearing cpu flags. This option is intended

  445. for testing. Do not use it unless you know what you&rsquo;re doing.

  446. </p><div class="example">

  447. <pre class="example">ffmpeg -cpuflags -sse+mmx ...

  448. ffmpeg -cpuflags mmx ...

  449. ffmpeg -cpuflags 0 ...

  450. </pre></div>

  451. <p>Possible flags for this option are:

  452. </p><dl compact="compact">

  453. <dt><span>&lsquo;<samp>x86</samp>&rsquo;</span></dt>

  454. <dd><dl compact="compact">

  455. <dt><span>&lsquo;<samp>mmx</samp>&rsquo;</span></dt>

  456. <dt><span>&lsquo;<samp>mmxext</samp>&rsquo;</span></dt>

  457. <dt><span>&lsquo;<samp>sse</samp>&rsquo;</span></dt>

  458. <dt><span>&lsquo;<samp>sse2</samp>&rsquo;</span></dt>

  459. <dt><span>&lsquo;<samp>sse2slow</samp>&rsquo;</span></dt>

  460. <dt><span>&lsquo;<samp>sse3</samp>&rsquo;</span></dt>

  461. <dt><span>&lsquo;<samp>sse3slow</samp>&rsquo;</span></dt>

  462. <dt><span>&lsquo;<samp>ssse3</samp>&rsquo;</span></dt>

  463. <dt><span>&lsquo;<samp>atom</samp>&rsquo;</span></dt>

  464. <dt><span>&lsquo;<samp>sse4.1</samp>&rsquo;</span></dt>

  465. <dt><span>&lsquo;<samp>sse4.2</samp>&rsquo;</span></dt>

  466. <dt><span>&lsquo;<samp>avx</samp>&rsquo;</span></dt>

  467. <dt><span>&lsquo;<samp>avx2</samp>&rsquo;</span></dt>

  468. <dt><span>&lsquo;<samp>xop</samp>&rsquo;</span></dt>

  469. <dt><span>&lsquo;<samp>fma3</samp>&rsquo;</span></dt>

  470. <dt><span>&lsquo;<samp>fma4</samp>&rsquo;</span></dt>

  471. <dt><span>&lsquo;<samp>3dnow</samp>&rsquo;</span></dt>

  472. <dt><span>&lsquo;<samp>3dnowext</samp>&rsquo;</span></dt>

  473. <dt><span>&lsquo;<samp>bmi1</samp>&rsquo;</span></dt>

  474. <dt><span>&lsquo;<samp>bmi2</samp>&rsquo;</span></dt>

  475. <dt><span>&lsquo;<samp>cmov</samp>&rsquo;</span></dt>

  476. </dl>

  477. </dd>

  478. <dt><span>&lsquo;<samp>ARM</samp>&rsquo;</span></dt>

  479. <dd><dl compact="compact">

  480. <dt><span>&lsquo;<samp>armv5te</samp>&rsquo;</span></dt>

  481. <dt><span>&lsquo;<samp>armv6</samp>&rsquo;</span></dt>

  482. <dt><span>&lsquo;<samp>armv6t2</samp>&rsquo;</span></dt>

  483. <dt><span>&lsquo;<samp>vfp</samp>&rsquo;</span></dt>

  484. <dt><span>&lsquo;<samp>vfpv3</samp>&rsquo;</span></dt>

  485. <dt><span>&lsquo;<samp>neon</samp>&rsquo;</span></dt>

  486. <dt><span>&lsquo;<samp>setend</samp>&rsquo;</span></dt>

  487. </dl>

  488. </dd>

  489. <dt><span>&lsquo;<samp>AArch64</samp>&rsquo;</span></dt>

  490. <dd><dl compact="compact">

  491. <dt><span>&lsquo;<samp>armv8</samp>&rsquo;</span></dt>

  492. <dt><span>&lsquo;<samp>vfp</samp>&rsquo;</span></dt>

  493. <dt><span>&lsquo;<samp>neon</samp>&rsquo;</span></dt>

  494. </dl>

  495. </dd>

  496. <dt><span>&lsquo;<samp>PowerPC</samp>&rsquo;</span></dt>

  497. <dd><dl compact="compact">

  498. <dt><span>&lsquo;<samp>altivec</samp>&rsquo;</span></dt>

  499. </dl>

  500. </dd>

  501. <dt><span>&lsquo;<samp>Specific Processors</samp>&rsquo;</span></dt>

  502. <dd><dl compact="compact">

  503. <dt><span>&lsquo;<samp>pentium2</samp>&rsquo;</span></dt>

  504. <dt><span>&lsquo;<samp>pentium3</samp>&rsquo;</span></dt>

  505. <dt><span>&lsquo;<samp>pentium4</samp>&rsquo;</span></dt>

  506. <dt><span>&lsquo;<samp>k6</samp>&rsquo;</span></dt>

  507. <dt><span>&lsquo;<samp>k62</samp>&rsquo;</span></dt>

  508. <dt><span>&lsquo;<samp>athlon</samp>&rsquo;</span></dt>

  509. <dt><span>&lsquo;<samp>athlonxp</samp>&rsquo;</span></dt>

  510. <dt><span>&lsquo;<samp>k8</samp>&rsquo;</span></dt>

  511. </dl>

  512. </dd>

  513. </dl>

  514. 

  515. </dd>

  516. <dt><span><samp>-cpucount <var>count</var> (<em>global</em>)</samp></span></dt>

  517. <dd><p>Override detection of CPU count. This option is intended

  518. for testing. Do not use it unless you know what you&rsquo;re doing.

  519. </p><div class="example">

  520. <pre class="example">ffmpeg -cpucount 2

  521. </pre></div>

  522. 

  523. </dd>

  524. <dt><span><samp>-max_alloc <var>bytes</var></samp></span></dt>

  525. <dd><p>Set the maximum size limit for allocating a block on the heap by ffmpeg&rsquo;s

  526. family of malloc functions. Exercise <strong>extreme caution</strong> when using

  527. this option. Don&rsquo;t use if you do not understand the full consequence of doing so.

  528. Default is INT_MAX.

  529. </p></dd>

  530. </dl>

  531. 

  532. <a name="AVOptions"></a>

  533. <h3 class="section">3.3 AVOptions<span class="pull-right"><a class="anchor hidden-xs" href="#AVOptions" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-AVOptions" aria-hidden="true">TOC</a></span></h3>

  534. 

  535. <p>These options are provided directly by the libavformat, libavdevice and

  536. libavcodec libraries. To see the list of available AVOptions, use the

  537. <samp>-help</samp> option. They are separated into two categories:

  538. </p><dl compact="compact">

  539. <dt><span><samp>generic</samp></span></dt>

  540. <dd><p>These options can be set for any container, codec or device. Generic options

  541. are listed under AVFormatContext options for containers/devices and under

  542. AVCodecContext options for codecs.

  543. </p></dd>

  544. <dt><span><samp>private</samp></span></dt>

  545. <dd><p>These options are specific to the given container, device or codec. Private

  546. options are listed under their corresponding containers/devices/codecs.

  547. </p></dd>

  548. </dl>

  549. 

  550. <p>For example to write an ID3v2.3 header instead of a default ID3v2.4 to

  551. an MP3 file, use the <samp>id3v2_version</samp> private option of the MP3

  552. muxer:

  553. </p><div class="example">

  554. <pre class="example">ffmpeg -i input.flac -id3v2_version 3 out.mp3

  555. </pre></div>

  556. 

  557. <p>All codec AVOptions are per-stream, and thus a stream specifier

  558. should be attached to them:

  559. </p><div class="example">

  560. <pre class="example">ffmpeg -i multichannel.mxf -map 0:v:0 -map 0:a:0 -map 0:a:0 -c:a:0 ac3 -b:a:0 640k -ac:a:1 2 -c:a:1 aac -b:2 128k out.mp4

  561. </pre></div>

  562. 

  563. <p>In the above example, a multichannel audio stream is mapped twice for output.

  564. The first instance is encoded with codec ac3 and bitrate 640k.

  565. The second instance is downmixed to 2 channels and encoded with codec aac. A bitrate of 128k is specified for it using

  566. absolute index of the output stream.

  567. </p>

  568. <p>Note: the <samp>-nooption</samp> syntax cannot be used for boolean

  569. AVOptions, use <samp>-option 0</samp>/<samp>-option 1</samp>.

  570. </p>

  571. <p>Note: the old undocumented way of specifying per-stream AVOptions by

  572. prepending v/a/s to the options name is now obsolete and will be

  573. removed soon.

  574. </p>

  575. <a name="Main-options"></a>

  576. <h3 class="section">3.4 Main options<span class="pull-right"><a class="anchor hidden-xs" href="#Main-options" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Main-options" aria-hidden="true">TOC</a></span></h3>

  577. 

  578. <dl compact="compact">

  579. <dt><span><samp>-f <var>format</var></samp></span></dt>

  580. <dd><p>Force format to use.

  581. </p>

  582. </dd>

  583. <dt><span><samp>-unit</samp></span></dt>

  584. <dd><p>Show the unit of the displayed values.

  585. </p>

  586. </dd>

  587. <dt><span><samp>-prefix</samp></span></dt>

  588. <dd><p>Use SI prefixes for the displayed values.

  589. Unless the &quot;-byte_binary_prefix&quot; option is used all the prefixes

  590. are decimal.

  591. </p>

  592. </dd>

  593. <dt><span><samp>-byte_binary_prefix</samp></span></dt>

  594. <dd><p>Force the use of binary prefixes for byte values.

  595. </p>

  596. </dd>

  597. <dt><span><samp>-sexagesimal</samp></span></dt>

  598. <dd><p>Use sexagesimal format HH:MM:SS.MICROSECONDS for time values.

  599. </p>

  600. </dd>

  601. <dt><span><samp>-pretty</samp></span></dt>

  602. <dd><p>Prettify the format of the displayed values, it corresponds to the

  603. options &quot;-unit -prefix -byte_binary_prefix -sexagesimal&quot;.

  604. </p>

  605. </dd>

  606. <dt><span><samp>-of, -print_format <var>writer_name</var>[=<var>writer_options</var>]</samp></span></dt>

  607. <dd><p>Set the output printing format.

  608. </p>

  609. <p><var>writer_name</var> specifies the name of the writer, and

  610. <var>writer_options</var> specifies the options to be passed to the writer.

  611. </p>

  612. <p>For example for printing the output in JSON format, specify:

  613. </p><div class="example">

  614. <pre class="example">-print_format json

  615. </pre></div>

  616. 

  617. <p>For more details on the available output printing formats, see the

  618. Writers section below.

  619. </p>

  620. </dd>

  621. <dt><span><samp>-sections</samp></span></dt>

  622. <dd><p>Print sections structure and section information, and exit. The output

  623. is not meant to be parsed by a machine.

  624. </p>

  625. </dd>

  626. <dt><span><samp>-select_streams <var>stream_specifier</var></samp></span></dt>

  627. <dd><p>Select only the streams specified by <var>stream_specifier</var>. This

  628. option affects only the options related to streams

  629. (e.g. <code>show_streams</code>, <code>show_packets</code>, etc.).

  630. </p>

  631. <p>For example to show only audio streams, you can use the command:

  632. </p><div class="example">

  633. <pre class="example">ffprobe -show_streams -select_streams a INPUT

  634. </pre></div>

  635. 

  636. <p>To show only video packets belonging to the video stream with index 1:

  637. </p><div class="example">

  638. <pre class="example">ffprobe -show_packets -select_streams v:1 INPUT

  639. </pre></div>

  640. 

  641. </dd>

  642. <dt><span><samp>-show_data</samp></span></dt>

  643. <dd><p>Show payload data, as a hexadecimal and ASCII dump. Coupled with

  644. <samp>-show_packets</samp>, it will dump the packets&rsquo; data. Coupled with

  645. <samp>-show_streams</samp>, it will dump the codec extradata.

  646. </p>

  647. <p>The dump is printed as the &quot;data&quot; field. It may contain newlines.

  648. </p>

  649. </dd>

  650. <dt><span><samp>-show_data_hash <var>algorithm</var></samp></span></dt>

  651. <dd><p>Show a hash of payload data, for packets with <samp>-show_packets</samp> and for

  652. codec extradata with <samp>-show_streams</samp>.

  653. </p>

  654. </dd>

  655. <dt><span><samp>-show_error</samp></span></dt>

  656. <dd><p>Show information about the error found when trying to probe the input.

  657. </p>

  658. <p>The error information is printed within a section with name &quot;ERROR&quot;.

  659. </p>

  660. </dd>

  661. <dt><span><samp>-show_format</samp></span></dt>

  662. <dd><p>Show information about the container format of the input multimedia

  663. stream.

  664. </p>

  665. <p>All the container format information is printed within a section with

  666. name &quot;FORMAT&quot;.

  667. </p>

  668. </dd>

  669. <dt><span><samp>-show_format_entry <var>name</var></samp></span></dt>

  670. <dd><p>Like <samp>-show_format</samp>, but only prints the specified entry of the

  671. container format information, rather than all. This option may be given more

  672. than once, then all specified entries will be shown.

  673. </p>

  674. <p>This option is deprecated, use <code>show_entries</code> instead.

  675. </p>

  676. </dd>

  677. <dt><span><samp>-show_entries <var>section_entries</var></samp></span></dt>

  678. <dd><p>Set list of entries to show.

  679. </p>

  680. <p>Entries are specified according to the following

  681. syntax. <var>section_entries</var> contains a list of section entries

  682. separated by <code>:</code>. Each section entry is composed by a section

  683. name (or unique name), optionally followed by a list of entries local

  684. to that section, separated by <code>,</code>.

  685. </p>

  686. <p>If section name is specified but is followed by no <code>=</code>, all

  687. entries are printed to output, together with all the contained

  688. sections. Otherwise only the entries specified in the local section

  689. entries list are printed. In particular, if <code>=</code> is specified but

  690. the list of local entries is empty, then no entries will be shown for

  691. that section.

  692. </p>

  693. <p>Note that the order of specification of the local section entries is

  694. not honored in the output, and the usual display order will be

  695. retained.

  696. </p>

  697. <p>The formal syntax is given by:

  698. </p><div class="example">

  699. <pre class="example"><var>LOCAL_SECTION_ENTRIES</var> ::= <var>SECTION_ENTRY_NAME</var>[,<var>LOCAL_SECTION_ENTRIES</var>]

  700. <var>SECTION_ENTRY</var>         ::= <var>SECTION_NAME</var>[=[<var>LOCAL_SECTION_ENTRIES</var>]]

  701. <var>SECTION_ENTRIES</var>       ::= <var>SECTION_ENTRY</var>[:<var>SECTION_ENTRIES</var>]

  702. </pre></div>

  703. 

  704. <p>For example, to show only the index and type of each stream, and the PTS

  705. time, duration time, and stream index of the packets, you can specify

  706. the argument:

  707. </p><div class="example">

  708. <pre class="example">packet=pts_time,duration_time,stream_index : stream=index,codec_type

  709. </pre></div>

  710. 

  711. <p>To show all the entries in the section &quot;format&quot;, but only the codec

  712. type in the section &quot;stream&quot;, specify the argument:

  713. </p><div class="example">

  714. <pre class="example">format : stream=codec_type

  715. </pre></div>

  716. 

  717. <p>To show all the tags in the stream and format sections:

  718. </p><div class="example">

  719. <pre class="example">stream_tags : format_tags

  720. </pre></div>

  721. 

  722. <p>To show only the <code>title</code> tag (if available) in the stream

  723. sections:

  724. </p><div class="example">

  725. <pre class="example">stream_tags=title

  726. </pre></div>

  727. 

  728. </dd>

  729. <dt><span><samp>-show_packets</samp></span></dt>

  730. <dd><p>Show information about each packet contained in the input multimedia

  731. stream.

  732. </p>

  733. <p>The information for each single packet is printed within a dedicated

  734. section with name &quot;PACKET&quot;.

  735. </p>

  736. </dd>

  737. <dt><span><samp>-show_frames</samp></span></dt>

  738. <dd><p>Show information about each frame and subtitle contained in the input

  739. multimedia stream.

  740. </p>

  741. <p>The information for each single frame is printed within a dedicated

  742. section with name &quot;FRAME&quot; or &quot;SUBTITLE&quot;.

  743. </p>

  744. </dd>

  745. <dt><span><samp>-show_log <var>loglevel</var></samp></span></dt>

  746. <dd><p>Show logging information from the decoder about each frame according to

  747. the value set in <var>loglevel</var>, (see <code>-loglevel</code>). This option requires <code>-show_frames</code>.

  748. </p>

  749. <p>The information for each log message is printed within a dedicated

  750. section with name &quot;LOG&quot;.

  751. </p>

  752. </dd>

  753. <dt><span><samp>-show_streams</samp></span></dt>

  754. <dd><p>Show information about each media stream contained in the input

  755. multimedia stream.

  756. </p>

  757. <p>Each media stream information is printed within a dedicated section

  758. with name &quot;STREAM&quot;.

  759. </p>

  760. </dd>

  761. <dt><span><samp>-show_programs</samp></span></dt>

  762. <dd><p>Show information about programs and their streams contained in the input

  763. multimedia stream.

  764. </p>

  765. <p>Each media stream information is printed within a dedicated section

  766. with name &quot;PROGRAM_STREAM&quot;.

  767. </p>

  768. </dd>

  769. <dt><span><samp>-show_chapters</samp></span></dt>

  770. <dd><p>Show information about chapters stored in the format.

  771. </p>

  772. <p>Each chapter is printed within a dedicated section with name &quot;CHAPTER&quot;.

  773. </p>

  774. </dd>

  775. <dt><span><samp>-count_frames</samp></span></dt>

  776. <dd><p>Count the number of frames per stream and report it in the

  777. corresponding stream section.

  778. </p>

  779. </dd>

  780. <dt><span><samp>-count_packets</samp></span></dt>

  781. <dd><p>Count the number of packets per stream and report it in the

  782. corresponding stream section.

  783. </p>

  784. </dd>

  785. <dt><span><samp>-read_intervals <var>read_intervals</var></samp></span></dt>

  786. <dd>

  787. <p>Read only the specified intervals. <var>read_intervals</var> must be a

  788. sequence of interval specifications separated by &quot;,&quot;.

  789. <code>ffprobe</code> will seek to the interval starting point, and will

  790. continue reading from that.

  791. </p>

  792. <p>Each interval is specified by two optional parts, separated by &quot;%&quot;.

  793. </p>

  794. <p>The first part specifies the interval start position. It is

  795. interpreted as an absolute position, or as a relative offset from the

  796. current position if it is preceded by the &quot;+&quot; character. If this first

  797. part is not specified, no seeking will be performed when reading this

  798. interval.

  799. </p>

  800. <p>The second part specifies the interval end position. It is interpreted

  801. as an absolute position, or as a relative offset from the current

  802. position if it is preceded by the &quot;+&quot; character. If the offset

  803. specification starts with &quot;#&quot;, it is interpreted as the number of

  804. packets to read (not including the flushing packets) from the interval

  805. start. If no second part is specified, the program will read until the

  806. end of the input.

  807. </p>

  808. <p>Note that seeking is not accurate, thus the actual interval start

  809. point may be different from the specified position. Also, when an

  810. interval duration is specified, the absolute end time will be computed

  811. by adding the duration to the interval start point found by seeking

  812. the file, rather than to the specified start value.

  813. </p>

  814. <p>The formal syntax is given by:

  815. </p><div class="example">

  816. <pre class="example"><var>INTERVAL</var>  ::= [<var>START</var>|+<var>START_OFFSET</var>][%[<var>END</var>|+<var>END_OFFSET</var>]]

  817. <var>INTERVALS</var> ::= <var>INTERVAL</var>[,<var>INTERVALS</var>]

  818. </pre></div>

  819. 

  820. <p>A few examples follow.

  821. </p><ul>

  822. <li> Seek to time 10, read packets until 20 seconds after the found seek

  823. point, then seek to position <code>01:30</code> (1 minute and thirty

  824. seconds) and read packets until position <code>01:45</code>.

  825. <div class="example">

  826. <pre class="example">10%+20,01:30%01:45

  827. </pre></div>

  828. 

  829. </li><li> Read only 42 packets after seeking to position <code>01:23</code>:

  830. <div class="example">

  831. <pre class="example">01:23%+#42

  832. </pre></div>

  833. 

  834. </li><li> Read only the first 20 seconds from the start:

  835. <div class="example">

  836. <pre class="example">%+20

  837. </pre></div>

  838. 

  839. </li><li> Read from the start until position <code>02:30</code>:

  840. <div class="example">

  841. <pre class="example">%02:30

  842. </pre></div>

  843. </li></ul>

  844. 

  845. </dd>

  846. <dt><span><samp>-show_private_data, -private</samp></span></dt>

  847. <dd><p>Show private data, that is data depending on the format of the

  848. particular shown element.

  849. This option is enabled by default, but you may need to disable it

  850. for specific uses, for example when creating XSD-compliant XML output.

  851. </p>

  852. </dd>

  853. <dt><span><samp>-show_program_version</samp></span></dt>

  854. <dd><p>Show information related to program version.

  855. </p>

  856. <p>Version information is printed within a section with name

  857. &quot;PROGRAM_VERSION&quot;.

  858. </p>

  859. </dd>

  860. <dt><span><samp>-show_library_versions</samp></span></dt>

  861. <dd><p>Show information related to library versions.

  862. </p>

  863. <p>Version information for each library is printed within a section with

  864. name &quot;LIBRARY_VERSION&quot;.

  865. </p>

  866. </dd>

  867. <dt><span><samp>-show_versions</samp></span></dt>

  868. <dd><p>Show information related to program and library versions. This is the

  869. equivalent of setting both <samp>-show_program_version</samp> and

  870. <samp>-show_library_versions</samp> options.

  871. </p>

  872. </dd>

  873. <dt><span><samp>-show_pixel_formats</samp></span></dt>

  874. <dd><p>Show information about all pixel formats supported by FFmpeg.

  875. </p>

  876. <p>Pixel format information for each format is printed within a section

  877. with name &quot;PIXEL_FORMAT&quot;.

  878. </p>

  879. </dd>

  880. <dt><span><samp>-show_optional_fields <var>value</var></samp></span></dt>

  881. <dd><p>Some writers viz. JSON and XML, omit the printing of fields with invalid or non-applicable values,

  882. while other writers always print them. This option enables one to control this behaviour.

  883. Valid values are <code>always</code>/<code>1</code>, <code>never</code>/<code>0</code> and <code>auto</code>/<code>-1</code>.

  884. Default is <var>auto</var>.

  885. </p>

  886. </dd>

  887. <dt><span><samp>-bitexact</samp></span></dt>

  888. <dd><p>Force bitexact output, useful to produce output which is not dependent

  889. on the specific build.

  890. </p>

  891. </dd>

  892. <dt><span><samp>-i <var>input_url</var></samp></span></dt>

  893. <dd><p>Read <var>input_url</var>.

  894. </p>

  895. </dd>

  896. <dt><span><samp>-o <var>output_url</var></samp></span></dt>

  897. <dd><p>Write output to <var>output_url</var>. If not specified, the output is sent

  898. to stdout.

  899. </p>

  900. </dd>

  901. </dl>

  902. 

  903. <a name="Writers"></a>

  904. <h2 class="chapter">4 Writers<span class="pull-right"><a class="anchor hidden-xs" href="#Writers" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Writers" aria-hidden="true">TOC</a></span></h2>

  905. 

  906. <p>A writer defines the output format adopted by <code>ffprobe</code>, and will be

  907. used for printing all the parts of the output.

  908. </p>

  909. <p>A writer may accept one or more arguments, which specify the options

  910. to adopt. The options are specified as a list of <var>key</var>=<var>value</var>

  911. pairs, separated by &quot;:&quot;.

  912. </p>

  913. <p>All writers support the following options:

  914. </p>

  915. <dl compact="compact">

  916. <dt><span><samp>string_validation, sv</samp></span></dt>

  917. <dd><p>Set string validation mode.

  918. </p>

  919. <p>The following values are accepted.

  920. </p><dl compact="compact">

  921. <dt><span>&lsquo;<samp>fail</samp>&rsquo;</span></dt>

  922. <dd><p>The writer will fail immediately in case an invalid string (UTF-8)

  923. sequence or code point is found in the input. This is especially

  924. useful to validate input metadata.

  925. </p>

  926. </dd>

  927. <dt><span>&lsquo;<samp>ignore</samp>&rsquo;</span></dt>

  928. <dd><p>Any validation error will be ignored. This will result in possibly

  929. broken output, especially with the json or xml writer.

  930. </p>

  931. </dd>

  932. <dt><span>&lsquo;<samp>replace</samp>&rsquo;</span></dt>

  933. <dd><p>The writer will substitute invalid UTF-8 sequences or code points with

  934. the string specified with the <samp>string_validation_replacement</samp>.

  935. </p></dd>

  936. </dl>

  937. 

  938. <p>Default value is &lsquo;<samp>replace</samp>&rsquo;.

  939. </p>

  940. </dd>

  941. <dt><span><samp>string_validation_replacement, svr</samp></span></dt>

  942. <dd><p>Set replacement string to use in case <samp>string_validation</samp> is

  943. set to &lsquo;<samp>replace</samp>&rsquo;.

  944. </p>

  945. <p>In case the option is not specified, the writer will assume the empty

  946. string, that is it will remove the invalid sequences from the input

  947. strings.

  948. </p></dd>

  949. </dl>

  950. 

  951. <p>A description of the currently available writers follows.

  952. </p>

  953. <a name="default"></a>

  954. <h3 class="section">4.1 default<span class="pull-right"><a class="anchor hidden-xs" href="#default" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-default" aria-hidden="true">TOC</a></span></h3>

  955. <p>Default format.

  956. </p>

  957. <p>Print each section in the form:

  958. </p><div class="example">

  959. <pre class="example">[SECTION]

  960. key1=val1

  961. ...

  962. keyN=valN

  963. [/SECTION]

  964. </pre></div>

  965. 

  966. <p>Metadata tags are printed as a line in the corresponding FORMAT, STREAM or

  967. PROGRAM_STREAM section, and are prefixed by the string &quot;TAG:&quot;.

  968. </p>

  969. <p>A description of the accepted options follows.

  970. </p>

  971. <dl compact="compact">

  972. <dt><span><samp>nokey, nk</samp></span></dt>

  973. <dd><p>If set to 1 specify not to print the key of each field. Default value

  974. is 0.

  975. </p>

  976. </dd>

  977. <dt><span><samp>noprint_wrappers, nw</samp></span></dt>

  978. <dd><p>If set to 1 specify not to print the section header and footer.

  979. Default value is 0.

  980. </p></dd>

  981. </dl>

  982. 

  983. <a name="compact_002c-csv"></a>

  984. <h3 class="section">4.2 compact, csv<span class="pull-right"><a class="anchor hidden-xs" href="#compact_002c-csv" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-compact_002c-csv" aria-hidden="true">TOC</a></span></h3>

  985. <p>Compact and CSV format.

  986. </p>

  987. <p>The <code>csv</code> writer is equivalent to <code>compact</code>, but supports

  988. different defaults.

  989. </p>

  990. <p>Each section is printed on a single line.

  991. If no option is specified, the output has the form:

  992. </p><div class="example">

  993. <pre class="example">section|key1=val1| ... |keyN=valN

  994. </pre></div>

  995. 

  996. <p>Metadata tags are printed in the corresponding &quot;format&quot; or &quot;stream&quot;

  997. section. A metadata tag key, if printed, is prefixed by the string

  998. &quot;tag:&quot;.

  999. </p>

  1000. <p>The description of the accepted options follows.

  1001. </p>

  1002. <dl compact="compact">

  1003. <dt><span><samp>item_sep, s</samp></span></dt>

  1004. <dd><p>Specify the character to use for separating fields in the output line.

  1005. It must be a single printable character, it is &quot;|&quot; by default (&quot;,&quot; for

  1006. the <code>csv</code> writer).

  1007. </p>

  1008. </dd>

  1009. <dt><span><samp>nokey, nk</samp></span></dt>

  1010. <dd><p>If set to 1 specify not to print the key of each field. Its default

  1011. value is 0 (1 for the <code>csv</code> writer).

  1012. </p>

  1013. </dd>

  1014. <dt><span><samp>escape, e</samp></span></dt>

  1015. <dd><p>Set the escape mode to use, default to &quot;c&quot; (&quot;csv&quot; for the <code>csv</code>

  1016. writer).

  1017. </p>

  1018. <p>It can assume one of the following values:

  1019. </p><dl compact="compact">

  1020. <dt><span><samp>c</samp></span></dt>

  1021. <dd><p>Perform C-like escaping. Strings containing a newline (&lsquo;<samp>\n</samp>&rsquo;), carriage

  1022. return (&lsquo;<samp>\r</samp>&rsquo;), a tab (&lsquo;<samp>\t</samp>&rsquo;), a form feed (&lsquo;<samp>\f</samp>&rsquo;), the escaping

  1023. character (&lsquo;<samp>\</samp>&rsquo;) or the item separator character <var>SEP</var> are escaped

  1024. using C-like fashioned escaping, so that a newline is converted to the

  1025. sequence &lsquo;<samp>\n</samp>&rsquo;, a carriage return to &lsquo;<samp>\r</samp>&rsquo;, &lsquo;<samp>\</samp>&rsquo; to &lsquo;<samp>\\</samp>&rsquo; and

  1026. the separator <var>SEP</var> is converted to &lsquo;<samp>\<var>SEP</var></samp>&rsquo;.

  1027. </p>

  1028. </dd>

  1029. <dt><span><samp>csv</samp></span></dt>

  1030. <dd><p>Perform CSV-like escaping, as described in RFC4180.  Strings

  1031. containing a newline (&lsquo;<samp>\n</samp>&rsquo;), a carriage return (&lsquo;<samp>\r</samp>&rsquo;), a double quote

  1032. (&lsquo;<samp>&quot;</samp>&rsquo;), or <var>SEP</var> are enclosed in double-quotes.

  1033. </p>

  1034. </dd>

  1035. <dt><span><samp>none</samp></span></dt>

  1036. <dd><p>Perform no escaping.

  1037. </p></dd>

  1038. </dl>

  1039. 

  1040. </dd>

  1041. <dt><span><samp>print_section, p</samp></span></dt>

  1042. <dd><p>Print the section name at the beginning of each line if the value is

  1043. <code>1</code>, disable it with value set to <code>0</code>. Default value is

  1044. <code>1</code>.

  1045. </p>

  1046. </dd>

  1047. </dl>

  1048. 

  1049. <a name="flat"></a>

  1050. <h3 class="section">4.3 flat<span class="pull-right"><a class="anchor hidden-xs" href="#flat" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-flat" aria-hidden="true">TOC</a></span></h3>

  1051. <p>Flat format.

  1052. </p>

  1053. <p>A free-form output where each line contains an explicit key=value, such as

  1054. &quot;streams.stream.3.tags.foo=bar&quot;. The output is shell escaped, so it can be

  1055. directly embedded in sh scripts as long as the separator character is an

  1056. alphanumeric character or an underscore (see <var>sep_char</var> option).

  1057. </p>

  1058. <p>The description of the accepted options follows.

  1059. </p>

  1060. <dl compact="compact">

  1061. <dt><span><samp>sep_char, s</samp></span></dt>

  1062. <dd><p>Separator character used to separate the chapter, the section name, IDs and

  1063. potential tags in the printed field key.

  1064. </p>

  1065. <p>Default value is &lsquo;<samp>.</samp>&rsquo;.

  1066. </p>

  1067. </dd>

  1068. <dt><span><samp>hierarchical, h</samp></span></dt>

  1069. <dd><p>Specify if the section name specification should be hierarchical. If

  1070. set to 1, and if there is more than one section in the current

  1071. chapter, the section name will be prefixed by the name of the

  1072. chapter. A value of 0 will disable this behavior.

  1073. </p>

  1074. <p>Default value is 1.

  1075. </p></dd>

  1076. </dl>

  1077. 

  1078. <a name="ini"></a>

  1079. <h3 class="section">4.4 ini<span class="pull-right"><a class="anchor hidden-xs" href="#ini" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-ini" aria-hidden="true">TOC</a></span></h3>

  1080. <p>INI format output.

  1081. </p>

  1082. <p>Print output in an INI based format.

  1083. </p>

  1084. <p>The following conventions are adopted:

  1085. </p>

  1086. <ul>

  1087. <li> all key and values are UTF-8

  1088. </li><li> &lsquo;<samp>.</samp>&rsquo; is the subgroup separator

  1089. </li><li> newline, &lsquo;<samp>\t</samp>&rsquo;, &lsquo;<samp>\f</samp>&rsquo;, &lsquo;<samp>\b</samp>&rsquo; and the following characters are

  1090. escaped

  1091. </li><li> &lsquo;<samp>\</samp>&rsquo; is the escape character

  1092. </li><li> &lsquo;<samp>#</samp>&rsquo; is the comment indicator

  1093. </li><li> &lsquo;<samp>=</samp>&rsquo; is the key/value separator

  1094. </li><li> &lsquo;<samp>:</samp>&rsquo; is not used but usually parsed as key/value separator

  1095. </li></ul>

  1096. 

  1097. <p>This writer accepts options as a list of <var>key</var>=<var>value</var> pairs,

  1098. separated by &lsquo;<samp>:</samp>&rsquo;.

  1099. </p>

  1100. <p>The description of the accepted options follows.

  1101. </p>

  1102. <dl compact="compact">

  1103. <dt><span><samp>hierarchical, h</samp></span></dt>

  1104. <dd><p>Specify if the section name specification should be hierarchical. If

  1105. set to 1, and if there is more than one section in the current

  1106. chapter, the section name will be prefixed by the name of the

  1107. chapter. A value of 0 will disable this behavior.

  1108. </p>

  1109. <p>Default value is 1.

  1110. </p></dd>

  1111. </dl>

  1112. 

  1113. <a name="json"></a>

  1114. <h3 class="section">4.5 json<span class="pull-right"><a class="anchor hidden-xs" href="#json" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-json" aria-hidden="true">TOC</a></span></h3>

  1115. <p>JSON based format.

  1116. </p>

  1117. <p>Each section is printed using JSON notation.

  1118. </p>

  1119. <p>The description of the accepted options follows.

  1120. </p>

  1121. <dl compact="compact">

  1122. <dt><span><samp>compact, c</samp></span></dt>

  1123. <dd><p>If set to 1 enable compact output, that is each section will be

  1124. printed on a single line. Default value is 0.

  1125. </p></dd>

  1126. </dl>

  1127. 

  1128. <p>For more information about JSON, see <a href="http://www.json.org/">http://www.json.org/</a>.

  1129. </p>

  1130. <a name="xml"></a>

  1131. <h3 class="section">4.6 xml<span class="pull-right"><a class="anchor hidden-xs" href="#xml" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-xml" aria-hidden="true">TOC</a></span></h3>

  1132. <p>XML based format.

  1133. </p>

  1134. <p>The XML output is described in the XML schema description file

  1135. <samp>ffprobe.xsd</samp> installed in the FFmpeg datadir.

  1136. </p>

  1137. <p>An updated version of the schema can be retrieved at the url

  1138. <a href="http://www.ffmpeg.org/schema/ffprobe.xsd">http://www.ffmpeg.org/schema/ffprobe.xsd</a>, which redirects to the

  1139. latest schema committed into the FFmpeg development source code tree.

  1140. </p>

  1141. <p>Note that the output issued will be compliant to the

  1142. <samp>ffprobe.xsd</samp> schema only when no special global output options

  1143. (<samp>unit</samp>, <samp>prefix</samp>, <samp>byte_binary_prefix</samp>,

  1144. <samp>sexagesimal</samp> etc.) are specified.

  1145. </p>

  1146. <p>The description of the accepted options follows.

  1147. </p>

  1148. <dl compact="compact">

  1149. <dt><span><samp>fully_qualified, q</samp></span></dt>

  1150. <dd><p>If set to 1 specify if the output should be fully qualified. Default

  1151. value is 0.

  1152. This is required for generating an XML file which can be validated

  1153. through an XSD file.

  1154. </p>

  1155. </dd>

  1156. <dt><span><samp>xsd_strict, x</samp></span></dt>

  1157. <dd><p>If set to 1 perform more checks for ensuring that the output is XSD

  1158. compliant. Default value is 0.

  1159. This option automatically sets <samp>fully_qualified</samp> to 1.

  1160. </p></dd>

  1161. </dl>

  1162. 

  1163. <p>For more information about the XML format, see

  1164. <a href="https://www.w3.org/XML/">https://www.w3.org/XML/</a>.

  1165. </p>

  1166. <a name="Timecode"></a>

  1167. <h2 class="chapter">5 Timecode<span class="pull-right"><a class="anchor hidden-xs" href="#Timecode" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Timecode" aria-hidden="true">TOC</a></span></h2>

  1168. 

  1169. <p><code>ffprobe</code> supports Timecode extraction:

  1170. </p>

  1171. <ul>

  1172. <li> MPEG1/2 timecode is extracted from the GOP, and is available in the video

  1173. stream details (<samp>-show_streams</samp>, see <var>timecode</var>).

  1174. 

  1175. </li><li> MOV timecode is extracted from tmcd track, so is available in the tmcd

  1176. stream metadata (<samp>-show_streams</samp>, see <var>TAG:timecode</var>).

  1177. 

  1178. </li><li> DV, GXF and AVI timecodes are available in format metadata

  1179. (<samp>-show_format</samp>, see <var>TAG:timecode</var>).

  1180. 

  1181. </li></ul>

  1182. 

  1183. 

  1184. <a name="See-Also"></a>

  1185. <h2 class="chapter">6 See Also<span class="pull-right"><a class="anchor hidden-xs" href="#See-Also" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-See-Also" aria-hidden="true">TOC</a></span></h2>

  1186. 

  1187. <p><a href="ffprobe-all.html">ffprobe-all</a>,

  1188. <a href="ffmpeg.html">ffmpeg</a>, <a href="ffplay.html">ffplay</a>,

  1189. <a href="ffmpeg-utils.html">ffmpeg-utils</a>,

  1190. <a href="ffmpeg-scaler.html">ffmpeg-scaler</a>,

  1191. <a href="ffmpeg-resampler.html">ffmpeg-resampler</a>,

  1192. <a href="ffmpeg-codecs.html">ffmpeg-codecs</a>,

  1193. <a href="ffmpeg-bitstream-filters.html">ffmpeg-bitstream-filters</a>,

  1194. <a href="ffmpeg-formats.html">ffmpeg-formats</a>,

  1195. <a href="ffmpeg-devices.html">ffmpeg-devices</a>,

  1196. <a href="ffmpeg-protocols.html">ffmpeg-protocols</a>,

  1197. <a href="ffmpeg-filters.html">ffmpeg-filters</a>

  1198. </p>

  1199. 

  1200. <a name="Authors"></a>

  1201. <h2 class="chapter">7 Authors<span class="pull-right"><a class="anchor hidden-xs" href="#Authors" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Authors" aria-hidden="true">TOC</a></span></h2>

  1202. 

  1203. <p>The FFmpeg developers.

  1204. </p>

  1205. <p>For details about the authorship, see the Git history of the project

  1206. (https://git.ffmpeg.org/ffmpeg), e.g. by typing the command

  1207. <code>git log</code> in the FFmpeg source directory, or browsing the

  1208. online repository at <a href="https://git.ffmpeg.org/ffmpeg">https://git.ffmpeg.org/ffmpeg</a>.

  1209. </p>

  1210. <p>Maintainers for the specific components are listed in the file

  1211. <samp>MAINTAINERS</samp> in the source code tree.

  1212. </p>

  1213. 

  1214.       <p style="font-size: small;">

  1215.         This document was generated using <a href="https://www.gnu.org/software/texinfo/"><em>makeinfo</em></a>.

  1216.       </p>

  1217.     </div>

  1218.   </body>

  1219. </html>