zhaoyaoyao
/
XHZBPC
Watch 1
Star 0
Fork 0
Code Issues 0 Pull Requests 0 Releases 0 Wiki Activity
星火直播PC
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.
30 Commits
2 Branches
Branch: master
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'master'
${ noResults }
XHZBPC/Common/ffmpeg/doc/ffprobe.html

ffprobe.html 46KB
Raw Permalink Blame History

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199 
  1. <!DOCTYPE html>

  2. <html lang="en">

  3.   <head>

  4.     <meta charset="utf-8" />

  5.     <meta http-equiv="X-UA-Compatible" content="IE=edge" />

  6.     <title>FFmpeg documentation</title>

  7.     <link rel="stylesheet" href="bootstrap.min.css" />

  8.     <link rel="stylesheet" href="style.min.css" />

  9. 

  10. <meta name="description" content="ffprobe Documentation: ">

  11. <meta name="keywords" content="FFmpeg documentation : ffprobe ">

  12. <meta name="Generator" content="texi2html 5.0">

  13. <!-- Created on March 9, 2020 by texi2html 5.0 -->

  14. <!--

  15. texi2html was written by: 

  16.             Lionel Cons <Lionel.Cons@cern.ch> (original author)

  17.             Karl Berry  <karl@freefriends.org>

  18.             Olaf Bachmann <obachman@mathematik.uni-kl.de>

  19.             and many others.

  20. Maintained by: Many creative people.

  21. Send bugs and suggestions to <texi2html-bug@nongnu.org>

  22. 

  23. -->

  24. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">

  25.   </head>

  26.   <body>

  27.     <div class="container">

  28. 

  29. <h1 class="titlefont">ffprobe Documentation</h1>

  30. <hr>

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

  32. 

  33. <a name="SEC_Contents"></a>

  34. <h1>Table of Contents</h1>

  35. 

  36. <div class="contents">

  37. 

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

  39.   <li><a name="toc-Synopsis" href="#Synopsis">1 Synopsis</a></li>

  40.   <li><a name="toc-Description" href="#Description">2 Description</a></li>

  41.   <li><a name="toc-Options" href="#Options">3 Options</a>

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

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

  44.     <li><a name="toc-Generic-options" href="#Generic-options">3.2 Generic options</a></li>

  45.     <li><a name="toc-AVOptions" href="#AVOptions">3.3 AVOptions</a></li>

  46.     <li><a name="toc-Main-options" href="#Main-options">3.4 Main options</a></li>

  47.   </ul></li>

  48.   <li><a name="toc-Writers" href="#Writers">4 Writers</a>

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

  50.     <li><a name="toc-default" href="#default">4.1 default</a></li>

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

  52.     <li><a name="toc-flat" href="#flat">4.3 flat</a></li>

  53.     <li><a name="toc-ini" href="#ini">4.4 ini</a></li>

  54.     <li><a name="toc-json" href="#json">4.5 json</a></li>

  55.     <li><a name="toc-xml" href="#xml">4.6 xml</a></li>

  56.   </ul></li>

  57.   <li><a name="toc-Timecode" href="#Timecode">5 Timecode</a></li>

  58.   <li><a name="toc-See-Also" href="#See-Also">6 See Also</a></li>

  59.   <li><a name="toc-Authors" href="#Authors">7 Authors</a></li>

  60. </ul>

  61. </div>

  62. 

  63. 

  64. <hr size="6">

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

  66. <h1 class="chapter"><a href="ffprobe.html#toc-Synopsis">1 Synopsis</a></h1>

  67. 

  68. <p>ffprobe [<var>options</var>] [&lsquo;<tt>input_url</tt>&rsquo;]

  69. </p>

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

  71. <h1 class="chapter"><a href="ffprobe.html#toc-Description">2 Description</a></h1>

  72. 

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

  74. human- and machine-readable fashion.

  75. </p>

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

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

  78. contained in it.

  79. </p>

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

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

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

  83. </p>

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

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

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

  87. </p>

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

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

  90. ffprobe will show it.

  91. </p>

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

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

  94. writer, which is specified by the &lsquo;<samp>print_format</samp>&rsquo; option.

  95. </p>

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

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

  98. name. See the output of &lsquo;<samp>sections</samp>&rsquo;.

  99. </p>

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

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

  102. section.

  103. </p>

  104. 

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

  106. <h1 class="chapter"><a href="ffprobe.html#toc-Options">3 Options</a></h1>

  107. 

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

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

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

  111. </p>

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

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

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

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

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

  117. </p>

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

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

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

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

  122. </p>

  123. <p><a name="Stream-specifiers"></a>

  124. </p><a name="Stream-specifiers-1"></a>

  125. <h2 class="section"><a href="ffprobe.html#toc-Stream-specifiers-1">3.1 Stream specifiers</a></h2>

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

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

  128. </p>

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

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

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

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

  133. </p>

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

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

  136. streams.

  137. </p>

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

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

  140. </p>

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

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

  143. <dt>&lsquo;<samp><var>stream_index</var></samp>&rsquo;</dt>

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

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

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

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

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

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

  150. program.

  151. </p></dd>

  152. <dt>&lsquo;<samp><var>stream_type</var>[:<var>additional_stream_specifier</var>]</samp>&rsquo;</dt>

  153. <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;

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

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

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

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

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

  159. specified type.

  160. </p></dd>

  161. <dt>&lsquo;<samp>p:<var>program_id</var>[:<var>additional_stream_specifier</var>]</samp>&rsquo;</dt>

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

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

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

  165. </p>

  166. </dd>

  167. <dt>&lsquo;<samp>#<var>stream_id</var> or i:<var>stream_id</var></samp>&rsquo;</dt>

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

  169. </p></dd>

  170. <dt>&lsquo;<samp>m:<var>key</var>[:<var>value</var>]</samp>&rsquo;</dt>

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

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

  173. value.

  174. </p></dd>

  175. <dt>&lsquo;<samp>u</samp>&rsquo;</dt>

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

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

  178. </p>

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

  180. input files.

  181. </p></dd>

  182. </dl>

  183. 

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

  185. <h2 class="section"><a href="ffprobe.html#toc-Generic-options">3.2 Generic options</a></h2>

  186. 

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

  188. </p>

  189. <dl compact="compact">

  190. <dt>&lsquo;<samp>-L</samp>&rsquo;</dt>

  191. <dd><p>Show license.

  192. </p>

  193. </dd>

  194. <dt>&lsquo;<samp>-h, -?, -help, --help [<var>arg</var>]</samp>&rsquo;</dt>

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

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

  197. options are shown.

  198. </p>

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

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

  201. <dt>&lsquo;<samp>long</samp>&rsquo;</dt>

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

  203. </p>

  204. </dd>

  205. <dt>&lsquo;<samp>full</samp>&rsquo;</dt>

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

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

  208. </p>

  209. </dd>

  210. <dt>&lsquo;<samp>decoder=<var>decoder_name</var></samp>&rsquo;</dt>

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

  212. &lsquo;<samp>-decoders</samp>&rsquo; option to get a list of all decoders.

  213. </p>

  214. </dd>

  215. <dt>&lsquo;<samp>encoder=<var>encoder_name</var></samp>&rsquo;</dt>

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

  217. &lsquo;<samp>-encoders</samp>&rsquo; option to get a list of all encoders.

  218. </p>

  219. </dd>

  220. <dt>&lsquo;<samp>demuxer=<var>demuxer_name</var></samp>&rsquo;</dt>

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

  222. &lsquo;<samp>-formats</samp>&rsquo; option to get a list of all demuxers and muxers.

  223. </p>

  224. </dd>

  225. <dt>&lsquo;<samp>muxer=<var>muxer_name</var></samp>&rsquo;</dt>

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

  227. &lsquo;<samp>-formats</samp>&rsquo; option to get a list of all muxers and demuxers.

  228. </p>

  229. </dd>

  230. <dt>&lsquo;<samp>filter=<var>filter_name</var></samp>&rsquo;</dt>

  231. <dd><p>Print detailed information about the filter name <var>filter_name</var>. Use the

  232. &lsquo;<samp>-filters</samp>&rsquo; option to get a list of all filters.

  233. </p>

  234. </dd>

  235. <dt>&lsquo;<samp>bsf=<var>bitstream_filter_name</var></samp>&rsquo;</dt>

  236. <dd><p>Print detailed information about the bitstream filter name <var>bitstream_filter_name</var>.

  237. Use the &lsquo;<samp>-bsfs</samp>&rsquo; option to get a list of all bitstream filters.

  238. </p></dd>

  239. </dl>

  240. 

  241. </dd>

  242. <dt>&lsquo;<samp>-version</samp>&rsquo;</dt>

  243. <dd><p>Show version.

  244. </p>

  245. </dd>

  246. <dt>&lsquo;<samp>-formats</samp>&rsquo;</dt>

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

  248. </p>

  249. </dd>

  250. <dt>&lsquo;<samp>-demuxers</samp>&rsquo;</dt>

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

  252. </p>

  253. </dd>

  254. <dt>&lsquo;<samp>-muxers</samp>&rsquo;</dt>

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

  256. </p>

  257. </dd>

  258. <dt>&lsquo;<samp>-devices</samp>&rsquo;</dt>

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

  260. </p>

  261. </dd>

  262. <dt>&lsquo;<samp>-codecs</samp>&rsquo;</dt>

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

  264. </p>

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

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

  267. </p>

  268. </dd>

  269. <dt>&lsquo;<samp>-decoders</samp>&rsquo;</dt>

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

  271. </p>

  272. </dd>

  273. <dt>&lsquo;<samp>-encoders</samp>&rsquo;</dt>

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

  275. </p>

  276. </dd>

  277. <dt>&lsquo;<samp>-bsfs</samp>&rsquo;</dt>

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

  279. </p>

  280. </dd>

  281. <dt>&lsquo;<samp>-protocols</samp>&rsquo;</dt>

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

  283. </p>

  284. </dd>

  285. <dt>&lsquo;<samp>-filters</samp>&rsquo;</dt>

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

  287. </p>

  288. </dd>

  289. <dt>&lsquo;<samp>-pix_fmts</samp>&rsquo;</dt>

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

  291. </p>

  292. </dd>

  293. <dt>&lsquo;<samp>-sample_fmts</samp>&rsquo;</dt>

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

  295. </p>

  296. </dd>

  297. <dt>&lsquo;<samp>-layouts</samp>&rsquo;</dt>

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

  299. </p>

  300. </dd>

  301. <dt>&lsquo;<samp>-colors</samp>&rsquo;</dt>

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

  303. </p>

  304. </dd>

  305. <dt>&lsquo;<samp>-sources <var>device</var>[,<var>opt1</var>=<var>val1</var>[,<var>opt2</var>=<var>val2</var>]...]</samp>&rsquo;</dt>

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

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

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

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

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

  311. </pre></div>

  312. 

  313. </dd>

  314. <dt>&lsquo;<samp>-sinks <var>device</var>[,<var>opt1</var>=<var>val1</var>[,<var>opt2</var>=<var>val2</var>]...]</samp>&rsquo;</dt>

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

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

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

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

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

  320. </pre></div>

  321. 

  322. </dd>

  323. <dt>&lsquo;<samp>-loglevel [<var>flags</var>+]<var>loglevel</var> | -v [<var>flags</var>+]<var>loglevel</var></samp>&rsquo;</dt>

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

  325. </p>

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

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

  328. <dt>&lsquo;<samp>repeat</samp>&rsquo;</dt>

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

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

  331. </p></dd>

  332. <dt>&lsquo;<samp>level</samp>&rsquo;</dt>

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

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

  335. log to file.

  336. </p></dd>

  337. </dl>

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

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

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

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

  342. </p>

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

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

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

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

  347. </p></dd>

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

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

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

  351. </p></dd>

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

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

  354. cannot continue.

  355. </p></dd>

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

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

  358. </p></dd>

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

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

  361. incorrect or unexpected events will be shown.

  362. </p></dd>

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

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

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

  366. </p></dd>

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

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

  369. </p></dd>

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

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

  372. </p></dd>

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

  374. </dl>

  375. 

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

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

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

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

  380. </pre></div>

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

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

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

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

  385. </pre></div>

  386. 

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

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

  389. can be disabled setting the environment variable

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

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

  392. </p>

  393. </dd>

  394. <dt>&lsquo;<samp>-report</samp>&rsquo;</dt>

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

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

  397. directory.

  398. This file can be useful for bug reports.

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

  400. </p>

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

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

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

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

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

  406. </p>

  407. <p>The following options are recognized:

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

  409. <dt>&lsquo;<samp>file</samp>&rsquo;</dt>

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

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

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

  413. </p></dd>

  414. <dt>&lsquo;<samp>level</samp>&rsquo;</dt>

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

  416. </p></dd>

  417. </dl>

  418. 

  419. <p>For example, to output a report to a file named &lsquo;<tt>ffreport.log</tt>&rsquo;

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

  421. </p>

  422. <div class="example">

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

  424. </pre></div>

  425. 

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

  427. appear in the report.

  428. </p>

  429. </dd>

  430. <dt>&lsquo;<samp>-hide_banner</samp>&rsquo;</dt>

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

  432. </p>

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

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

  435. this information.

  436. </p>

  437. </dd>

  438. <dt>&lsquo;<samp>-cpuflags flags (<em>global</em>)</samp>&rsquo;</dt>

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

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

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

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

  443. ffmpeg -cpuflags mmx ...

  444. ffmpeg -cpuflags 0 ...

  445. </pre></div>

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

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

  448. <dt>&lsquo;<samp>x86</samp>&rsquo;</dt>

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

  450. <dt>&lsquo;<samp>mmx</samp>&rsquo;</dt>

  451. <dt>&lsquo;<samp>mmxext</samp>&rsquo;</dt>

  452. <dt>&lsquo;<samp>sse</samp>&rsquo;</dt>

  453. <dt>&lsquo;<samp>sse2</samp>&rsquo;</dt>

  454. <dt>&lsquo;<samp>sse2slow</samp>&rsquo;</dt>

  455. <dt>&lsquo;<samp>sse3</samp>&rsquo;</dt>

  456. <dt>&lsquo;<samp>sse3slow</samp>&rsquo;</dt>

  457. <dt>&lsquo;<samp>ssse3</samp>&rsquo;</dt>

  458. <dt>&lsquo;<samp>atom</samp>&rsquo;</dt>

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

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

  461. <dt>&lsquo;<samp>avx</samp>&rsquo;</dt>

  462. <dt>&lsquo;<samp>avx2</samp>&rsquo;</dt>

  463. <dt>&lsquo;<samp>xop</samp>&rsquo;</dt>

  464. <dt>&lsquo;<samp>fma3</samp>&rsquo;</dt>

  465. <dt>&lsquo;<samp>fma4</samp>&rsquo;</dt>

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

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

  468. <dt>&lsquo;<samp>bmi1</samp>&rsquo;</dt>

  469. <dt>&lsquo;<samp>bmi2</samp>&rsquo;</dt>

  470. <dt>&lsquo;<samp>cmov</samp>&rsquo;</dt>

  471. </dl>

  472. </dd>

  473. <dt>&lsquo;<samp>ARM</samp>&rsquo;</dt>

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

  475. <dt>&lsquo;<samp>armv5te</samp>&rsquo;</dt>

  476. <dt>&lsquo;<samp>armv6</samp>&rsquo;</dt>

  477. <dt>&lsquo;<samp>armv6t2</samp>&rsquo;</dt>

  478. <dt>&lsquo;<samp>vfp</samp>&rsquo;</dt>

  479. <dt>&lsquo;<samp>vfpv3</samp>&rsquo;</dt>

  480. <dt>&lsquo;<samp>neon</samp>&rsquo;</dt>

  481. <dt>&lsquo;<samp>setend</samp>&rsquo;</dt>

  482. </dl>

  483. </dd>

  484. <dt>&lsquo;<samp>AArch64</samp>&rsquo;</dt>

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

  486. <dt>&lsquo;<samp>armv8</samp>&rsquo;</dt>

  487. <dt>&lsquo;<samp>vfp</samp>&rsquo;</dt>

  488. <dt>&lsquo;<samp>neon</samp>&rsquo;</dt>

  489. </dl>

  490. </dd>

  491. <dt>&lsquo;<samp>PowerPC</samp>&rsquo;</dt>

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

  493. <dt>&lsquo;<samp>altivec</samp>&rsquo;</dt>

  494. </dl>

  495. </dd>

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

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

  498. <dt>&lsquo;<samp>pentium2</samp>&rsquo;</dt>

  499. <dt>&lsquo;<samp>pentium3</samp>&rsquo;</dt>

  500. <dt>&lsquo;<samp>pentium4</samp>&rsquo;</dt>

  501. <dt>&lsquo;<samp>k6</samp>&rsquo;</dt>

  502. <dt>&lsquo;<samp>k62</samp>&rsquo;</dt>

  503. <dt>&lsquo;<samp>athlon</samp>&rsquo;</dt>

  504. <dt>&lsquo;<samp>athlonxp</samp>&rsquo;</dt>

  505. <dt>&lsquo;<samp>k8</samp>&rsquo;</dt>

  506. </dl>

  507. </dd>

  508. </dl>

  509. </dd>

  510. </dl>

  511. 

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

  513. <h2 class="section"><a href="ffprobe.html#toc-AVOptions">3.3 AVOptions</a></h2>

  514. 

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

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

  517. &lsquo;<samp>-help</samp>&rsquo; option. They are separated into two categories:

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

  519. <dt>&lsquo;<samp>generic</samp>&rsquo;</dt>

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

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

  522. AVCodecContext options for codecs.

  523. </p></dd>

  524. <dt>&lsquo;<samp>private</samp>&rsquo;</dt>

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

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

  527. </p></dd>

  528. </dl>

  529. 

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

  531. an MP3 file, use the &lsquo;<samp>id3v2_version</samp>&rsquo; private option of the MP3

  532. muxer:

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

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

  535. </pre></div>

  536. 

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

  538. should be attached to them:

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

  540. <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

  541. </pre></div>

  542. 

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

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

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

  546. absolute index of the output stream.

  547. </p>

  548. <p>Note: the &lsquo;<samp>-nooption</samp>&rsquo; syntax cannot be used for boolean

  549. AVOptions, use &lsquo;<samp>-option 0</samp>&rsquo;/&lsquo;<samp>-option 1</samp>&rsquo;.

  550. </p>

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

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

  553. removed soon.

  554. </p>

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

  556. <h2 class="section"><a href="ffprobe.html#toc-Main-options">3.4 Main options</a></h2>

  557. 

  558. <dl compact="compact">

  559. <dt>&lsquo;<samp>-f <var>format</var></samp>&rsquo;</dt>

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

  561. </p>

  562. </dd>

  563. <dt>&lsquo;<samp>-unit</samp>&rsquo;</dt>

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

  565. </p>

  566. </dd>

  567. <dt>&lsquo;<samp>-prefix</samp>&rsquo;</dt>

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

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

  570. are decimal.

  571. </p>

  572. </dd>

  573. <dt>&lsquo;<samp>-byte_binary_prefix</samp>&rsquo;</dt>

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

  575. </p>

  576. </dd>

  577. <dt>&lsquo;<samp>-sexagesimal</samp>&rsquo;</dt>

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

  579. </p>

  580. </dd>

  581. <dt>&lsquo;<samp>-pretty</samp>&rsquo;</dt>

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

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

  584. </p>

  585. </dd>

  586. <dt>&lsquo;<samp>-of, -print_format <var>writer_name</var>[=<var>writer_options</var>]</samp>&rsquo;</dt>

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

  588. </p>

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

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

  591. </p>

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

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

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

  595. </pre></div>

  596. 

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

  598. Writers section below.

  599. </p>

  600. </dd>

  601. <dt>&lsquo;<samp>-sections</samp>&rsquo;</dt>

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

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

  604. </p>

  605. </dd>

  606. <dt>&lsquo;<samp>-select_streams <var>stream_specifier</var></samp>&rsquo;</dt>

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

  608. option affects only the options related to streams

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

  610. </p>

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

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

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

  614. </pre></div>

  615. 

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

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

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

  619. </pre></div>

  620. 

  621. </dd>

  622. <dt>&lsquo;<samp>-show_data</samp>&rsquo;</dt>

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

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

  625. &lsquo;<samp>-show_streams</samp>&rsquo;, it will dump the codec extradata.

  626. </p>

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

  628. </p>

  629. </dd>

  630. <dt>&lsquo;<samp>-show_data_hash <var>algorithm</var></samp>&rsquo;</dt>

  631. <dd><p>Show a hash of payload data, for packets with &lsquo;<samp>-show_packets</samp>&rsquo; and for

  632. codec extradata with &lsquo;<samp>-show_streams</samp>&rsquo;.

  633. </p>

  634. </dd>

  635. <dt>&lsquo;<samp>-show_error</samp>&rsquo;</dt>

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

  637. </p>

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

  639. </p>

  640. </dd>

  641. <dt>&lsquo;<samp>-show_format</samp>&rsquo;</dt>

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

  643. stream.

  644. </p>

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

  646. name &quot;FORMAT&quot;.

  647. </p>

  648. </dd>

  649. <dt>&lsquo;<samp>-show_format_entry <var>name</var></samp>&rsquo;</dt>

  650. <dd><p>Like &lsquo;<samp>-show_format</samp>&rsquo;, but only prints the specified entry of the

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

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

  653. </p>

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

  655. </p>

  656. </dd>

  657. <dt>&lsquo;<samp>-show_entries <var>section_entries</var></samp>&rsquo;</dt>

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

  659. </p>

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

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

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

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

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

  665. </p>

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

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

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

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

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

  671. that section.

  672. </p>

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

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

  675. retained.

  676. </p>

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

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

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

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

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

  682. </pre></div>

  683. 

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

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

  686. the argument:

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

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

  689. </pre></div>

  690. 

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

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

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

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

  695. </pre></div>

  696. 

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

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

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

  700. </pre></div>

  701. 

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

  703. sections:

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

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

  706. </pre></div>

  707. 

  708. </dd>

  709. <dt>&lsquo;<samp>-show_packets</samp>&rsquo;</dt>

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

  711. stream.

  712. </p>

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

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

  715. </p>

  716. </dd>

  717. <dt>&lsquo;<samp>-show_frames</samp>&rsquo;</dt>

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

  719. multimedia stream.

  720. </p>

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

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

  723. </p>

  724. </dd>

  725. <dt>&lsquo;<samp>-show_log <var>loglevel</var></samp>&rsquo;</dt>

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

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

  728. </p>

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

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

  731. </p>

  732. </dd>

  733. <dt>&lsquo;<samp>-show_streams</samp>&rsquo;</dt>

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

  735. multimedia stream.

  736. </p>

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

  738. with name &quot;STREAM&quot;.

  739. </p>

  740. </dd>

  741. <dt>&lsquo;<samp>-show_programs</samp>&rsquo;</dt>

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

  743. multimedia stream.

  744. </p>

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

  746. with name &quot;PROGRAM_STREAM&quot;.

  747. </p>

  748. </dd>

  749. <dt>&lsquo;<samp>-show_chapters</samp>&rsquo;</dt>

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

  751. </p>

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

  753. </p>

  754. </dd>

  755. <dt>&lsquo;<samp>-count_frames</samp>&rsquo;</dt>

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

  757. corresponding stream section.

  758. </p>

  759. </dd>

  760. <dt>&lsquo;<samp>-count_packets</samp>&rsquo;</dt>

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

  762. corresponding stream section.

  763. </p>

  764. </dd>

  765. <dt>&lsquo;<samp>-read_intervals <var>read_intervals</var></samp>&rsquo;</dt>

  766. <dd>

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

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

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

  770. continue reading from that.

  771. </p>

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

  773. </p>

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

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

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

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

  778. interval.

  779. </p>

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

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

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

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

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

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

  786. end of the input.

  787. </p>

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

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

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

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

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

  793. </p>

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

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

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

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

  798. </pre></div>

  799. 

  800. <p>A few examples follow.

  801. </p><ul>

  802. <li>

  803. Seek to time 10, read packets until 20 seconds after the found seek

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

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

  806. <div class="example">

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

  808. </pre></div>

  809. 

  810. </li><li>

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

  812. <div class="example">

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

  814. </pre></div>

  815. 

  816. </li><li>

  817. Read only the first 20 seconds from the start:

  818. <div class="example">

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

  820. </pre></div>

  821. 

  822. </li><li>

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

  824. <div class="example">

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

  826. </pre></div>

  827. </li></ul>

  828. 

  829. </dd>

  830. <dt>&lsquo;<samp>-show_private_data, -private</samp>&rsquo;</dt>

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

  832. particular shown element.

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

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

  835. </p>

  836. </dd>

  837. <dt>&lsquo;<samp>-show_program_version</samp>&rsquo;</dt>

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

  839. </p>

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

  841. &quot;PROGRAM_VERSION&quot;.

  842. </p>

  843. </dd>

  844. <dt>&lsquo;<samp>-show_library_versions</samp>&rsquo;</dt>

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

  846. </p>

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

  848. name &quot;LIBRARY_VERSION&quot;.

  849. </p>

  850. </dd>

  851. <dt>&lsquo;<samp>-show_versions</samp>&rsquo;</dt>

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

  853. equivalent of setting both &lsquo;<samp>-show_program_version</samp>&rsquo; and

  854. &lsquo;<samp>-show_library_versions</samp>&rsquo; options.

  855. </p>

  856. </dd>

  857. <dt>&lsquo;<samp>-show_pixel_formats</samp>&rsquo;</dt>

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

  859. </p>

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

  861. with name &quot;PIXEL_FORMAT&quot;.

  862. </p>

  863. </dd>

  864. <dt>&lsquo;<samp>-bitexact</samp>&rsquo;</dt>

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

  866. on the specific build.

  867. </p>

  868. </dd>

  869. <dt>&lsquo;<samp>-i <var>input_url</var></samp>&rsquo;</dt>

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

  871. </p>

  872. </dd>

  873. </dl>

  874. 

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

  876. <h1 class="chapter"><a href="ffprobe.html#toc-Writers">4 Writers</a></h1>

  877. 

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

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

  880. </p>

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

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

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

  884. </p>

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

  886. </p>

  887. <dl compact="compact">

  888. <dt>&lsquo;<samp>string_validation, sv</samp>&rsquo;</dt>

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

  890. </p>

  891. <p>The following values are accepted.

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

  893. <dt>&lsquo;<samp>fail</samp>&rsquo;</dt>

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

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

  896. useful to validate input metadata.

  897. </p>

  898. </dd>

  899. <dt>&lsquo;<samp>ignore</samp>&rsquo;</dt>

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

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

  902. </p>

  903. </dd>

  904. <dt>&lsquo;<samp>replace</samp>&rsquo;</dt>

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

  906. the string specified with the &lsquo;<samp>string_validation_replacement</samp>&rsquo;.

  907. </p></dd>

  908. </dl>

  909. 

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

  911. </p>

  912. </dd>

  913. <dt>&lsquo;<samp>string_validation_replacement, svr</samp>&rsquo;</dt>

  914. <dd><p>Set replacement string to use in case &lsquo;<samp>string_validation</samp>&rsquo; is

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

  916. </p>

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

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

  919. strings.

  920. </p></dd>

  921. </dl>

  922. 

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

  924. </p>

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

  926. <h2 class="section"><a href="ffprobe.html#toc-default">4.1 default</a></h2>

  927. <p>Default format.

  928. </p>

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

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

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

  932. key1=val1

  933. ...

  934. keyN=valN

  935. [/SECTION]

  936. </pre></div>

  937. 

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

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

  940. </p>

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

  942. </p>

  943. <dl compact="compact">

  944. <dt>&lsquo;<samp>nokey, nk</samp>&rsquo;</dt>

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

  946. is 0.

  947. </p>

  948. </dd>

  949. <dt>&lsquo;<samp>noprint_wrappers, nw</samp>&rsquo;</dt>

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

  951. Default value is 0.

  952. </p></dd>

  953. </dl>

  954. 

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

  956. <h2 class="section"><a href="ffprobe.html#toc-compact_002c-csv">4.2 compact, csv</a></h2>

  957. <p>Compact and CSV format.

  958. </p>

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

  960. different defaults.

  961. </p>

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

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

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

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

  966. </pre></div>

  967. 

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

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

  970. &quot;tag:&quot;.

  971. </p>

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

  973. </p>

  974. <dl compact="compact">

  975. <dt>&lsquo;<samp>item_sep, s</samp>&rsquo;</dt>

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

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

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

  979. </p>

  980. </dd>

  981. <dt>&lsquo;<samp>nokey, nk</samp>&rsquo;</dt>

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

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

  984. </p>

  985. </dd>

  986. <dt>&lsquo;<samp>escape, e</samp>&rsquo;</dt>

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

  988. writer).

  989. </p>

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

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

  992. <dt>&lsquo;<samp>c</samp>&rsquo;</dt>

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

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

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

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

  997. 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

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

  999. </p>

  1000. </dd>

  1001. <dt>&lsquo;<samp>csv</samp>&rsquo;</dt>

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

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

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

  1005. </p>

  1006. </dd>

  1007. <dt>&lsquo;<samp>none</samp>&rsquo;</dt>

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

  1009. </p></dd>

  1010. </dl>

  1011. 

  1012. </dd>

  1013. <dt>&lsquo;<samp>print_section, p</samp>&rsquo;</dt>

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

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

  1016. <code>1</code>.

  1017. </p>

  1018. </dd>

  1019. </dl>

  1020. 

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

  1022. <h2 class="section"><a href="ffprobe.html#toc-flat">4.3 flat</a></h2>

  1023. <p>Flat format.

  1024. </p>

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

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

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

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

  1029. </p>

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

  1031. </p>

  1032. <dl compact="compact">

  1033. <dt>&lsquo;<samp>sep_char, s</samp>&rsquo;</dt>

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

  1035. potential tags in the printed field key.

  1036. </p>

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

  1038. </p>

  1039. </dd>

  1040. <dt>&lsquo;<samp>hierarchical, h</samp>&rsquo;</dt>

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

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

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

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

  1045. </p>

  1046. <p>Default value is 1.

  1047. </p></dd>

  1048. </dl>

  1049. 

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

  1051. <h2 class="section"><a href="ffprobe.html#toc-ini">4.4 ini</a></h2>

  1052. <p>INI format output.

  1053. </p>

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

  1055. </p>

  1056. <p>The following conventions are adopted:

  1057. </p>

  1058. <ul>

  1059. <li>

  1060. all key and values are UTF-8

  1061. </li><li>

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

  1063. </li><li>

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

  1065. escaped

  1066. </li><li>

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

  1068. </li><li>

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

  1070. </li><li>

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

  1072. </li><li>

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

  1074. </li></ul>

  1075. 

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

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

  1078. </p>

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

  1080. </p>

  1081. <dl compact="compact">

  1082. <dt>&lsquo;<samp>hierarchical, h</samp>&rsquo;</dt>

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

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

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

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

  1087. </p>

  1088. <p>Default value is 1.

  1089. </p></dd>

  1090. </dl>

  1091. 

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

  1093. <h2 class="section"><a href="ffprobe.html#toc-json">4.5 json</a></h2>

  1094. <p>JSON based format.

  1095. </p>

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

  1097. </p>

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

  1099. </p>

  1100. <dl compact="compact">

  1101. <dt>&lsquo;<samp>compact, c</samp>&rsquo;</dt>

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

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

  1104. </p></dd>

  1105. </dl>

  1106. 

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

  1108. </p>

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

  1110. <h2 class="section"><a href="ffprobe.html#toc-xml">4.6 xml</a></h2>

  1111. <p>XML based format.

  1112. </p>

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

  1114. &lsquo;<tt>ffprobe.xsd</tt>&rsquo; installed in the FFmpeg datadir.

  1115. </p>

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

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

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

  1119. </p>

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

  1121. &lsquo;<tt>ffprobe.xsd</tt>&rsquo; schema only when no special global output options

  1122. (&lsquo;<samp>unit</samp>&rsquo;, &lsquo;<samp>prefix</samp>&rsquo;, &lsquo;<samp>byte_binary_prefix</samp>&rsquo;,

  1123. &lsquo;<samp>sexagesimal</samp>&rsquo; etc.) are specified.

  1124. </p>

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

  1126. </p>

  1127. <dl compact="compact">

  1128. <dt>&lsquo;<samp>fully_qualified, q</samp>&rsquo;</dt>

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

  1130. value is 0.

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

  1132. through an XSD file.

  1133. </p>

  1134. </dd>

  1135. <dt>&lsquo;<samp>xsd_strict, x</samp>&rsquo;</dt>

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

  1137. compliant. Default value is 0.

  1138. This option automatically sets &lsquo;<samp>fully_qualified</samp>&rsquo; to 1.

  1139. </p></dd>

  1140. </dl>

  1141. 

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

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

  1144. </p>

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

  1146. <h1 class="chapter"><a href="ffprobe.html#toc-Timecode">5 Timecode</a></h1>

  1147. 

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

  1149. </p>

  1150. <ul>

  1151. <li>

  1152. MPEG1/2 timecode is extracted from the GOP, and is available in the video

  1153. stream details (&lsquo;<samp>-show_streams</samp>&rsquo;, see <var>timecode</var>).

  1154. 

  1155. </li><li>

  1156. MOV timecode is extracted from tmcd track, so is available in the tmcd

  1157. stream metadata (&lsquo;<samp>-show_streams</samp>&rsquo;, see <var>TAG:timecode</var>).

  1158. 

  1159. </li><li>

  1160. DV, GXF and AVI timecodes are available in format metadata

  1161. (&lsquo;<samp>-show_format</samp>&rsquo;, see <var>TAG:timecode</var>).

  1162. 

  1163. </li></ul>

  1164. 

  1165. 

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

  1167. <h1 class="chapter"><a href="ffprobe.html#toc-See-Also">6 See Also</a></h1>

  1168. 

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

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

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

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

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

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

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

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

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

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

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

  1180. </p>

  1181. 

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

  1183. <h1 class="chapter"><a href="ffprobe.html#toc-Authors">7 Authors</a></h1>

  1184. 

  1185. <p>The FFmpeg developers.

  1186. </p>

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

  1188. (git://source.ffmpeg.org/ffmpeg), e.g. by typing the command

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

  1190. online repository at <a href="http://source.ffmpeg.org">http://source.ffmpeg.org</a>.

  1191. </p>

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

  1193. &lsquo;<tt>MAINTAINERS</tt>&rsquo; in the source code tree.

  1194. </p>

  1195. 

  1196.     </div>

  1197.   </body>

  1198. </html>