diff options
| author | Xavier Del Campo Romero <xavi.dcr@tutanota.com> | 2021-01-03 02:06:58 +0100 |
|---|---|---|
| committer | Xavier Del Campo Romero <xavi.dcr@tutanota.com> | 2021-01-03 02:52:19 +0100 |
| commit | 734eee1af2c21976e8f57c4ca498593a305fb22e (patch) | |
| tree | 8d5593567ce80c37820ea0c5ae76ff6bdb9e529c /Music/ffmpeg/doc/ffmpeg-formats.html | |
| parent | be200a681bed14801bb564c79f70e773e44e6c73 (diff) | |
| download | airport-734eee1af2c21976e8f57c4ca498593a305fb22e.tar.gz | |
Remove ffmpeg binary from project
Diffstat (limited to 'Music/ffmpeg/doc/ffmpeg-formats.html')
| -rw-r--r-- | Music/ffmpeg/doc/ffmpeg-formats.html | 3197 |
1 files changed, 0 insertions, 3197 deletions
diff --git a/Music/ffmpeg/doc/ffmpeg-formats.html b/Music/ffmpeg/doc/ffmpeg-formats.html deleted file mode 100644 index 8e0b3f4..0000000 --- a/Music/ffmpeg/doc/ffmpeg-formats.html +++ /dev/null @@ -1,3197 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ --> - <head> - <meta charset="utf-8"> - <title> - FFmpeg Formats Documentation - </title> - <meta name="viewport" content="width=device-width,initial-scale=1.0"> - <link rel="stylesheet" type="text/css" href="bootstrap.min.css"> - <link rel="stylesheet" type="text/css" href="style.min.css"> - </head> - <body> - <div class="container"> - <h1> - FFmpeg Formats Documentation - </h1> -<div align="center"> -</div> - - -<a name="SEC_Top"></a> - -<a name="SEC_Contents"></a> -<h2 class="contents-heading">Table of Contents</h2> - -<div class="contents"> - -<ul class="no-bullet"> - <li><a name="toc-Description" href="#Description">1 Description</a></li> - <li><a name="toc-Format-Options" href="#Format-Options">2 Format Options</a> - <ul class="no-bullet"> - <li><a name="toc-Format-stream-specifiers-1" href="#Format-stream-specifiers-1">2.1 Format stream specifiers</a></li> - </ul></li> - <li><a name="toc-Demuxers" href="#Demuxers">3 Demuxers</a> - <ul class="no-bullet"> - <li><a name="toc-aa" href="#aa">3.1 aa</a></li> - <li><a name="toc-applehttp" href="#applehttp">3.2 applehttp</a></li> - <li><a name="toc-apng" href="#apng">3.3 apng</a></li> - <li><a name="toc-asf-1" href="#asf-1">3.4 asf</a></li> - <li><a name="toc-concat-1" href="#concat-1">3.5 concat</a> - <ul class="no-bullet"> - <li><a name="toc-Syntax" href="#Syntax">3.5.1 Syntax</a></li> - <li><a name="toc-Options" href="#Options">3.5.2 Options</a></li> - <li><a name="toc-Examples" href="#Examples">3.5.3 Examples</a></li> - </ul></li> - <li><a name="toc-flv" href="#flv">3.6 flv</a></li> - <li><a name="toc-libgme" href="#libgme">3.7 libgme</a></li> - <li><a name="toc-libopenmpt" href="#libopenmpt">3.8 libopenmpt</a></li> - <li><a name="toc-gif-1" href="#gif-1">3.9 gif</a></li> - <li><a name="toc-image2-1" href="#image2-1">3.10 image2</a> - <ul class="no-bullet"> - <li><a name="toc-Examples-1" href="#Examples-1">3.10.1 Examples</a></li> - </ul></li> - <li><a name="toc-mov_002fmp4_002f3gp_002fQuickTime" href="#mov_002fmp4_002f3gp_002fQuickTime">3.11 mov/mp4/3gp/QuickTime</a></li> - <li><a name="toc-mpegts" href="#mpegts">3.12 mpegts</a></li> - <li><a name="toc-mpjpeg" href="#mpjpeg">3.13 mpjpeg</a></li> - <li><a name="toc-rawvideo" href="#rawvideo">3.14 rawvideo</a></li> - <li><a name="toc-sbg" href="#sbg">3.15 sbg</a></li> - <li><a name="toc-tedcaptions" href="#tedcaptions">3.16 tedcaptions</a></li> - </ul></li> - <li><a name="toc-Muxers" href="#Muxers">4 Muxers</a> - <ul class="no-bullet"> - <li><a name="toc-aiff-1" href="#aiff-1">4.1 aiff</a> - <ul class="no-bullet"> - <li><a name="toc-Options-1" href="#Options-1">4.1.1 Options</a></li> - </ul></li> - <li><a name="toc-asf-2" href="#asf-2">4.2 asf</a> - <ul class="no-bullet"> - <li><a name="toc-Options-2" href="#Options-2">4.2.1 Options</a></li> - </ul></li> - <li><a name="toc-chromaprint-1" href="#chromaprint-1">4.3 chromaprint</a> - <ul class="no-bullet"> - <li><a name="toc-Options-3" href="#Options-3">4.3.1 Options</a></li> - </ul></li> - <li><a name="toc-crc-1" href="#crc-1">4.4 crc</a> - <ul class="no-bullet"> - <li><a name="toc-Examples-2" href="#Examples-2">4.4.1 Examples</a></li> - </ul></li> - <li><a name="toc-flv-1" href="#flv-1">4.5 flv</a></li> - <li><a name="toc-framecrc-1" href="#framecrc-1">4.6 framecrc</a> - <ul class="no-bullet"> - <li><a name="toc-Examples-3" href="#Examples-3">4.6.1 Examples</a></li> - </ul></li> - <li><a name="toc-framehash-1" href="#framehash-1">4.7 framehash</a> - <ul class="no-bullet"> - <li><a name="toc-Examples-4" href="#Examples-4">4.7.1 Examples</a></li> - </ul></li> - <li><a name="toc-framemd5-1" href="#framemd5-1">4.8 framemd5</a> - <ul class="no-bullet"> - <li><a name="toc-Examples-5" href="#Examples-5">4.8.1 Examples</a></li> - </ul></li> - <li><a name="toc-gif-2" href="#gif-2">4.9 gif</a></li> - <li><a name="toc-hash-1" href="#hash-1">4.10 hash</a> - <ul class="no-bullet"> - <li><a name="toc-Examples-6" href="#Examples-6">4.10.1 Examples</a></li> - </ul></li> - <li><a name="toc-hls-1" href="#hls-1">4.11 hls</a> - <ul class="no-bullet"> - <li><a name="toc-Options-4" href="#Options-4">4.11.1 Options</a></li> - </ul></li> - <li><a name="toc-ico-1" href="#ico-1">4.12 ico</a></li> - <li><a name="toc-image2-2" href="#image2-2">4.13 image2</a> - <ul class="no-bullet"> - <li><a name="toc-Examples-7" href="#Examples-7">4.13.1 Examples</a></li> - <li><a name="toc-Options-5" href="#Options-5">4.13.2 Options</a></li> - </ul></li> - <li><a name="toc-matroska" href="#matroska">4.14 matroska</a> - <ul class="no-bullet"> - <li><a name="toc-Metadata" href="#Metadata">4.14.1 Metadata</a></li> - <li><a name="toc-Options-6" href="#Options-6">4.14.2 Options</a></li> - </ul></li> - <li><a name="toc-md5-1" href="#md5-1">4.15 md5</a> - <ul class="no-bullet"> - <li><a name="toc-Examples-8" href="#Examples-8">4.15.1 Examples</a></li> - </ul></li> - <li><a name="toc-mov_002c-mp4_002c-ismv" href="#mov_002c-mp4_002c-ismv">4.16 mov, mp4, ismv</a> - <ul class="no-bullet"> - <li><a name="toc-Options-7" href="#Options-7">4.16.1 Options</a></li> - <li><a name="toc-Example" href="#Example">4.16.2 Example</a></li> - <li><a name="toc-Audible-AAX" href="#Audible-AAX">4.16.3 Audible AAX</a></li> - </ul></li> - <li><a name="toc-mp3" href="#mp3">4.17 mp3</a></li> - <li><a name="toc-mpegts-1" href="#mpegts-1">4.18 mpegts</a> - <ul class="no-bullet"> - <li><a name="toc-Options-8" href="#Options-8">4.18.1 Options</a></li> - <li><a name="toc-Example-1" href="#Example-1">4.18.2 Example</a></li> - </ul></li> - <li><a name="toc-mxf_002c-mxf_005fd10" href="#mxf_002c-mxf_005fd10">4.19 mxf, mxf_d10</a> - <ul class="no-bullet"> - <li><a name="toc-Options-9" href="#Options-9">4.19.1 Options</a></li> - </ul></li> - <li><a name="toc-null" href="#null">4.20 null</a></li> - <li><a name="toc-nut" href="#nut">4.21 nut</a></li> - <li><a name="toc-ogg" href="#ogg">4.22 ogg</a></li> - <li><a name="toc-segment_002c-stream_005fsegment_002c-ssegment" href="#segment_002c-stream_005fsegment_002c-ssegment">4.23 segment, stream_segment, ssegment</a> - <ul class="no-bullet"> - <li><a name="toc-Options-10" href="#Options-10">4.23.1 Options</a></li> - <li><a name="toc-Examples-9" href="#Examples-9">4.23.2 Examples</a></li> - </ul></li> - <li><a name="toc-smoothstreaming" href="#smoothstreaming">4.24 smoothstreaming</a></li> - <li><a name="toc-fifo" href="#fifo">4.25 fifo</a> - <ul class="no-bullet"> - <li><a name="toc-Examples-10" href="#Examples-10">4.25.1 Examples</a></li> - </ul></li> - <li><a name="toc-tee-1" href="#tee-1">4.26 tee</a> - <ul class="no-bullet"> - <li><a name="toc-Examples-11" href="#Examples-11">4.26.1 Examples</a></li> - </ul></li> - <li><a name="toc-webm_005fdash_005fmanifest" href="#webm_005fdash_005fmanifest">4.27 webm_dash_manifest</a> - <ul class="no-bullet"> - <li><a name="toc-Options-11" href="#Options-11">4.27.1 Options</a></li> - <li><a name="toc-Example-2" href="#Example-2">4.27.2 Example</a></li> - </ul></li> - <li><a name="toc-webm_005fchunk" href="#webm_005fchunk">4.28 webm_chunk</a> - <ul class="no-bullet"> - <li><a name="toc-Options-12" href="#Options-12">4.28.1 Options</a></li> - <li><a name="toc-Example-3" href="#Example-3">4.28.2 Example</a></li> - </ul></li> - </ul></li> - <li><a name="toc-Metadata-1" href="#Metadata-1">5 Metadata</a></li> - <li><a name="toc-See-Also" href="#See-Also">6 See Also</a></li> - <li><a name="toc-Authors" href="#Authors">7 Authors</a></li> -</ul> -</div> - - -<a name="Description"></a> -<h2 class="chapter">1 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> - -<p>This document describes the supported formats (muxers and demuxers) -provided by the libavformat library. -</p> - -<a name="Format-Options"></a> -<h2 class="chapter">2 Format Options<span class="pull-right"><a class="anchor hidden-xs" href="#Format-Options" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Format-Options" aria-hidden="true">TOC</a></span></h2> - -<p>The libavformat library provides some generic global options, which -can be set on all the muxers and demuxers. In addition each muxer or -demuxer may support so-called private options, which are specific for -that component. -</p> -<p>Options may be set by specifying -<var>option</var> <var>value</var> in the -FFmpeg tools, or by setting the value explicitly in the -<code>AVFormatContext</code> options or using the <samp>libavutil/opt.h</samp> API -for programmatic use. -</p> -<p>The list of supported options follows: -</p> -<dl compact="compact"> -<dt><samp>avioflags <var>flags</var> (<em>input/output</em>)</samp></dt> -<dd><p>Possible values: -</p><dl compact="compact"> -<dt>‘<samp>direct</samp>’</dt> -<dd><p>Reduce buffering. -</p></dd> -</dl> - -</dd> -<dt><samp>probesize <var>integer</var> (<em>input</em>)</samp></dt> -<dd><p>Set probing size in bytes, i.e. the size of the data to analyze to get -stream information. A higher value will enable detecting more -information in case it is dispersed into the stream, but will increase -latency. Must be an integer not lesser than 32. It is 5000000 by default. -</p> -</dd> -<dt><samp>packetsize <var>integer</var> (<em>output</em>)</samp></dt> -<dd><p>Set packet size. -</p> -</dd> -<dt><samp>fflags <var>flags</var> (<em>input/output</em>)</samp></dt> -<dd><p>Set format flags. -</p> -<p>Possible values: -</p><dl compact="compact"> -<dt>‘<samp>ignidx</samp>’</dt> -<dd><p>Ignore index. -</p></dd> -<dt>‘<samp>fastseek</samp>’</dt> -<dd><p>Enable fast, but inaccurate seeks for some formats. -</p></dd> -<dt>‘<samp>genpts</samp>’</dt> -<dd><p>Generate PTS. -</p></dd> -<dt>‘<samp>nofillin</samp>’</dt> -<dd><p>Do not fill in missing values that can be exactly calculated. -</p></dd> -<dt>‘<samp>noparse</samp>’</dt> -<dd><p>Disable AVParsers, this needs <code>+nofillin</code> too. -</p></dd> -<dt>‘<samp>igndts</samp>’</dt> -<dd><p>Ignore DTS. -</p></dd> -<dt>‘<samp>discardcorrupt</samp>’</dt> -<dd><p>Discard corrupted frames. -</p></dd> -<dt>‘<samp>sortdts</samp>’</dt> -<dd><p>Try to interleave output packets by DTS. -</p></dd> -<dt>‘<samp>keepside</samp>’</dt> -<dd><p>Do not merge side data. -</p></dd> -<dt>‘<samp>latm</samp>’</dt> -<dd><p>Enable RTP MP4A-LATM payload. -</p></dd> -<dt>‘<samp>nobuffer</samp>’</dt> -<dd><p>Reduce the latency introduced by optional buffering -</p></dd> -<dt>‘<samp>bitexact</samp>’</dt> -<dd><p>Only write platform-, build- and time-independent data. -This ensures that file and data checksums are reproducible and match between -platforms. Its primary use is for regression testing. -</p></dd> -<dt>‘<samp>shortest</samp>’</dt> -<dd><p>Stop muxing at the end of the shortest stream. -It may be needed to increase max_interleave_delta to avoid flusing the longer -streams before EOF. -</p></dd> -</dl> - -</dd> -<dt><samp>seek2any <var>integer</var> (<em>input</em>)</samp></dt> -<dd><p>Allow seeking to non-keyframes on demuxer level when supported if set to 1. -Default is 0. -</p> -</dd> -<dt><samp>analyzeduration <var>integer</var> (<em>input</em>)</samp></dt> -<dd><p>Specify how many microseconds are analyzed to probe the input. A -higher value will enable detecting more accurate information, but will -increase latency. It defaults to 5,000,000 microseconds = 5 seconds. -</p> -</dd> -<dt><samp>cryptokey <var>hexadecimal string</var> (<em>input</em>)</samp></dt> -<dd><p>Set decryption key. -</p> -</dd> -<dt><samp>indexmem <var>integer</var> (<em>input</em>)</samp></dt> -<dd><p>Set max memory used for timestamp index (per stream). -</p> -</dd> -<dt><samp>rtbufsize <var>integer</var> (<em>input</em>)</samp></dt> -<dd><p>Set max memory used for buffering real-time frames. -</p> -</dd> -<dt><samp>fdebug <var>flags</var> (<em>input/output</em>)</samp></dt> -<dd><p>Print specific debug info. -</p> -<p>Possible values: -</p><dl compact="compact"> -<dt>‘<samp>ts</samp>’</dt> -</dl> - -</dd> -<dt><samp>max_delay <var>integer</var> (<em>input/output</em>)</samp></dt> -<dd><p>Set maximum muxing or demuxing delay in microseconds. -</p> -</dd> -<dt><samp>fpsprobesize <var>integer</var> (<em>input</em>)</samp></dt> -<dd><p>Set number of frames used to probe fps. -</p> -</dd> -<dt><samp>audio_preload <var>integer</var> (<em>output</em>)</samp></dt> -<dd><p>Set microseconds by which audio packets should be interleaved earlier. -</p> -</dd> -<dt><samp>chunk_duration <var>integer</var> (<em>output</em>)</samp></dt> -<dd><p>Set microseconds for each chunk. -</p> -</dd> -<dt><samp>chunk_size <var>integer</var> (<em>output</em>)</samp></dt> -<dd><p>Set size in bytes for each chunk. -</p> -</dd> -<dt><samp>err_detect, f_err_detect <var>flags</var> (<em>input</em>)</samp></dt> -<dd><p>Set error detection flags. <code>f_err_detect</code> is deprecated and -should be used only via the <code>ffmpeg</code> tool. -</p> -<p>Possible values: -</p><dl compact="compact"> -<dt>‘<samp>crccheck</samp>’</dt> -<dd><p>Verify embedded CRCs. -</p></dd> -<dt>‘<samp>bitstream</samp>’</dt> -<dd><p>Detect bitstream specification deviations. -</p></dd> -<dt>‘<samp>buffer</samp>’</dt> -<dd><p>Detect improper bitstream length. -</p></dd> -<dt>‘<samp>explode</samp>’</dt> -<dd><p>Abort decoding on minor error detection. -</p></dd> -<dt>‘<samp>careful</samp>’</dt> -<dd><p>Consider things that violate the spec and have not been seen in the -wild as errors. -</p></dd> -<dt>‘<samp>compliant</samp>’</dt> -<dd><p>Consider all spec non compliancies as errors. -</p></dd> -<dt>‘<samp>aggressive</samp>’</dt> -<dd><p>Consider things that a sane encoder should not do as an error. -</p></dd> -</dl> - -</dd> -<dt><samp>max_interleave_delta <var>integer</var> (<em>output</em>)</samp></dt> -<dd><p>Set maximum buffering duration for interleaving. The duration is -expressed in microseconds, and defaults to 1000000 (1 second). -</p> -<p>To ensure all the streams are interleaved correctly, libavformat will -wait until it has at least one packet for each stream before actually -writing any packets to the output file. When some streams are -"sparse" (i.e. there are large gaps between successive packets), this -can result in excessive buffering. -</p> -<p>This field specifies the maximum difference between the timestamps of the -first and the last packet in the muxing queue, above which libavformat -will output a packet regardless of whether it has queued a packet for all -the streams. -</p> -<p>If set to 0, libavformat will continue buffering packets until it has -a packet for each stream, regardless of the maximum timestamp -difference between the buffered packets. -</p> -</dd> -<dt><samp>use_wallclock_as_timestamps <var>integer</var> (<em>input</em>)</samp></dt> -<dd><p>Use wallclock as timestamps if set to 1. Default is 0. -</p> -</dd> -<dt><samp>avoid_negative_ts <var>integer</var> (<em>output</em>)</samp></dt> -<dd> -<p>Possible values: -</p><dl compact="compact"> -<dt>‘<samp>make_non_negative</samp>’</dt> -<dd><p>Shift timestamps to make them non-negative. -Also note that this affects only leading negative timestamps, and not -non-monotonic negative timestamps. -</p></dd> -<dt>‘<samp>make_zero</samp>’</dt> -<dd><p>Shift timestamps so that the first timestamp is 0. -</p></dd> -<dt>‘<samp>auto (default)</samp>’</dt> -<dd><p>Enables shifting when required by the target format. -</p></dd> -<dt>‘<samp>disabled</samp>’</dt> -<dd><p>Disables shifting of timestamp. -</p></dd> -</dl> - -<p>When shifting is enabled, all output timestamps are shifted by the -same amount. Audio, video, and subtitles desynching and relative -timestamp differences are preserved compared to how they would have -been without shifting. -</p> -</dd> -<dt><samp>skip_initial_bytes <var>integer</var> (<em>input</em>)</samp></dt> -<dd><p>Set number of bytes to skip before reading header and frames if set to 1. -Default is 0. -</p> -</dd> -<dt><samp>correct_ts_overflow <var>integer</var> (<em>input</em>)</samp></dt> -<dd><p>Correct single timestamp overflows if set to 1. Default is 1. -</p> -</dd> -<dt><samp>flush_packets <var>integer</var> (<em>output</em>)</samp></dt> -<dd><p>Flush the underlying I/O stream after each packet. Default 1 enables it, and -has the effect of reducing the latency; 0 disables it and may slightly -increase performance in some cases. -</p> -</dd> -<dt><samp>output_ts_offset <var>offset</var> (<em>output</em>)</samp></dt> -<dd><p>Set the output time offset. -</p> -<p><var>offset</var> must be a time duration specification, -see <a href="ffmpeg-utils.html#time-duration-syntax">(ffmpeg-utils)the Time duration section in the ffmpeg-utils(1) manual</a>. -</p> -<p>The offset is added by the muxer to the output timestamps. -</p> -<p>Specifying a positive offset means that the corresponding streams are -delayed bt the time duration specified in <var>offset</var>. Default value -is <code>0</code> (meaning that no offset is applied). -</p> -</dd> -<dt><samp>format_whitelist <var>list</var> (<em>input</em>)</samp></dt> -<dd><p>"," separated list of allowed demuxers. By default all are allowed. -</p> -</dd> -<dt><samp>dump_separator <var>string</var> (<em>input</em>)</samp></dt> -<dd><p>Separator used to separate the fields printed on the command line about the -Stream parameters. -For example to separate the fields with newlines and indention: -</p><div class="example"> -<pre class="example">ffprobe -dump_separator " - " -i ~/videos/matrixbench_mpeg2.mpg -</pre></div> -</dd> -</dl> - - -<a name="Format-stream-specifiers"></a><a name="Format-stream-specifiers-1"></a> -<h3 class="section">2.1 Format stream specifiers<span class="pull-right"><a class="anchor hidden-xs" href="#Format-stream-specifiers-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Format-stream-specifiers-1" aria-hidden="true">TOC</a></span></h3> - -<p>Format stream specifiers allow selection of one or more streams that -match specific properties. -</p> -<p>Possible forms of stream specifiers are: -</p><dl compact="compact"> -<dt><samp><var>stream_index</var></samp></dt> -<dd><p>Matches the stream with this index. -</p> -</dd> -<dt><samp><var>stream_type</var>[:<var>stream_index</var>]</samp></dt> -<dd><p><var>stream_type</var> is one of following: ’v’ for video, ’a’ for audio, -’s’ for subtitle, ’d’ for data, and ’t’ for attachments. If -<var>stream_index</var> is given, then it matches the stream number -<var>stream_index</var> of this type. Otherwise, it matches all streams of -this type. -</p> -</dd> -<dt><samp>p:<var>program_id</var>[:<var>stream_index</var>]</samp></dt> -<dd><p>If <var>stream_index</var> is given, then it matches the stream with number -<var>stream_index</var> in the program with the id -<var>program_id</var>. Otherwise, it matches all streams in the program. -</p> -</dd> -<dt><samp>#<var>stream_id</var></samp></dt> -<dd><p>Matches the stream by a format-specific ID. -</p></dd> -</dl> - -<p>The exact semantics of stream specifiers is defined by the -<code>avformat_match_stream_specifier()</code> function declared in the -<samp>libavformat/avformat.h</samp> header. -</p> -<a name="Demuxers"></a> -<h2 class="chapter">3 Demuxers<span class="pull-right"><a class="anchor hidden-xs" href="#Demuxers" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Demuxers" aria-hidden="true">TOC</a></span></h2> - -<p>Demuxers are configured elements in FFmpeg that can read the -multimedia streams from a particular type of file. -</p> -<p>When you configure your FFmpeg build, all the supported demuxers -are enabled by default. You can list all available ones using the -configure option <code>--list-demuxers</code>. -</p> -<p>You can disable all the demuxers using the configure option -<code>--disable-demuxers</code>, and selectively enable a single demuxer with -the option <code>--enable-demuxer=<var>DEMUXER</var></code>, or disable it -with the option <code>--disable-demuxer=<var>DEMUXER</var></code>. -</p> -<p>The option <code>-formats</code> of the ff* tools will display the list of -enabled demuxers. -</p> -<p>The description of some of the currently available demuxers follows. -</p> -<a name="aa"></a> -<h3 class="section">3.1 aa<span class="pull-right"><a class="anchor hidden-xs" href="#aa" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-aa" aria-hidden="true">TOC</a></span></h3> - -<p>Audible Format 2, 3, and 4 demuxer. -</p> -<p>This demuxer is used to demux Audible Format 2, 3, and 4 (.aa) files. -</p> -<a name="applehttp"></a> -<h3 class="section">3.2 applehttp<span class="pull-right"><a class="anchor hidden-xs" href="#applehttp" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-applehttp" aria-hidden="true">TOC</a></span></h3> - -<p>Apple HTTP Live Streaming demuxer. -</p> -<p>This demuxer presents all AVStreams from all variant streams. -The id field is set to the bitrate variant index number. By setting -the discard flags on AVStreams (by pressing ’a’ or ’v’ in ffplay), -the caller can decide which variant streams to actually receive. -The total bitrate of the variant that the stream belongs to is -available in a metadata key named "variant_bitrate". -</p> -<a name="apng"></a> -<h3 class="section">3.3 apng<span class="pull-right"><a class="anchor hidden-xs" href="#apng" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-apng" aria-hidden="true">TOC</a></span></h3> - -<p>Animated Portable Network Graphics demuxer. -</p> -<p>This demuxer is used to demux APNG files. -All headers, but the PNG signature, up to (but not including) the first -fcTL chunk are transmitted as extradata. -Frames are then split as being all the chunks between two fcTL ones, or -between the last fcTL and IEND chunks. -</p> -<dl compact="compact"> -<dt><samp>-ignore_loop <var>bool</var></samp></dt> -<dd><p>Ignore the loop variable in the file if set. -</p></dd> -<dt><samp>-max_fps <var>int</var></samp></dt> -<dd><p>Maximum framerate in frames per second (0 for no limit). -</p></dd> -<dt><samp>-default_fps <var>int</var></samp></dt> -<dd><p>Default framerate in frames per second when none is specified in the file -(0 meaning as fast as possible). -</p></dd> -</dl> - -<a name="asf-1"></a> -<h3 class="section">3.4 asf<span class="pull-right"><a class="anchor hidden-xs" href="#asf-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-asf-1" aria-hidden="true">TOC</a></span></h3> - -<p>Advanced Systems Format demuxer. -</p> -<p>This demuxer is used to demux ASF files and MMS network streams. -</p> -<dl compact="compact"> -<dt><samp>-no_resync_search <var>bool</var></samp></dt> -<dd><p>Do not try to resynchronize by looking for a certain optional start code. -</p></dd> -</dl> - -<a name="concat"></a><a name="concat-1"></a> -<h3 class="section">3.5 concat<span class="pull-right"><a class="anchor hidden-xs" href="#concat-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-concat-1" aria-hidden="true">TOC</a></span></h3> - -<p>Virtual concatenation script demuxer. -</p> -<p>This demuxer reads a list of files and other directives from a text file and -demuxes them one after the other, as if all their packets had been muxed -together. -</p> -<p>The timestamps in the files are adjusted so that the first file starts at 0 -and each next file starts where the previous one finishes. Note that it is -done globally and may cause gaps if all streams do not have exactly the same -length. -</p> -<p>All files must have the same streams (same codecs, same time base, etc.). -</p> -<p>The duration of each file is used to adjust the timestamps of the next file: -if the duration is incorrect (because it was computed using the bit-rate or -because the file is truncated, for example), it can cause artifacts. The -<code>duration</code> directive can be used to override the duration stored in -each file. -</p> -<a name="Syntax"></a> -<h4 class="subsection">3.5.1 Syntax<span class="pull-right"><a class="anchor hidden-xs" href="#Syntax" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Syntax" aria-hidden="true">TOC</a></span></h4> - -<p>The script is a text file in extended-ASCII, with one directive per line. -Empty lines, leading spaces and lines starting with ’#’ are ignored. The -following directive is recognized: -</p> -<dl compact="compact"> -<dt><samp><code>file <var>path</var></code></samp></dt> -<dd><p>Path to a file to read; special characters and spaces must be escaped with -backslash or single quotes. -</p> -<p>All subsequent file-related directives apply to that file. -</p> -</dd> -<dt><samp><code>ffconcat version 1.0</code></samp></dt> -<dd><p>Identify the script type and version. It also sets the <samp>safe</samp> option -to 1 if it was -1. -</p> -<p>To make FFmpeg recognize the format automatically, this directive must -appear exactly as is (no extra space or byte-order-mark) on the very first -line of the script. -</p> -</dd> -<dt><samp><code>duration <var>dur</var></code></samp></dt> -<dd><p>Duration of the file. This information can be specified from the file; -specifying it here may be more efficient or help if the information from the -file is not available or accurate. -</p> -<p>If the duration is set for all files, then it is possible to seek in the -whole concatenated video. -</p> -</dd> -<dt><samp><code>inpoint <var>timestamp</var></code></samp></dt> -<dd><p>In point of the file. When the demuxer opens the file it instantly seeks to the -specified timestamp. Seeking is done so that all streams can be presented -successfully at In point. -</p> -<p>This directive works best with intra frame codecs, because for non-intra frame -ones you will usually get extra packets before the actual In point and the -decoded content will most likely contain frames before In point too. -</p> -<p>For each file, packets before the file In point will have timestamps less than -the calculated start timestamp of the file (negative in case of the first -file), and the duration of the files (if not specified by the <code>duration</code> -directive) will be reduced based on their specified In point. -</p> -<p>Because of potential packets before the specified In point, packet timestamps -may overlap between two concatenated files. -</p> -</dd> -<dt><samp><code>outpoint <var>timestamp</var></code></samp></dt> -<dd><p>Out point of the file. When the demuxer reaches the specified decoding -timestamp in any of the streams, it handles it as an end of file condition and -skips the current and all the remaining packets from all streams. -</p> -<p>Out point is exclusive, which means that the demuxer will not output packets -with a decoding timestamp greater or equal to Out point. -</p> -<p>This directive works best with intra frame codecs and formats where all streams -are tightly interleaved. For non-intra frame codecs you will usually get -additional packets with presentation timestamp after Out point therefore the -decoded content will most likely contain frames after Out point too. If your -streams are not tightly interleaved you may not get all the packets from all -streams before Out point and you may only will be able to decode the earliest -stream until Out point. -</p> -<p>The duration of the files (if not specified by the <code>duration</code> -directive) will be reduced based on their specified Out point. -</p> -</dd> -<dt><samp><code>file_packet_metadata <var>key=value</var></code></samp></dt> -<dd><p>Metadata of the packets of the file. The specified metadata will be set for -each file packet. You can specify this directive multiple times to add multiple -metadata entries. -</p> -</dd> -<dt><samp><code>stream</code></samp></dt> -<dd><p>Introduce a stream in the virtual file. -All subsequent stream-related directives apply to the last introduced -stream. -Some streams properties must be set in order to allow identifying the -matching streams in the subfiles. -If no streams are defined in the script, the streams from the first file are -copied. -</p> -</dd> -<dt><samp><code>exact_stream_id <var>id</var></code></samp></dt> -<dd><p>Set the id of the stream. -If this directive is given, the string with the corresponding id in the -subfiles will be used. -This is especially useful for MPEG-PS (VOB) files, where the order of the -streams is not reliable. -</p> -</dd> -</dl> - -<a name="Options"></a> -<h4 class="subsection">3.5.2 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></h4> - -<p>This demuxer accepts the following option: -</p> -<dl compact="compact"> -<dt><samp>safe</samp></dt> -<dd><p>If set to 1, reject unsafe file paths. A file path is considered safe if it -does not contain a protocol specification and is relative and all components -only contain characters from the portable character set (letters, digits, -period, underscore and hyphen) and have no period at the beginning of a -component. -</p> -<p>If set to 0, any file name is accepted. -</p> -<p>The default is 1. -</p> -<p>-1 is equivalent to 1 if the format was automatically -probed and 0 otherwise. -</p> -</dd> -<dt><samp>auto_convert</samp></dt> -<dd><p>If set to 1, try to perform automatic conversions on packet data to make the -streams concatenable. -The default is 1. -</p> -<p>Currently, the only conversion is adding the h264_mp4toannexb bitstream -filter to H.264 streams in MP4 format. This is necessary in particular if -there are resolution changes. -</p> -</dd> -<dt><samp>segment_time_metadata</samp></dt> -<dd><p>If set to 1, every packet will contain the <var>lavf.concat.start_time</var> and the -<var>lavf.concat.duration</var> packet metadata values which are the start_time and -the duration of the respective file segments in the concatenated output -expressed in microseconds. The duration metadata is only set if it is known -based on the concat file. -The default is 0. -</p> -</dd> -</dl> - -<a name="Examples"></a> -<h4 class="subsection">3.5.3 Examples<span class="pull-right"><a class="anchor hidden-xs" href="#Examples" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Examples" aria-hidden="true">TOC</a></span></h4> - -<ul> -<li> Use absolute filenames and include some comments: -<div class="example"> -<pre class="example"># my first filename -file /mnt/share/file-1.wav -# my second filename including whitespace -file '/mnt/share/file 2.wav' -# my third filename including whitespace plus single quote -file '/mnt/share/file 3'\''.wav' -</pre></div> - -</li><li> Allow for input format auto-probing, use safe filenames and set the duration of -the first file: -<div class="example"> -<pre class="example">ffconcat version 1.0 - -file file-1.wav -duration 20.0 - -file subdir/file-2.wav -</pre></div> -</li></ul> - -<a name="flv"></a> -<h3 class="section">3.6 flv<span class="pull-right"><a class="anchor hidden-xs" href="#flv" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-flv" aria-hidden="true">TOC</a></span></h3> - -<p>Adobe Flash Video Format demuxer. -</p> -<p>This demuxer is used to demux FLV files and RTMP network streams. -</p> -<dl compact="compact"> -<dt><samp>-flv_metadata <var>bool</var></samp></dt> -<dd><p>Allocate the streams according to the onMetaData array content. -</p></dd> -</dl> - -<a name="libgme"></a> -<h3 class="section">3.7 libgme<span class="pull-right"><a class="anchor hidden-xs" href="#libgme" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-libgme" aria-hidden="true">TOC</a></span></h3> - -<p>The Game Music Emu library is a collection of video game music file emulators. -</p> -<p>See <a href="http://code.google.com/p/game-music-emu/">http://code.google.com/p/game-music-emu/</a> for more information. -</p> -<p>Some files have multiple tracks. The demuxer will pick the first track by -default. The <samp>track_index</samp> option can be used to select a different -track. Track indexes start at 0. The demuxer exports the number of tracks as -<var>tracks</var> meta data entry. -</p> -<p>For very large files, the <samp>max_size</samp> option may have to be adjusted. -</p> -<a name="libopenmpt"></a> -<h3 class="section">3.8 libopenmpt<span class="pull-right"><a class="anchor hidden-xs" href="#libopenmpt" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-libopenmpt" aria-hidden="true">TOC</a></span></h3> - -<p>libopenmpt based module demuxer -</p> -<p>See <a href="https://lib.openmpt.org/libopenmpt/">https://lib.openmpt.org/libopenmpt/</a> for more information. -</p> -<p>Some files have multiple subsongs (tracks) this can be set with the <samp>subsong</samp> -option. -</p> -<p>It accepts the following options: -</p> -<dl compact="compact"> -<dt><samp>subsong</samp></dt> -<dd><p>Set the subsong index. This can be either ’all’, ’auto’, or the index of the -subsong. Subsong indexes start at 0. The default is ’auto’. -</p> -<p>The default value is to let libopenmpt choose. -</p> -</dd> -<dt><samp>layout</samp></dt> -<dd><p>Set the channel layout. Valid values are 1, 2, and 4 channel layouts. -The default value is STEREO. -</p> -</dd> -<dt><samp>sample_rate</samp></dt> -<dd><p>Set the sample rate for libopenmpt to output. -Range is from 1000 to INT_MAX. The value default is 48000. -</p></dd> -</dl> - -<a name="gif-1"></a> -<h3 class="section">3.9 gif<span class="pull-right"><a class="anchor hidden-xs" href="#gif-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-gif-1" aria-hidden="true">TOC</a></span></h3> - -<p>Animated GIF demuxer. -</p> -<p>It accepts the following options: -</p> -<dl compact="compact"> -<dt><samp>min_delay</samp></dt> -<dd><p>Set the minimum valid delay between frames in hundredths of seconds. -Range is 0 to 6000. Default value is 2. -</p> -</dd> -<dt><samp>max_gif_delay</samp></dt> -<dd><p>Set the maximum valid delay between frames in hundredth of seconds. -Range is 0 to 65535. Default value is 65535 (nearly eleven minutes), -the maximum value allowed by the specification. -</p> -</dd> -<dt><samp>default_delay</samp></dt> -<dd><p>Set the default delay between frames in hundredths of seconds. -Range is 0 to 6000. Default value is 10. -</p> -</dd> -<dt><samp>ignore_loop</samp></dt> -<dd><p>GIF files can contain information to loop a certain number of times (or -infinitely). If <samp>ignore_loop</samp> is set to 1, then the loop setting -from the input will be ignored and looping will not occur. If set to 0, -then looping will occur and will cycle the number of times according to -the GIF. Default value is 1. -</p></dd> -</dl> - -<p>For example, with the overlay filter, place an infinitely looping GIF -over another video: -</p><div class="example"> -<pre class="example">ffmpeg -i input.mp4 -ignore_loop 0 -i input.gif -filter_complex overlay=shortest=1 out.mkv -</pre></div> - -<p>Note that in the above example the shortest option for overlay filter is -used to end the output video at the length of the shortest input file, -which in this case is <samp>input.mp4</samp> as the GIF in this example loops -infinitely. -</p> -<a name="image2-1"></a> -<h3 class="section">3.10 image2<span class="pull-right"><a class="anchor hidden-xs" href="#image2-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-image2-1" aria-hidden="true">TOC</a></span></h3> - -<p>Image file demuxer. -</p> -<p>This demuxer reads from a list of image files specified by a pattern. -The syntax and meaning of the pattern is specified by the -option <var>pattern_type</var>. -</p> -<p>The pattern may contain a suffix which is used to automatically -determine the format of the images contained in the files. -</p> -<p>The size, the pixel format, and the format of each image must be the -same for all the files in the sequence. -</p> -<p>This demuxer accepts the following options: -</p><dl compact="compact"> -<dt><samp>framerate</samp></dt> -<dd><p>Set the frame rate for the video stream. It defaults to 25. -</p></dd> -<dt><samp>loop</samp></dt> -<dd><p>If set to 1, loop over the input. Default value is 0. -</p></dd> -<dt><samp>pattern_type</samp></dt> -<dd><p>Select the pattern type used to interpret the provided filename. -</p> -<p><var>pattern_type</var> accepts one of the following values. -</p><dl compact="compact"> -<dt><samp>none</samp></dt> -<dd><p>Disable pattern matching, therefore the video will only contain the specified -image. You should use this option if you do not want to create sequences from -multiple images and your filenames may contain special pattern characters. -</p></dd> -<dt><samp>sequence</samp></dt> -<dd><p>Select a sequence pattern type, used to specify a sequence of files -indexed by sequential numbers. -</p> -<p>A sequence pattern may contain the string "%d" or "%0<var>N</var>d", which -specifies the position of the characters representing a sequential -number in each filename matched by the pattern. If the form -"%d0<var>N</var>d" is used, the string representing the number in each -filename is 0-padded and <var>N</var> is the total number of 0-padded -digits representing the number. The literal character ’%’ can be -specified in the pattern with the string "%%". -</p> -<p>If the sequence pattern contains "%d" or "%0<var>N</var>d", the first filename of -the file list specified by the pattern must contain a number -inclusively contained between <var>start_number</var> and -<var>start_number</var>+<var>start_number_range</var>-1, and all the following -numbers must be sequential. -</p> -<p>For example the pattern "img-%03d.bmp" will match a sequence of -filenames of the form <samp>img-001.bmp</samp>, <samp>img-002.bmp</samp>, ..., -<samp>img-010.bmp</samp>, etc.; the pattern "i%%m%%g-%d.jpg" will match a -sequence of filenames of the form <samp>i%m%g-1.jpg</samp>, -<samp>i%m%g-2.jpg</samp>, ..., <samp>i%m%g-10.jpg</samp>, etc. -</p> -<p>Note that the pattern must not necessarily contain "%d" or -"%0<var>N</var>d", for example to convert a single image file -<samp>img.jpeg</samp> you can employ the command: -</p><div class="example"> -<pre class="example">ffmpeg -i img.jpeg img.png -</pre></div> - -</dd> -<dt><samp>glob</samp></dt> -<dd><p>Select a glob wildcard pattern type. -</p> -<p>The pattern is interpreted like a <code>glob()</code> pattern. This is only -selectable if libavformat was compiled with globbing support. -</p> -</dd> -<dt><samp>glob_sequence <em>(deprecated, will be removed)</em></samp></dt> -<dd><p>Select a mixed glob wildcard/sequence pattern. -</p> -<p>If your version of libavformat was compiled with globbing support, and -the provided pattern contains at least one glob meta character among -<code>%*?[]{}</code> that is preceded by an unescaped "%", the pattern is -interpreted like a <code>glob()</code> pattern, otherwise it is interpreted -like a sequence pattern. -</p> -<p>All glob special characters <code>%*?[]{}</code> must be prefixed -with "%". To escape a literal "%" you shall use "%%". -</p> -<p>For example the pattern <code>foo-%*.jpeg</code> will match all the -filenames prefixed by "foo-" and terminating with ".jpeg", and -<code>foo-%?%?%?.jpeg</code> will match all the filenames prefixed with -"foo-", followed by a sequence of three characters, and terminating -with ".jpeg". -</p> -<p>This pattern type is deprecated in favor of <var>glob</var> and -<var>sequence</var>. -</p></dd> -</dl> - -<p>Default value is <var>glob_sequence</var>. -</p></dd> -<dt><samp>pixel_format</samp></dt> -<dd><p>Set the pixel format of the images to read. If not specified the pixel -format is guessed from the first image file in the sequence. -</p></dd> -<dt><samp>start_number</samp></dt> -<dd><p>Set the index of the file matched by the image file pattern to start -to read from. Default value is 0. -</p></dd> -<dt><samp>start_number_range</samp></dt> -<dd><p>Set the index interval range to check when looking for the first image -file in the sequence, starting from <var>start_number</var>. Default value -is 5. -</p></dd> -<dt><samp>ts_from_file</samp></dt> -<dd><p>If set to 1, will set frame timestamp to modification time of image file. Note -that monotonity of timestamps is not provided: images go in the same order as -without this option. Default value is 0. -If set to 2, will set frame timestamp to the modification time of the image file in -nanosecond precision. -</p></dd> -<dt><samp>video_size</samp></dt> -<dd><p>Set the video size of the images to read. If not specified the video -size is guessed from the first image file in the sequence. -</p></dd> -</dl> - -<a name="Examples-1"></a> -<h4 class="subsection">3.10.1 Examples<span class="pull-right"><a class="anchor hidden-xs" href="#Examples-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Examples-1" aria-hidden="true">TOC</a></span></h4> - -<ul> -<li> Use <code>ffmpeg</code> for creating a video from the images in the file -sequence <samp>img-001.jpeg</samp>, <samp>img-002.jpeg</samp>, ..., assuming an -input frame rate of 10 frames per second: -<div class="example"> -<pre class="example">ffmpeg -framerate 10 -i 'img-%03d.jpeg' out.mkv -</pre></div> - -</li><li> As above, but start by reading from a file with index 100 in the sequence: -<div class="example"> -<pre class="example">ffmpeg -framerate 10 -start_number 100 -i 'img-%03d.jpeg' out.mkv -</pre></div> - -</li><li> Read images matching the "*.png" glob pattern , that is all the files -terminating with the ".png" suffix: -<div class="example"> -<pre class="example">ffmpeg -framerate 10 -pattern_type glob -i "*.png" out.mkv -</pre></div> -</li></ul> - -<a name="mov_002fmp4_002f3gp_002fQuickTime"></a> -<h3 class="section">3.11 mov/mp4/3gp/QuickTime<span class="pull-right"><a class="anchor hidden-xs" href="#mov_002fmp4_002f3gp_002fQuickTime" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-mov_002fmp4_002f3gp_002fQuickTime" aria-hidden="true">TOC</a></span></h3> - -<p>QuickTime / MP4 demuxer. -</p> -<p>This demuxer accepts the following options: -</p><dl compact="compact"> -<dt><samp>enable_drefs</samp></dt> -<dd><p>Enable loading of external tracks, disabled by default. -Enabling this can theoretically leak information in some use cases. -</p> -</dd> -<dt><samp>use_absolute_path</samp></dt> -<dd><p>Allows loading of external tracks via absolute paths, disabled by default. -Enabling this poses a security risk. It should only be enabled if the source -is known to be non malicious. -</p> -</dd> -</dl> - -<a name="mpegts"></a> -<h3 class="section">3.12 mpegts<span class="pull-right"><a class="anchor hidden-xs" href="#mpegts" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-mpegts" aria-hidden="true">TOC</a></span></h3> - -<p>MPEG-2 transport stream demuxer. -</p> -<p>This demuxer accepts the following options: -</p><dl compact="compact"> -<dt><samp>resync_size</samp></dt> -<dd><p>Set size limit for looking up a new synchronization. Default value is -65536. -</p> -</dd> -<dt><samp>fix_teletext_pts</samp></dt> -<dd><p>Override teletext packet PTS and DTS values with the timestamps calculated -from the PCR of the first program which the teletext stream is part of and is -not discarded. Default value is 1, set this option to 0 if you want your -teletext packet PTS and DTS values untouched. -</p> -</dd> -<dt><samp>ts_packetsize</samp></dt> -<dd><p>Output option carrying the raw packet size in bytes. -Show the detected raw packet size, cannot be set by the user. -</p> -</dd> -<dt><samp>scan_all_pmts</samp></dt> -<dd><p>Scan and combine all PMTs. The value is an integer with value from -1 -to 1 (-1 means automatic setting, 1 means enabled, 0 means -disabled). Default value is -1. -</p></dd> -</dl> - -<a name="mpjpeg"></a> -<h3 class="section">3.13 mpjpeg<span class="pull-right"><a class="anchor hidden-xs" href="#mpjpeg" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-mpjpeg" aria-hidden="true">TOC</a></span></h3> - -<p>MJPEG encapsulated in multi-part MIME demuxer. -</p> -<p>This demuxer allows reading of MJPEG, where each frame is represented as a part of -multipart/x-mixed-replace stream. -</p><dl compact="compact"> -<dt><samp>strict_mime_boundary</samp></dt> -<dd><p>Default implementation applies a relaxed standard to multi-part MIME boundary detection, -to prevent regression with numerous existing endpoints not generating a proper MIME -MJPEG stream. Turning this option on by setting it to 1 will result in a stricter check -of the boundary value. -</p></dd> -</dl> - -<a name="rawvideo"></a> -<h3 class="section">3.14 rawvideo<span class="pull-right"><a class="anchor hidden-xs" href="#rawvideo" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-rawvideo" aria-hidden="true">TOC</a></span></h3> - -<p>Raw video demuxer. -</p> -<p>This demuxer allows one to read raw video data. Since there is no header -specifying the assumed video parameters, the user must specify them -in order to be able to decode the data correctly. -</p> -<p>This demuxer accepts the following options: -</p><dl compact="compact"> -<dt><samp>framerate</samp></dt> -<dd><p>Set input video frame rate. Default value is 25. -</p> -</dd> -<dt><samp>pixel_format</samp></dt> -<dd><p>Set the input video pixel format. Default value is <code>yuv420p</code>. -</p> -</dd> -<dt><samp>video_size</samp></dt> -<dd><p>Set the input video size. This value must be specified explicitly. -</p></dd> -</dl> - -<p>For example to read a rawvideo file <samp>input.raw</samp> with -<code>ffplay</code>, assuming a pixel format of <code>rgb24</code>, a video -size of <code>320x240</code>, and a frame rate of 10 images per second, use -the command: -</p><div class="example"> -<pre class="example">ffplay -f rawvideo -pixel_format rgb24 -video_size 320x240 -framerate 10 input.raw -</pre></div> - -<a name="sbg"></a> -<h3 class="section">3.15 sbg<span class="pull-right"><a class="anchor hidden-xs" href="#sbg" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-sbg" aria-hidden="true">TOC</a></span></h3> - -<p>SBaGen script demuxer. -</p> -<p>This demuxer reads the script language used by SBaGen -<a href="http://uazu.net/sbagen/">http://uazu.net/sbagen/</a> to generate binaural beats sessions. A SBG -script looks like that: -</p><div class="example"> -<pre class="example">-SE -a: 300-2.5/3 440+4.5/0 -b: 300-2.5/0 440+4.5/3 -off: - -NOW == a -+0:07:00 == b -+0:14:00 == a -+0:21:00 == b -+0:30:00 off -</pre></div> - -<p>A SBG script can mix absolute and relative timestamps. If the script uses -either only absolute timestamps (including the script start time) or only -relative ones, then its layout is fixed, and the conversion is -straightforward. On the other hand, if the script mixes both kind of -timestamps, then the <var>NOW</var> reference for relative timestamps will be -taken from the current time of day at the time the script is read, and the -script layout will be frozen according to that reference. That means that if -the script is directly played, the actual times will match the absolute -timestamps up to the sound controller’s clock accuracy, but if the user -somehow pauses the playback or seeks, all times will be shifted accordingly. -</p> -<a name="tedcaptions"></a> -<h3 class="section">3.16 tedcaptions<span class="pull-right"><a class="anchor hidden-xs" href="#tedcaptions" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-tedcaptions" aria-hidden="true">TOC</a></span></h3> - -<p>JSON captions used for <a href="http://www.ted.com/">TED Talks</a>. -</p> -<p>TED does not provide links to the captions, but they can be guessed from the -page. The file <samp>tools/bookmarklets.html</samp> from the FFmpeg source tree -contains a bookmarklet to expose them. -</p> -<p>This demuxer accepts the following option: -</p><dl compact="compact"> -<dt><samp>start_time</samp></dt> -<dd><p>Set the start time of the TED talk, in milliseconds. The default is 15000 -(15s). It is used to sync the captions with the downloadable videos, because -they include a 15s intro. -</p></dd> -</dl> - -<p>Example: convert the captions to a format most players understand: -</p><div class="example"> -<pre class="example">ffmpeg -i http://www.ted.com/talks/subtitles/id/1/lang/en talk1-en.srt -</pre></div> - -<a name="Muxers"></a> -<h2 class="chapter">4 Muxers<span class="pull-right"><a class="anchor hidden-xs" href="#Muxers" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Muxers" aria-hidden="true">TOC</a></span></h2> - -<p>Muxers are configured elements in FFmpeg which allow writing -multimedia streams to a particular type of file. -</p> -<p>When you configure your FFmpeg build, all the supported muxers -are enabled by default. You can list all available muxers using the -configure option <code>--list-muxers</code>. -</p> -<p>You can disable all the muxers with the configure option -<code>--disable-muxers</code> and selectively enable / disable single muxers -with the options <code>--enable-muxer=<var>MUXER</var></code> / -<code>--disable-muxer=<var>MUXER</var></code>. -</p> -<p>The option <code>-formats</code> of the ff* tools will display the list of -enabled muxers. -</p> -<p>A description of some of the currently available muxers follows. -</p> -<a name="aiff"></a><a name="aiff-1"></a> -<h3 class="section">4.1 aiff<span class="pull-right"><a class="anchor hidden-xs" href="#aiff-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-aiff-1" aria-hidden="true">TOC</a></span></h3> - -<p>Audio Interchange File Format muxer. -</p> -<a name="Options-1"></a> -<h4 class="subsection">4.1.1 Options<span class="pull-right"><a class="anchor hidden-xs" href="#Options-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Options-1" aria-hidden="true">TOC</a></span></h4> - -<p>It accepts the following options: -</p> -<dl compact="compact"> -<dt><samp>write_id3v2</samp></dt> -<dd><p>Enable ID3v2 tags writing when set to 1. Default is 0 (disabled). -</p> -</dd> -<dt><samp>id3v2_version</samp></dt> -<dd><p>Select ID3v2 version to write. Currently only version 3 and 4 (aka. -ID3v2.3 and ID3v2.4) are supported. The default is version 4. -</p> -</dd> -</dl> - -<a name="asf"></a><a name="asf-2"></a> -<h3 class="section">4.2 asf<span class="pull-right"><a class="anchor hidden-xs" href="#asf-2" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-asf-2" aria-hidden="true">TOC</a></span></h3> - -<p>Advanced Systems Format muxer. -</p> -<p>Note that Windows Media Audio (wma) and Windows Media Video (wmv) use this -muxer too. -</p> -<a name="Options-2"></a> -<h4 class="subsection">4.2.1 Options<span class="pull-right"><a class="anchor hidden-xs" href="#Options-2" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Options-2" aria-hidden="true">TOC</a></span></h4> - -<p>It accepts the following options: -</p> -<dl compact="compact"> -<dt><samp>packet_size</samp></dt> -<dd><p>Set the muxer packet size. By tuning this setting you may reduce data -fragmentation or muxer overhead depending on your source. Default value is -3200, minimum is 100, maximum is 64k. -</p> -</dd> -</dl> - -<a name="chromaprint"></a><a name="chromaprint-1"></a> -<h3 class="section">4.3 chromaprint<span class="pull-right"><a class="anchor hidden-xs" href="#chromaprint-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-chromaprint-1" aria-hidden="true">TOC</a></span></h3> - -<p>Chromaprint fingerprinter -</p> -<p>This muxer feeds audio data to the Chromaprint library, which generates -a fingerprint for the provided audio data. It takes a single signed -native-endian 16-bit raw audio stream. -</p> -<a name="Options-3"></a> -<h4 class="subsection">4.3.1 Options<span class="pull-right"><a class="anchor hidden-xs" href="#Options-3" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Options-3" aria-hidden="true">TOC</a></span></h4> - -<dl compact="compact"> -<dt><samp>silence_threshold</samp></dt> -<dd><p>Threshold for detecting silence, ranges from 0 to 32767. -1 for default -(required for use with the AcoustID service). -</p> -</dd> -<dt><samp>algorithm</samp></dt> -<dd><p>Algorithm index to fingerprint with. -</p> -</dd> -<dt><samp>fp_format</samp></dt> -<dd><p>Format to output the fingerprint as. Accepts the following options: -</p><dl compact="compact"> -<dt>‘<samp>raw</samp>’</dt> -<dd><p>Binary raw fingerprint -</p> -</dd> -<dt>‘<samp>compressed</samp>’</dt> -<dd><p>Binary compressed fingerprint -</p> -</dd> -<dt>‘<samp>base64</samp>’</dt> -<dd><p>Base64 compressed fingerprint -</p> -</dd> -</dl> - -</dd> -</dl> - -<a name="crc"></a><a name="crc-1"></a> -<h3 class="section">4.4 crc<span class="pull-right"><a class="anchor hidden-xs" href="#crc-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-crc-1" aria-hidden="true">TOC</a></span></h3> - -<p>CRC (Cyclic Redundancy Check) testing format. -</p> -<p>This muxer computes and prints the Adler-32 CRC of all the input audio -and video frames. By default audio frames are converted to signed -16-bit raw audio and video frames to raw video before computing the -CRC. -</p> -<p>The output of the muxer consists of a single line of the form: -CRC=0x<var>CRC</var>, where <var>CRC</var> is a hexadecimal number 0-padded to -8 digits containing the CRC for all the decoded input frames. -</p> -<p>See also the <a href="#framecrc">framecrc</a> muxer. -</p> -<a name="Examples-2"></a> -<h4 class="subsection">4.4.1 Examples<span class="pull-right"><a class="anchor hidden-xs" href="#Examples-2" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Examples-2" aria-hidden="true">TOC</a></span></h4> - -<p>For example to compute the CRC of the input, and store it in the file -<samp>out.crc</samp>: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -f crc out.crc -</pre></div> - -<p>You can print the CRC to stdout with the command: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -f crc - -</pre></div> - -<p>You can select the output format of each frame with <code>ffmpeg</code> by -specifying the audio and video codec and format. For example to -compute the CRC of the input audio converted to PCM unsigned 8-bit -and the input video converted to MPEG-2 video, use the command: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -c:a pcm_u8 -c:v mpeg2video -f crc - -</pre></div> - -<a name="flv-1"></a> -<h3 class="section">4.5 flv<span class="pull-right"><a class="anchor hidden-xs" href="#flv-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-flv-1" aria-hidden="true">TOC</a></span></h3> - -<p>Adobe Flash Video Format muxer. -</p> -<p>This muxer accepts the following options: -</p> -<dl compact="compact"> -<dt><samp>flvflags <var>flags</var></samp></dt> -<dd><p>Possible values: -</p> -<dl compact="compact"> -<dt>‘<samp>aac_seq_header_detect</samp>’</dt> -<dd><p>Place AAC sequence header based on audio stream data. -</p> -</dd> -<dt>‘<samp>no_sequence_end</samp>’</dt> -<dd><p>Disable sequence end tag. -</p></dd> -</dl> -</dd> -</dl> - -<a name="framecrc"></a><a name="framecrc-1"></a> -<h3 class="section">4.6 framecrc<span class="pull-right"><a class="anchor hidden-xs" href="#framecrc-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-framecrc-1" aria-hidden="true">TOC</a></span></h3> - -<p>Per-packet CRC (Cyclic Redundancy Check) testing format. -</p> -<p>This muxer computes and prints the Adler-32 CRC for each audio -and video packet. By default audio frames are converted to signed -16-bit raw audio and video frames to raw video before computing the -CRC. -</p> -<p>The output of the muxer consists of a line for each audio and video -packet of the form: -</p><div class="example"> -<pre class="example"><var>stream_index</var>, <var>packet_dts</var>, <var>packet_pts</var>, <var>packet_duration</var>, <var>packet_size</var>, 0x<var>CRC</var> -</pre></div> - -<p><var>CRC</var> is a hexadecimal number 0-padded to 8 digits containing the -CRC of the packet. -</p> -<a name="Examples-3"></a> -<h4 class="subsection">4.6.1 Examples<span class="pull-right"><a class="anchor hidden-xs" href="#Examples-3" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Examples-3" aria-hidden="true">TOC</a></span></h4> - -<p>For example to compute the CRC of the audio and video frames in -<samp>INPUT</samp>, converted to raw audio and video packets, and store it -in the file <samp>out.crc</samp>: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -f framecrc out.crc -</pre></div> - -<p>To print the information to stdout, use the command: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -f framecrc - -</pre></div> - -<p>With <code>ffmpeg</code>, you can select the output format to which the -audio and video frames are encoded before computing the CRC for each -packet by specifying the audio and video codec. For example, to -compute the CRC of each decoded input audio frame converted to PCM -unsigned 8-bit and of each decoded input video frame converted to -MPEG-2 video, use the command: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -c:a pcm_u8 -c:v mpeg2video -f framecrc - -</pre></div> - -<p>See also the <a href="#crc">crc</a> muxer. -</p> -<a name="framehash"></a><a name="framehash-1"></a> -<h3 class="section">4.7 framehash<span class="pull-right"><a class="anchor hidden-xs" href="#framehash-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-framehash-1" aria-hidden="true">TOC</a></span></h3> - -<p>Per-packet hash testing format. -</p> -<p>This muxer computes and prints a cryptographic hash for each audio -and video packet. This can be used for packet-by-packet equality -checks without having to individually do a binary comparison on each. -</p> -<p>By default audio frames are converted to signed 16-bit raw audio and -video frames to raw video before computing the hash, but the output -of explicit conversions to other codecs can also be used. It uses the -SHA-256 cryptographic hash function by default, but supports several -other algorithms. -</p> -<p>The output of the muxer consists of a line for each audio and video -packet of the form: -</p><div class="example"> -<pre class="example"><var>stream_index</var>, <var>packet_dts</var>, <var>packet_pts</var>, <var>packet_duration</var>, <var>packet_size</var>, <var>hash</var> -</pre></div> - -<p><var>hash</var> is a hexadecimal number representing the computed hash -for the packet. -</p> -<dl compact="compact"> -<dt><samp>hash <var>algorithm</var></samp></dt> -<dd><p>Use the cryptographic hash function specified by the string <var>algorithm</var>. -Supported values include <code>MD5</code>, <code>murmur3</code>, <code>RIPEMD128</code>, -<code>RIPEMD160</code>, <code>RIPEMD256</code>, <code>RIPEMD320</code>, <code>SHA160</code>, -<code>SHA224</code>, <code>SHA256</code> (default), <code>SHA512/224</code>, <code>SHA512/256</code>, -<code>SHA384</code>, <code>SHA512</code>, <code>CRC32</code> and <code>adler32</code>. -</p> -</dd> -</dl> - -<a name="Examples-4"></a> -<h4 class="subsection">4.7.1 Examples<span class="pull-right"><a class="anchor hidden-xs" href="#Examples-4" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Examples-4" aria-hidden="true">TOC</a></span></h4> - -<p>To compute the SHA-256 hash of the audio and video frames in <samp>INPUT</samp>, -converted to raw audio and video packets, and store it in the file -<samp>out.sha256</samp>: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -f framehash out.sha256 -</pre></div> - -<p>To print the information to stdout, using the MD5 hash function, use -the command: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -f framehash -hash md5 - -</pre></div> - -<p>See also the <a href="#hash">hash</a> muxer. -</p> -<a name="framemd5"></a><a name="framemd5-1"></a> -<h3 class="section">4.8 framemd5<span class="pull-right"><a class="anchor hidden-xs" href="#framemd5-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-framemd5-1" aria-hidden="true">TOC</a></span></h3> - -<p>Per-packet MD5 testing format. -</p> -<p>This is a variant of the <a href="#framehash">framehash</a> muxer. Unlike that muxer, -it defaults to using the MD5 hash function. -</p> -<a name="Examples-5"></a> -<h4 class="subsection">4.8.1 Examples<span class="pull-right"><a class="anchor hidden-xs" href="#Examples-5" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Examples-5" aria-hidden="true">TOC</a></span></h4> - -<p>To compute the MD5 hash of the audio and video frames in <samp>INPUT</samp>, -converted to raw audio and video packets, and store it in the file -<samp>out.md5</samp>: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -f framemd5 out.md5 -</pre></div> - -<p>To print the information to stdout, use the command: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -f framemd5 - -</pre></div> - -<p>See also the <a href="#framehash">framehash</a> and <a href="#md5">md5</a> muxers. -</p> -<a name="gif"></a><a name="gif-2"></a> -<h3 class="section">4.9 gif<span class="pull-right"><a class="anchor hidden-xs" href="#gif-2" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-gif-2" aria-hidden="true">TOC</a></span></h3> - -<p>Animated GIF muxer. -</p> -<p>It accepts the following options: -</p> -<dl compact="compact"> -<dt><samp>loop</samp></dt> -<dd><p>Set the number of times to loop the output. Use <code>-1</code> for no loop, <code>0</code> -for looping indefinitely (default). -</p> -</dd> -<dt><samp>final_delay</samp></dt> -<dd><p>Force the delay (expressed in centiseconds) after the last frame. Each frame -ends with a delay until the next frame. The default is <code>-1</code>, which is a -special value to tell the muxer to re-use the previous delay. In case of a -loop, you might want to customize this value to mark a pause for instance. -</p></dd> -</dl> - -<p>For example, to encode a gif looping 10 times, with a 5 seconds delay between -the loops: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -loop 10 -final_delay 500 out.gif -</pre></div> - -<p>Note 1: if you wish to extract the frames into separate GIF files, you need to -force the <a href="#image2">image2</a> muxer: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -c:v gif -f image2 "out%d.gif" -</pre></div> - -<p>Note 2: the GIF format has a very large time base: the delay between two frames -can therefore not be smaller than one centi second. -</p> -<a name="hash"></a><a name="hash-1"></a> -<h3 class="section">4.10 hash<span class="pull-right"><a class="anchor hidden-xs" href="#hash-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-hash-1" aria-hidden="true">TOC</a></span></h3> - -<p>Hash testing format. -</p> -<p>This muxer computes and prints a cryptographic hash of all the input -audio and video frames. This can be used for equality checks without -having to do a complete binary comparison. -</p> -<p>By default audio frames are converted to signed 16-bit raw audio and -video frames to raw video before computing the hash, but the output -of explicit conversions to other codecs can also be used. Timestamps -are ignored. It uses the SHA-256 cryptographic hash function by default, -but supports several other algorithms. -</p> -<p>The output of the muxer consists of a single line of the form: -<var>algo</var>=<var>hash</var>, where <var>algo</var> is a short string representing -the hash function used, and <var>hash</var> is a hexadecimal number -representing the computed hash. -</p> -<dl compact="compact"> -<dt><samp>hash <var>algorithm</var></samp></dt> -<dd><p>Use the cryptographic hash function specified by the string <var>algorithm</var>. -Supported values include <code>MD5</code>, <code>murmur3</code>, <code>RIPEMD128</code>, -<code>RIPEMD160</code>, <code>RIPEMD256</code>, <code>RIPEMD320</code>, <code>SHA160</code>, -<code>SHA224</code>, <code>SHA256</code> (default), <code>SHA512/224</code>, <code>SHA512/256</code>, -<code>SHA384</code>, <code>SHA512</code>, <code>CRC32</code> and <code>adler32</code>. -</p> -</dd> -</dl> - -<a name="Examples-6"></a> -<h4 class="subsection">4.10.1 Examples<span class="pull-right"><a class="anchor hidden-xs" href="#Examples-6" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Examples-6" aria-hidden="true">TOC</a></span></h4> - -<p>To compute the SHA-256 hash of the input converted to raw audio and -video, and store it in the file <samp>out.sha256</samp>: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -f hash out.sha256 -</pre></div> - -<p>To print an MD5 hash to stdout use the command: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -f hash -hash md5 - -</pre></div> - -<p>See also the <a href="#framehash">framehash</a> muxer. -</p> -<a name="hls"></a><a name="hls-1"></a> -<h3 class="section">4.11 hls<span class="pull-right"><a class="anchor hidden-xs" href="#hls-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-hls-1" aria-hidden="true">TOC</a></span></h3> - -<p>Apple HTTP Live Streaming muxer that segments MPEG-TS according to -the HTTP Live Streaming (HLS) specification. -</p> -<p>It creates a playlist file, and one or more segment files. The output filename -specifies the playlist filename. -</p> -<p>By default, the muxer creates a file for each segment produced. These files -have the same name as the playlist, followed by a sequential number and a -.ts extension. -</p> -<p>For example, to convert an input file with <code>ffmpeg</code>: -</p><div class="example"> -<pre class="example">ffmpeg -i in.nut out.m3u8 -</pre></div> -<p>This example will produce the playlist, <samp>out.m3u8</samp>, and segment files: -<samp>out0.ts</samp>, <samp>out1.ts</samp>, <samp>out2.ts</samp>, etc. -</p> -<p>See also the <a href="#segment">segment</a> muxer, which provides a more generic and -flexible implementation of a segmenter, and can be used to perform HLS -segmentation. -</p> -<a name="Options-4"></a> -<h4 class="subsection">4.11.1 Options<span class="pull-right"><a class="anchor hidden-xs" href="#Options-4" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Options-4" aria-hidden="true">TOC</a></span></h4> - -<p>This muxer supports the following options: -</p> -<dl compact="compact"> -<dt><samp>hls_init_time <var>seconds</var></samp></dt> -<dd><p>Set the initial target segment length in seconds. Default value is <var>0</var>. -Segment will be cut on the next key frame after this time has passed on the first m3u8 list. -After the initial playlist is filled <code>ffmpeg</code> will cut segments -at duration equal to <code>hls_time</code> -</p> -</dd> -<dt><samp>hls_time <var>seconds</var></samp></dt> -<dd><p>Set the target segment length in seconds. Default value is 2. -Segment will be cut on the next key frame after this time has passed. -</p> -</dd> -<dt><samp>hls_list_size <var>size</var></samp></dt> -<dd><p>Set the maximum number of playlist entries. If set to 0 the list file -will contain all the segments. Default value is 5. -</p> -</dd> -<dt><samp>hls_ts_options <var>options_list</var></samp></dt> -<dd><p>Set output format options using a :-separated list of key=value -parameters. Values containing <code>:</code> special characters must be -escaped. -</p> -</dd> -<dt><samp>hls_wrap <var>wrap</var></samp></dt> -<dd><p>Set the number after which the segment filename number (the number -specified in each segment file) wraps. If set to 0 the number will be -never wrapped. Default value is 0. -</p> -<p>This option is useful to avoid to fill the disk with many segment -files, and limits the maximum number of segment files written to disk -to <var>wrap</var>. -</p> -</dd> -<dt><samp>start_number <var>number</var></samp></dt> -<dd><p>Start the playlist sequence number from <var>number</var>. Default value is -0. -</p> -</dd> -<dt><samp>hls_allow_cache <var>allowcache</var></samp></dt> -<dd><p>Explicitly set whether the client MAY (1) or MUST NOT (0) cache media segments. -</p> -</dd> -<dt><samp>hls_base_url <var>baseurl</var></samp></dt> -<dd><p>Append <var>baseurl</var> to every entry in the playlist. -Useful to generate playlists with absolute paths. -</p> -<p>Note that the playlist sequence number must be unique for each segment -and it is not to be confused with the segment filename sequence number -which can be cyclic, for example if the <samp>wrap</samp> option is -specified. -</p> -</dd> -<dt><samp>hls_segment_filename <var>filename</var></samp></dt> -<dd><p>Set the segment filename. Unless <code>hls_flags single_file</code> is set, -<var>filename</var> is used as a string format with the segment number: -</p><div class="example"> -<pre class="example">ffmpeg -i in.nut -hls_segment_filename 'file%03d.ts' out.m3u8 -</pre></div> -<p>This example will produce the playlist, <samp>out.m3u8</samp>, and segment files: -<samp>file000.ts</samp>, <samp>file001.ts</samp>, <samp>file002.ts</samp>, etc. -</p> -</dd> -<dt><samp>use_localtime</samp></dt> -<dd><p>Use strftime on <var>filename</var> to expand the segment filename with localtime. -The segment number (%d) is not available in this mode. -</p><div class="example"> -<pre class="example">ffmpeg -i in.nut -use_localtime 1 -hls_segment_filename 'file-%Y%m%d-%s.ts' out.m3u8 -</pre></div> -<p>This example will produce the playlist, <samp>out.m3u8</samp>, and segment files: -<samp>file-20160215-1455569023.ts</samp>, <samp>file-20160215-1455569024.ts</samp>, etc. -</p> -</dd> -<dt><samp>use_localtime_mkdir</samp></dt> -<dd><p>Used together with -use_localtime, it will create up to one subdirectory which -is expanded in <var>filename</var>. -</p><div class="example"> -<pre class="example">ffmpeg -i in.nut -use_localtime 1 -use_localtime_mkdir 1 -hls_segment_filename '%Y%m%d/file-%Y%m%d-%s.ts' out.m3u8 -</pre></div> -<p>This example will create a directory 201560215 (if it does not exist), and then -produce the playlist, <samp>out.m3u8</samp>, and segment files: -<samp>201560215/file-20160215-1455569023.ts</samp>, <samp>201560215/file-20160215-1455569024.ts</samp>, etc. -</p> - -</dd> -<dt><samp>hls_key_info_file <var>key_info_file</var></samp></dt> -<dd><p>Use the information in <var>key_info_file</var> for segment encryption. The first -line of <var>key_info_file</var> specifies the key URI written to the playlist. The -key URL is used to access the encryption key during playback. The second line -specifies the path to the key file used to obtain the key during the encryption -process. The key file is read as a single packed array of 16 octets in binary -format. The optional third line specifies the initialization vector (IV) as a -hexadecimal string to be used instead of the segment sequence number (default) -for encryption. Changes to <var>key_info_file</var> will result in segment -encryption with the new key/IV and an entry in the playlist for the new key -URI/IV. -</p> -<p>Key info file format: -</p><div class="example"> -<pre class="example"><var>key URI</var> -<var>key file path</var> -<var>IV</var> (optional) -</pre></div> - -<p>Example key URIs: -</p><div class="example"> -<pre class="example">http://server/file.key -/path/to/file.key -file.key -</pre></div> - -<p>Example key file paths: -</p><div class="example"> -<pre class="example">file.key -/path/to/file.key -</pre></div> - -<p>Example IV: -</p><div class="example"> -<pre class="example">0123456789ABCDEF0123456789ABCDEF -</pre></div> - -<p>Key info file example: -</p><div class="example"> -<pre class="example">http://server/file.key -/path/to/file.key -0123456789ABCDEF0123456789ABCDEF -</pre></div> - -<p>Example shell script: -</p><div class="example"> -<pre class="example">#!/bin/sh -BASE_URL=${1:-'.'} -openssl rand 16 > file.key -echo $BASE_URL/file.key > file.keyinfo -echo file.key >> file.keyinfo -echo $(openssl rand -hex 16) >> file.keyinfo -ffmpeg -f lavfi -re -i testsrc -c:v h264 -hls_flags delete_segments \ - -hls_key_info_file file.keyinfo out.m3u8 -</pre></div> - -</dd> -<dt><samp>hls_flags single_file</samp></dt> -<dd><p>If this flag is set, the muxer will store all segments in a single MPEG-TS -file, and will use byte ranges in the playlist. HLS playlists generated with -this way will have the version number 4. -For example: -</p><div class="example"> -<pre class="example">ffmpeg -i in.nut -hls_flags single_file out.m3u8 -</pre></div> -<p>Will produce the playlist, <samp>out.m3u8</samp>, and a single segment file, -<samp>out.ts</samp>. -</p> -</dd> -<dt><samp>hls_flags delete_segments</samp></dt> -<dd><p>Segment files removed from the playlist are deleted after a period of time -equal to the duration of the segment plus the duration of the playlist. -</p> -</dd> -<dt><samp>hls_flags append_list</samp></dt> -<dd><p>Append new segments into the end of old segment list, -and remove the <code>#EXT-X-ENDLIST</code> from the old segment list. -</p> -</dd> -<dt><samp>hls_flags round_durations</samp></dt> -<dd><p>Round the duration info in the playlist file segment info to integer -values, instead of using floating point. -</p> -</dd> -<dt><samp>hls_flags discont_starts</samp></dt> -<dd><p>Add the <code>#EXT-X-DISCONTINUITY</code> tag to the playlist, before the -first segment’s information. -</p> -</dd> -<dt><samp>hls_flags omit_endlist</samp></dt> -<dd><p>Do not append the <code>EXT-X-ENDLIST</code> tag at the end of the playlist. -</p> -</dd> -<dt><samp>hls_flags split_by_time</samp></dt> -<dd><p>Allow segments to start on frames other than keyframes. This improves -behavior on some players when the time between keyframes is inconsistent, -but may make things worse on others, and can cause some oddities during -seeking. This flag should be used with the <code>hls_time</code> option. -</p> -</dd> -<dt><samp>hls_flags program_date_time</samp></dt> -<dd><p>Generate <code>EXT-X-PROGRAM-DATE-TIME</code> tags. -</p> -</dd> -<dt><samp>hls_playlist_type event</samp></dt> -<dd><p>Emit <code>#EXT-X-PLAYLIST-TYPE:EVENT</code> in the m3u8 header. Forces -<samp>hls_list_size</samp> to 0; the playlist can only be appended to. -</p> -</dd> -<dt><samp>hls_playlist_type vod</samp></dt> -<dd><p>Emit <code>#EXT-X-PLAYLIST-TYPE:VOD</code> in the m3u8 header. Forces -<samp>hls_list_size</samp> to 0; the playlist must not change. -</p> -</dd> -<dt><samp>method</samp></dt> -<dd><p>Use the given HTTP method to create the hls files. -</p><div class="example"> -<pre class="example">ffmpeg -re -i in.ts -f hls -method PUT http://example.com/live/out.m3u8 -</pre></div> -<p>This example will upload all the mpegts segment files to the HTTP -server using the HTTP PUT method, and update the m3u8 files every -<code>refresh</code> times using the same method. -Note that the HTTP server must support the given method for uploading -files. -</p></dd> -</dl> - -<a name="ico"></a><a name="ico-1"></a> -<h3 class="section">4.12 ico<span class="pull-right"><a class="anchor hidden-xs" href="#ico-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-ico-1" aria-hidden="true">TOC</a></span></h3> - -<p>ICO file muxer. -</p> -<p>Microsoft’s icon file format (ICO) has some strict limitations that should be noted: -</p> -<ul> -<li> Size cannot exceed 256 pixels in any dimension - -</li><li> Only BMP and PNG images can be stored - -</li><li> If a BMP image is used, it must be one of the following pixel formats: -<div class="example"> -<pre class="example">BMP Bit Depth FFmpeg Pixel Format -1bit pal8 -4bit pal8 -8bit pal8 -16bit rgb555le -24bit bgr24 -32bit bgra -</pre></div> - -</li><li> If a BMP image is used, it must use the BITMAPINFOHEADER DIB header - -</li><li> If a PNG image is used, it must use the rgba pixel format -</li></ul> - -<a name="image2"></a><a name="image2-2"></a> -<h3 class="section">4.13 image2<span class="pull-right"><a class="anchor hidden-xs" href="#image2-2" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-image2-2" aria-hidden="true">TOC</a></span></h3> - -<p>Image file muxer. -</p> -<p>The image file muxer writes video frames to image files. -</p> -<p>The output filenames are specified by a pattern, which can be used to -produce sequentially numbered series of files. -The pattern may contain the string "%d" or "%0<var>N</var>d", this string -specifies the position of the characters representing a numbering in -the filenames. If the form "%0<var>N</var>d" is used, the string -representing the number in each filename is 0-padded to <var>N</var> -digits. The literal character ’%’ can be specified in the pattern with -the string "%%". -</p> -<p>If the pattern contains "%d" or "%0<var>N</var>d", the first filename of -the file list specified will contain the number 1, all the following -numbers will be sequential. -</p> -<p>The pattern may contain a suffix which is used to automatically -determine the format of the image files to write. -</p> -<p>For example the pattern "img-%03d.bmp" will specify a sequence of -filenames of the form <samp>img-001.bmp</samp>, <samp>img-002.bmp</samp>, ..., -<samp>img-010.bmp</samp>, etc. -The pattern "img%%-%d.jpg" will specify a sequence of filenames of the -form <samp>img%-1.jpg</samp>, <samp>img%-2.jpg</samp>, ..., <samp>img%-10.jpg</samp>, -etc. -</p> -<a name="Examples-7"></a> -<h4 class="subsection">4.13.1 Examples<span class="pull-right"><a class="anchor hidden-xs" href="#Examples-7" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Examples-7" aria-hidden="true">TOC</a></span></h4> - -<p>The following example shows how to use <code>ffmpeg</code> for creating a -sequence of files <samp>img-001.jpeg</samp>, <samp>img-002.jpeg</samp>, ..., -taking one image every second from the input video: -</p><div class="example"> -<pre class="example">ffmpeg -i in.avi -vsync 1 -r 1 -f image2 'img-%03d.jpeg' -</pre></div> - -<p>Note that with <code>ffmpeg</code>, if the format is not specified with the -<code>-f</code> option and the output filename specifies an image file -format, the image2 muxer is automatically selected, so the previous -command can be written as: -</p><div class="example"> -<pre class="example">ffmpeg -i in.avi -vsync 1 -r 1 'img-%03d.jpeg' -</pre></div> - -<p>Note also that the pattern must not necessarily contain "%d" or -"%0<var>N</var>d", for example to create a single image file -<samp>img.jpeg</samp> from the input video you can employ the command: -</p><div class="example"> -<pre class="example">ffmpeg -i in.avi -f image2 -frames:v 1 img.jpeg -</pre></div> - -<p>The <samp>strftime</samp> option allows you to expand the filename with -date and time information. Check the documentation of -the <code>strftime()</code> function for the syntax. -</p> -<p>For example to generate image files from the <code>strftime()</code> -"%Y-%m-%d_%H-%M-%S" pattern, the following <code>ffmpeg</code> command -can be used: -</p><div class="example"> -<pre class="example">ffmpeg -f v4l2 -r 1 -i /dev/video0 -f image2 -strftime 1 "%Y-%m-%d_%H-%M-%S.jpg" -</pre></div> - -<a name="Options-5"></a> -<h4 class="subsection">4.13.2 Options<span class="pull-right"><a class="anchor hidden-xs" href="#Options-5" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Options-5" aria-hidden="true">TOC</a></span></h4> - -<dl compact="compact"> -<dt><samp>start_number</samp></dt> -<dd><p>Start the sequence from the specified number. Default value is 0. -</p> -</dd> -<dt><samp>update</samp></dt> -<dd><p>If set to 1, the filename will always be interpreted as just a -filename, not a pattern, and the corresponding file will be continuously -overwritten with new images. Default value is 0. -</p> -</dd> -<dt><samp>strftime</samp></dt> -<dd><p>If set to 1, expand the filename with date and time information from -<code>strftime()</code>. Default value is 0. -</p></dd> -</dl> - -<p>The image muxer supports the .Y.U.V image file format. This format is -special in that that each image frame consists of three files, for -each of the YUV420P components. To read or write this image file format, -specify the name of the ’.Y’ file. The muxer will automatically open the -’.U’ and ’.V’ files as required. -</p> -<a name="matroska"></a> -<h3 class="section">4.14 matroska<span class="pull-right"><a class="anchor hidden-xs" href="#matroska" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-matroska" aria-hidden="true">TOC</a></span></h3> - -<p>Matroska container muxer. -</p> -<p>This muxer implements the matroska and webm container specs. -</p> -<a name="Metadata"></a> -<h4 class="subsection">4.14.1 Metadata<span class="pull-right"><a class="anchor hidden-xs" href="#Metadata" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Metadata" aria-hidden="true">TOC</a></span></h4> - -<p>The recognized metadata settings in this muxer are: -</p> -<dl compact="compact"> -<dt><samp>title</samp></dt> -<dd><p>Set title name provided to a single track. -</p> -</dd> -<dt><samp>language</samp></dt> -<dd><p>Specify the language of the track in the Matroska languages form. -</p> -<p>The language can be either the 3 letters bibliographic ISO-639-2 (ISO -639-2/B) form (like "fre" for French), or a language code mixed with a -country code for specialities in languages (like "fre-ca" for Canadian -French). -</p> -</dd> -<dt><samp>stereo_mode</samp></dt> -<dd><p>Set stereo 3D video layout of two views in a single video track. -</p> -<p>The following values are recognized: -</p><dl compact="compact"> -<dt>‘<samp>mono</samp>’</dt> -<dd><p>video is not stereo -</p></dd> -<dt>‘<samp>left_right</samp>’</dt> -<dd><p>Both views are arranged side by side, Left-eye view is on the left -</p></dd> -<dt>‘<samp>bottom_top</samp>’</dt> -<dd><p>Both views are arranged in top-bottom orientation, Left-eye view is at bottom -</p></dd> -<dt>‘<samp>top_bottom</samp>’</dt> -<dd><p>Both views are arranged in top-bottom orientation, Left-eye view is on top -</p></dd> -<dt>‘<samp>checkerboard_rl</samp>’</dt> -<dd><p>Each view is arranged in a checkerboard interleaved pattern, Left-eye view being first -</p></dd> -<dt>‘<samp>checkerboard_lr</samp>’</dt> -<dd><p>Each view is arranged in a checkerboard interleaved pattern, Right-eye view being first -</p></dd> -<dt>‘<samp>row_interleaved_rl</samp>’</dt> -<dd><p>Each view is constituted by a row based interleaving, Right-eye view is first row -</p></dd> -<dt>‘<samp>row_interleaved_lr</samp>’</dt> -<dd><p>Each view is constituted by a row based interleaving, Left-eye view is first row -</p></dd> -<dt>‘<samp>col_interleaved_rl</samp>’</dt> -<dd><p>Both views are arranged in a column based interleaving manner, Right-eye view is first column -</p></dd> -<dt>‘<samp>col_interleaved_lr</samp>’</dt> -<dd><p>Both views are arranged in a column based interleaving manner, Left-eye view is first column -</p></dd> -<dt>‘<samp>anaglyph_cyan_red</samp>’</dt> -<dd><p>All frames are in anaglyph format viewable through red-cyan filters -</p></dd> -<dt>‘<samp>right_left</samp>’</dt> -<dd><p>Both views are arranged side by side, Right-eye view is on the left -</p></dd> -<dt>‘<samp>anaglyph_green_magenta</samp>’</dt> -<dd><p>All frames are in anaglyph format viewable through green-magenta filters -</p></dd> -<dt>‘<samp>block_lr</samp>’</dt> -<dd><p>Both eyes laced in one Block, Left-eye view is first -</p></dd> -<dt>‘<samp>block_rl</samp>’</dt> -<dd><p>Both eyes laced in one Block, Right-eye view is first -</p></dd> -</dl> -</dd> -</dl> - -<p>For example a 3D WebM clip can be created using the following command line: -</p><div class="example"> -<pre class="example">ffmpeg -i sample_left_right_clip.mpg -an -c:v libvpx -metadata stereo_mode=left_right -y stereo_clip.webm -</pre></div> - -<a name="Options-6"></a> -<h4 class="subsection">4.14.2 Options<span class="pull-right"><a class="anchor hidden-xs" href="#Options-6" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Options-6" aria-hidden="true">TOC</a></span></h4> - -<p>This muxer supports the following options: -</p> -<dl compact="compact"> -<dt><samp>reserve_index_space</samp></dt> -<dd><p>By default, this muxer writes the index for seeking (called cues in Matroska -terms) at the end of the file, because it cannot know in advance how much space -to leave for the index at the beginning of the file. However for some use cases -– e.g. streaming where seeking is possible but slow – it is useful to put the -index at the beginning of the file. -</p> -<p>If this option is set to a non-zero value, the muxer will reserve a given amount -of space in the file header and then try to write the cues there when the muxing -finishes. If the available space does not suffice, muxing will fail. A safe size -for most use cases should be about 50kB per hour of video. -</p> -<p>Note that cues are only written if the output is seekable and this option will -have no effect if it is not. -</p></dd> -</dl> - -<a name="md5"></a><a name="md5-1"></a> -<h3 class="section">4.15 md5<span class="pull-right"><a class="anchor hidden-xs" href="#md5-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-md5-1" aria-hidden="true">TOC</a></span></h3> - -<p>MD5 testing format. -</p> -<p>This is a variant of the <a href="#hash">hash</a> muxer. Unlike that muxer, it -defaults to using the MD5 hash function. -</p> -<a name="Examples-8"></a> -<h4 class="subsection">4.15.1 Examples<span class="pull-right"><a class="anchor hidden-xs" href="#Examples-8" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Examples-8" aria-hidden="true">TOC</a></span></h4> - -<p>To compute the MD5 hash of the input converted to raw -audio and video, and store it in the file <samp>out.md5</samp>: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -f md5 out.md5 -</pre></div> - -<p>You can print the MD5 to stdout with the command: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -f md5 - -</pre></div> - -<p>See also the <a href="#hash">hash</a> and <a href="#framemd5">framemd5</a> muxers. -</p> -<a name="mov_002c-mp4_002c-ismv"></a> -<h3 class="section">4.16 mov, mp4, ismv<span class="pull-right"><a class="anchor hidden-xs" href="#mov_002c-mp4_002c-ismv" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-mov_002c-mp4_002c-ismv" aria-hidden="true">TOC</a></span></h3> - -<p>MOV/MP4/ISMV (Smooth Streaming) muxer. -</p> -<p>The mov/mp4/ismv muxer supports fragmentation. Normally, a MOV/MP4 -file has all the metadata about all packets stored in one location -(written at the end of the file, it can be moved to the start for -better playback by adding <var>faststart</var> to the <var>movflags</var>, or -using the <code>qt-faststart</code> tool). A fragmented -file consists of a number of fragments, where packets and metadata -about these packets are stored together. Writing a fragmented -file has the advantage that the file is decodable even if the -writing is interrupted (while a normal MOV/MP4 is undecodable if -it is not properly finished), and it requires less memory when writing -very long files (since writing normal MOV/MP4 files stores info about -every single packet in memory until the file is closed). The downside -is that it is less compatible with other applications. -</p> -<a name="Options-7"></a> -<h4 class="subsection">4.16.1 Options<span class="pull-right"><a class="anchor hidden-xs" href="#Options-7" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Options-7" aria-hidden="true">TOC</a></span></h4> - -<p>Fragmentation is enabled by setting one of the AVOptions that define -how to cut the file into fragments: -</p> -<dl compact="compact"> -<dt><samp>-moov_size <var>bytes</var></samp></dt> -<dd><p>Reserves space for the moov atom at the beginning of the file instead of placing the -moov atom at the end. If the space reserved is insufficient, muxing will fail. -</p></dd> -<dt><samp>-movflags frag_keyframe</samp></dt> -<dd><p>Start a new fragment at each video keyframe. -</p></dd> -<dt><samp>-frag_duration <var>duration</var></samp></dt> -<dd><p>Create fragments that are <var>duration</var> microseconds long. -</p></dd> -<dt><samp>-frag_size <var>size</var></samp></dt> -<dd><p>Create fragments that contain up to <var>size</var> bytes of payload data. -</p></dd> -<dt><samp>-movflags frag_custom</samp></dt> -<dd><p>Allow the caller to manually choose when to cut fragments, by -calling <code>av_write_frame(ctx, NULL)</code> to write a fragment with -the packets written so far. (This is only useful with other -applications integrating libavformat, not from <code>ffmpeg</code>.) -</p></dd> -<dt><samp>-min_frag_duration <var>duration</var></samp></dt> -<dd><p>Don’t create fragments that are shorter than <var>duration</var> microseconds long. -</p></dd> -</dl> - -<p>If more than one condition is specified, fragments are cut when -one of the specified conditions is fulfilled. The exception to this is -<code>-min_frag_duration</code>, which has to be fulfilled for any of the other -conditions to apply. -</p> -<p>Additionally, the way the output file is written can be adjusted -through a few other options: -</p> -<dl compact="compact"> -<dt><samp>-movflags empty_moov</samp></dt> -<dd><p>Write an initial moov atom directly at the start of the file, without -describing any samples in it. Generally, an mdat/moov pair is written -at the start of the file, as a normal MOV/MP4 file, containing only -a short portion of the file. With this option set, there is no initial -mdat atom, and the moov atom only describes the tracks but has -a zero duration. -</p> -<p>This option is implicitly set when writing ismv (Smooth Streaming) files. -</p></dd> -<dt><samp>-movflags separate_moof</samp></dt> -<dd><p>Write a separate moof (movie fragment) atom for each track. Normally, -packets for all tracks are written in a moof atom (which is slightly -more efficient), but with this option set, the muxer writes one moof/mdat -pair for each track, making it easier to separate tracks. -</p> -<p>This option is implicitly set when writing ismv (Smooth Streaming) files. -</p></dd> -<dt><samp>-movflags faststart</samp></dt> -<dd><p>Run a second pass moving the index (moov atom) to the beginning of the file. -This operation can take a while, and will not work in various situations such -as fragmented output, thus it is not enabled by default. -</p></dd> -<dt><samp>-movflags rtphint</samp></dt> -<dd><p>Add RTP hinting tracks to the output file. -</p></dd> -<dt><samp>-movflags disable_chpl</samp></dt> -<dd><p>Disable Nero chapter markers (chpl atom). Normally, both Nero chapters -and a QuickTime chapter track are written to the file. With this option -set, only the QuickTime chapter track will be written. Nero chapters can -cause failures when the file is reprocessed with certain tagging programs, like -mp3Tag 2.61a and iTunes 11.3, most likely other versions are affected as well. -</p></dd> -<dt><samp>-movflags omit_tfhd_offset</samp></dt> -<dd><p>Do not write any absolute base_data_offset in tfhd atoms. This avoids -tying fragments to absolute byte positions in the file/streams. -</p></dd> -<dt><samp>-movflags default_base_moof</samp></dt> -<dd><p>Similarly to the omit_tfhd_offset, this flag avoids writing the -absolute base_data_offset field in tfhd atoms, but does so by using -the new default-base-is-moof flag instead. This flag is new from -14496-12:2012. This may make the fragments easier to parse in certain -circumstances (avoiding basing track fragment location calculations -on the implicit end of the previous track fragment). -</p></dd> -<dt><samp>-write_tmcd</samp></dt> -<dd><p>Specify <code>on</code> to force writing a timecode track, <code>off</code> to disable it -and <code>auto</code> to write a timecode track only for mov and mp4 output (default). -</p></dd> -</dl> - -<a name="Example"></a> -<h4 class="subsection">4.16.2 Example<span class="pull-right"><a class="anchor hidden-xs" href="#Example" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Example" aria-hidden="true">TOC</a></span></h4> - -<p>Smooth Streaming content can be pushed in real time to a publishing -point on IIS with this muxer. Example: -</p><div class="example"> -<pre class="example">ffmpeg -re <var><normal input/transcoding options></var> -movflags isml+frag_keyframe -f ismv http://server/publishingpoint.isml/Streams(Encoder1) -</pre></div> - -<a name="Audible-AAX"></a> -<h4 class="subsection">4.16.3 Audible AAX<span class="pull-right"><a class="anchor hidden-xs" href="#Audible-AAX" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Audible-AAX" aria-hidden="true">TOC</a></span></h4> - -<p>Audible AAX files are encrypted M4B files, and they can be decrypted by specifying a 4 byte activation secret. -</p><div class="example"> -<pre class="example">ffmpeg -activation_bytes 1CEB00DA -i test.aax -vn -c:a copy output.mp4 -</pre></div> - -<a name="mp3"></a> -<h3 class="section">4.17 mp3<span class="pull-right"><a class="anchor hidden-xs" href="#mp3" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-mp3" aria-hidden="true">TOC</a></span></h3> - -<p>The MP3 muxer writes a raw MP3 stream with the following optional features: -</p><ul> -<li> An ID3v2 metadata header at the beginning (enabled by default). Versions 2.3 and -2.4 are supported, the <code>id3v2_version</code> private option controls which one is -used (3 or 4). Setting <code>id3v2_version</code> to 0 disables the ID3v2 header -completely. - -<p>The muxer supports writing attached pictures (APIC frames) to the ID3v2 header. -The pictures are supplied to the muxer in form of a video stream with a single -packet. There can be any number of those streams, each will correspond to a -single APIC frame. The stream metadata tags <var>title</var> and <var>comment</var> map -to APIC <var>description</var> and <var>picture type</var> respectively. See -<a href="http://id3.org/id3v2.4.0-frames">http://id3.org/id3v2.4.0-frames</a> for allowed picture types. -</p> -<p>Note that the APIC frames must be written at the beginning, so the muxer will -buffer the audio frames until it gets all the pictures. It is therefore advised -to provide the pictures as soon as possible to avoid excessive buffering. -</p> -</li><li> A Xing/LAME frame right after the ID3v2 header (if present). It is enabled by -default, but will be written only if the output is seekable. The -<code>write_xing</code> private option can be used to disable it. The frame contains -various information that may be useful to the decoder, like the audio duration -or encoder delay. - -</li><li> A legacy ID3v1 tag at the end of the file (disabled by default). It may be -enabled with the <code>write_id3v1</code> private option, but as its capabilities are -very limited, its usage is not recommended. -</li></ul> - -<p>Examples: -</p> -<p>Write an mp3 with an ID3v2.3 header and an ID3v1 footer: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -id3v2_version 3 -write_id3v1 1 out.mp3 -</pre></div> - -<p>To attach a picture to an mp3 file select both the audio and the picture stream -with <code>map</code>: -</p><div class="example"> -<pre class="example">ffmpeg -i input.mp3 -i cover.png -c copy -map 0 -map 1 --metadata:s:v title="Album cover" -metadata:s:v comment="Cover (Front)" out.mp3 -</pre></div> - -<p>Write a "clean" MP3 without any extra features: -</p><div class="example"> -<pre class="example">ffmpeg -i input.wav -write_xing 0 -id3v2_version 0 out.mp3 -</pre></div> - -<a name="mpegts-1"></a> -<h3 class="section">4.18 mpegts<span class="pull-right"><a class="anchor hidden-xs" href="#mpegts-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-mpegts-1" aria-hidden="true">TOC</a></span></h3> - -<p>MPEG transport stream muxer. -</p> -<p>This muxer implements ISO 13818-1 and part of ETSI EN 300 468. -</p> -<p>The recognized metadata settings in mpegts muxer are <code>service_provider</code> -and <code>service_name</code>. If they are not set the default for -<code>service_provider</code> is "FFmpeg" and the default for -<code>service_name</code> is "Service01". -</p> -<a name="Options-8"></a> -<h4 class="subsection">4.18.1 Options<span class="pull-right"><a class="anchor hidden-xs" href="#Options-8" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Options-8" aria-hidden="true">TOC</a></span></h4> - -<p>The muxer options are: -</p> -<dl compact="compact"> -<dt><samp>mpegts_original_network_id <var>number</var></samp></dt> -<dd><p>Set the original_network_id (default 0x0001). This is unique identifier -of a network in DVB. Its main use is in the unique identification of a -service through the path Original_Network_ID, Transport_Stream_ID. -</p></dd> -<dt><samp>mpegts_transport_stream_id <var>number</var></samp></dt> -<dd><p>Set the transport_stream_id (default 0x0001). This identifies a -transponder in DVB. -</p></dd> -<dt><samp>mpegts_service_id <var>number</var></samp></dt> -<dd><p>Set the service_id (default 0x0001) also known as program in DVB. -</p></dd> -<dt><samp>mpegts_service_type <var>number</var></samp></dt> -<dd><p>Set the program service_type (default <var>digital_tv</var>), see below -a list of pre defined values. -</p></dd> -<dt><samp>mpegts_pmt_start_pid <var>number</var></samp></dt> -<dd><p>Set the first PID for PMT (default 0x1000, max 0x1f00). -</p></dd> -<dt><samp>mpegts_start_pid <var>number</var></samp></dt> -<dd><p>Set the first PID for data packets (default 0x0100, max 0x0f00). -</p></dd> -<dt><samp>mpegts_m2ts_mode <var>number</var></samp></dt> -<dd><p>Enable m2ts mode if set to 1. Default value is -1 which disables m2ts mode. -</p></dd> -<dt><samp>muxrate <var>number</var></samp></dt> -<dd><p>Set a constant muxrate (default VBR). -</p></dd> -<dt><samp>pcr_period <var>numer</var></samp></dt> -<dd><p>Override the default PCR retransmission time (default 20ms), ignored -if variable muxrate is selected. -</p></dd> -<dt><samp>pat_period <var>number</var></samp></dt> -<dd><p>Maximal time in seconds between PAT/PMT tables. -</p></dd> -<dt><samp>sdt_period <var>number</var></samp></dt> -<dd><p>Maximal time in seconds between SDT tables. -</p></dd> -<dt><samp>pes_payload_size <var>number</var></samp></dt> -<dd><p>Set minimum PES packet payload in bytes. -</p></dd> -<dt><samp>mpegts_flags <var>flags</var></samp></dt> -<dd><p>Set flags (see below). -</p></dd> -<dt><samp>mpegts_copyts <var>number</var></samp></dt> -<dd><p>Preserve original timestamps, if value is set to 1. Default value is -1, which -results in shifting timestamps so that they start from 0. -</p></dd> -<dt><samp>tables_version <var>number</var></samp></dt> -<dd><p>Set PAT, PMT and SDT version (default 0, valid values are from 0 to 31, inclusively). -This option allows updating stream structure so that standard consumer may -detect the change. To do so, reopen output AVFormatContext (in case of API -usage) or restart ffmpeg instance, cyclically changing tables_version value: -</p><div class="example"> -<pre class="example">ffmpeg -i source1.ts -codec copy -f mpegts -tables_version 0 udp://1.1.1.1:1111 -ffmpeg -i source2.ts -codec copy -f mpegts -tables_version 1 udp://1.1.1.1:1111 -... -ffmpeg -i source3.ts -codec copy -f mpegts -tables_version 31 udp://1.1.1.1:1111 -ffmpeg -i source1.ts -codec copy -f mpegts -tables_version 0 udp://1.1.1.1:1111 -ffmpeg -i source2.ts -codec copy -f mpegts -tables_version 1 udp://1.1.1.1:1111 -... -</pre></div> -</dd> -</dl> - -<p>Option <samp>mpegts_service_type</samp> accepts the following values: -</p> -<dl compact="compact"> -<dt><samp>hex_value</samp></dt> -<dd><p>Any hexdecimal value between 0x01 to 0xff as defined in ETSI 300 468. -</p></dd> -<dt><samp>digital_tv</samp></dt> -<dd><p>Digital TV service. -</p></dd> -<dt><samp>digital_radio</samp></dt> -<dd><p>Digital Radio service. -</p></dd> -<dt><samp>teletext</samp></dt> -<dd><p>Teletext service. -</p></dd> -<dt><samp>advanced_codec_digital_radio</samp></dt> -<dd><p>Advanced Codec Digital Radio service. -</p></dd> -<dt><samp>mpeg2_digital_hdtv</samp></dt> -<dd><p>MPEG2 Digital HDTV service. -</p></dd> -<dt><samp>advanced_codec_digital_sdtv</samp></dt> -<dd><p>Advanced Codec Digital SDTV service. -</p></dd> -<dt><samp>advanced_codec_digital_hdtv</samp></dt> -<dd><p>Advanced Codec Digital HDTV service. -</p></dd> -</dl> - -<p>Option <samp>mpegts_flags</samp> may take a set of such flags: -</p> -<dl compact="compact"> -<dt><samp>resend_headers</samp></dt> -<dd><p>Reemit PAT/PMT before writing the next packet. -</p></dd> -<dt><samp>latm</samp></dt> -<dd><p>Use LATM packetization for AAC. -</p></dd> -<dt><samp>pat_pmt_at_frames</samp></dt> -<dd><p>Reemit PAT and PMT at each video frame. -</p></dd> -<dt><samp>system_b</samp></dt> -<dd><p>Conform to System B (DVB) instead of System A (ATSC). -</p></dd> -</dl> - -<a name="Example-1"></a> -<h4 class="subsection">4.18.2 Example<span class="pull-right"><a class="anchor hidden-xs" href="#Example-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Example-1" aria-hidden="true">TOC</a></span></h4> - -<div class="example"> -<pre class="example">ffmpeg -i file.mpg -c copy \ - -mpegts_original_network_id 0x1122 \ - -mpegts_transport_stream_id 0x3344 \ - -mpegts_service_id 0x5566 \ - -mpegts_pmt_start_pid 0x1500 \ - -mpegts_start_pid 0x150 \ - -metadata service_provider="Some provider" \ - -metadata service_name="Some Channel" \ - -y out.ts -</pre></div> - -<a name="mxf_002c-mxf_005fd10"></a> -<h3 class="section">4.19 mxf, mxf_d10<span class="pull-right"><a class="anchor hidden-xs" href="#mxf_002c-mxf_005fd10" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-mxf_002c-mxf_005fd10" aria-hidden="true">TOC</a></span></h3> - -<p>MXF muxer. -</p> -<a name="Options-9"></a> -<h4 class="subsection">4.19.1 Options<span class="pull-right"><a class="anchor hidden-xs" href="#Options-9" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Options-9" aria-hidden="true">TOC</a></span></h4> - -<p>The muxer options are: -</p> -<dl compact="compact"> -<dt><samp>store_user_comments <var>bool</var></samp></dt> -<dd><p>Set if user comments should be stored if available or never. -IRT D-10 does not allow user comments. The default is thus to write them for -mxf but not for mxf_d10 -</p></dd> -</dl> - -<a name="null"></a> -<h3 class="section">4.20 null<span class="pull-right"><a class="anchor hidden-xs" href="#null" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-null" aria-hidden="true">TOC</a></span></h3> - -<p>Null muxer. -</p> -<p>This muxer does not generate any output file, it is mainly useful for -testing or benchmarking purposes. -</p> -<p>For example to benchmark decoding with <code>ffmpeg</code> you can use the -command: -</p><div class="example"> -<pre class="example">ffmpeg -benchmark -i INPUT -f null out.null -</pre></div> - -<p>Note that the above command does not read or write the <samp>out.null</samp> -file, but specifying the output file is required by the <code>ffmpeg</code> -syntax. -</p> -<p>Alternatively you can write the command as: -</p><div class="example"> -<pre class="example">ffmpeg -benchmark -i INPUT -f null - -</pre></div> - -<a name="nut"></a> -<h3 class="section">4.21 nut<span class="pull-right"><a class="anchor hidden-xs" href="#nut" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-nut" aria-hidden="true">TOC</a></span></h3> - -<dl compact="compact"> -<dt><samp>-syncpoints <var>flags</var></samp></dt> -<dd><p>Change the syncpoint usage in nut: -</p><dl compact="compact"> -<dt><samp><var>default</var> use the normal low-overhead seeking aids.</samp></dt> -<dt><samp><var>none</var> do not use the syncpoints at all, reducing the overhead but making the stream non-seekable;</samp></dt> -<dd><p>Use of this option is not recommended, as the resulting files are very damage - sensitive and seeking is not possible. Also in general the overhead from - syncpoints is negligible. Note, -<code>write_index</code> 0 can be used to disable - all growing data tables, allowing to mux endless streams with limited memory - and without these disadvantages. -</p></dd> -<dt><samp><var>timestamped</var> extend the syncpoint with a wallclock field.</samp></dt> -</dl> -<p>The <var>none</var> and <var>timestamped</var> flags are experimental. -</p></dd> -<dt><samp>-write_index <var>bool</var></samp></dt> -<dd><p>Write index at the end, the default is to write an index. -</p></dd> -</dl> - -<div class="example"> -<pre class="example">ffmpeg -i INPUT -f_strict experimental -syncpoints none - | processor -</pre></div> - -<a name="ogg"></a> -<h3 class="section">4.22 ogg<span class="pull-right"><a class="anchor hidden-xs" href="#ogg" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-ogg" aria-hidden="true">TOC</a></span></h3> - -<p>Ogg container muxer. -</p> -<dl compact="compact"> -<dt><samp>-page_duration <var>duration</var></samp></dt> -<dd><p>Preferred page duration, in microseconds. The muxer will attempt to create -pages that are approximately <var>duration</var> microseconds long. This allows the -user to compromise between seek granularity and container overhead. The default -is 1 second. A value of 0 will fill all segments, making pages as large as -possible. A value of 1 will effectively use 1 packet-per-page in most -situations, giving a small seek granularity at the cost of additional container -overhead. -</p></dd> -<dt><samp>-serial_offset <var>value</var></samp></dt> -<dd><p>Serial value from which to set the streams serial number. -Setting it to different and sufficiently large values ensures that the produced -ogg files can be safely chained. -</p> -</dd> -</dl> - -<a name="segment"></a><a name="segment_002c-stream_005fsegment_002c-ssegment"></a> -<h3 class="section">4.23 segment, stream_segment, ssegment<span class="pull-right"><a class="anchor hidden-xs" href="#segment_002c-stream_005fsegment_002c-ssegment" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-segment_002c-stream_005fsegment_002c-ssegment" aria-hidden="true">TOC</a></span></h3> - -<p>Basic stream segmenter. -</p> -<p>This muxer outputs streams to a number of separate files of nearly -fixed duration. Output filename pattern can be set in a fashion -similar to <a href="#image2">image2</a>, or by using a <code>strftime</code> template if -the <samp>strftime</samp> option is enabled. -</p> -<p><code>stream_segment</code> is a variant of the muxer used to write to -streaming output formats, i.e. which do not require global headers, -and is recommended for outputting e.g. to MPEG transport stream segments. -<code>ssegment</code> is a shorter alias for <code>stream_segment</code>. -</p> -<p>Every segment starts with a keyframe of the selected reference stream, -which is set through the <samp>reference_stream</samp> option. -</p> -<p>Note that if you want accurate splitting for a video file, you need to -make the input key frames correspond to the exact splitting times -expected by the segmenter, or the segment muxer will start the new -segment with the key frame found next after the specified start -time. -</p> -<p>The segment muxer works best with a single constant frame rate video. -</p> -<p>Optionally it can generate a list of the created segments, by setting -the option <var>segment_list</var>. The list type is specified by the -<var>segment_list_type</var> option. The entry filenames in the segment -list are set by default to the basename of the corresponding segment -files. -</p> -<p>See also the <a href="#hls">hls</a> muxer, which provides a more specific -implementation for HLS segmentation. -</p> -<a name="Options-10"></a> -<h4 class="subsection">4.23.1 Options<span class="pull-right"><a class="anchor hidden-xs" href="#Options-10" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Options-10" aria-hidden="true">TOC</a></span></h4> - -<p>The segment muxer supports the following options: -</p> -<dl compact="compact"> -<dt><samp>increment_tc <var>1|0</var></samp></dt> -<dd><p>if set to <code>1</code>, increment timecode between each segment -If this is selected, the input need to have -a timecode in the first video stream. Default value is -<code>0</code>. -</p> -</dd> -<dt><samp>reference_stream <var>specifier</var></samp></dt> -<dd><p>Set the reference stream, as specified by the string <var>specifier</var>. -If <var>specifier</var> is set to <code>auto</code>, the reference is chosen -automatically. Otherwise it must be a stream specifier (see the “Stream -specifiers” chapter in the ffmpeg manual) which specifies the -reference stream. The default value is <code>auto</code>. -</p> -</dd> -<dt><samp>segment_format <var>format</var></samp></dt> -<dd><p>Override the inner container format, by default it is guessed by the filename -extension. -</p> -</dd> -<dt><samp>segment_format_options <var>options_list</var></samp></dt> -<dd><p>Set output format options using a :-separated list of key=value -parameters. Values containing the <code>:</code> special character must be -escaped. -</p> -</dd> -<dt><samp>segment_list <var>name</var></samp></dt> -<dd><p>Generate also a listfile named <var>name</var>. If not specified no -listfile is generated. -</p> -</dd> -<dt><samp>segment_list_flags <var>flags</var></samp></dt> -<dd><p>Set flags affecting the segment list generation. -</p> -<p>It currently supports the following flags: -</p><dl compact="compact"> -<dt>‘<samp>cache</samp>’</dt> -<dd><p>Allow caching (only affects M3U8 list files). -</p> -</dd> -<dt>‘<samp>live</samp>’</dt> -<dd><p>Allow live-friendly file generation. -</p></dd> -</dl> - -</dd> -<dt><samp>segment_list_size <var>size</var></samp></dt> -<dd><p>Update the list file so that it contains at most <var>size</var> -segments. If 0 the list file will contain all the segments. Default -value is 0. -</p> -</dd> -<dt><samp>segment_list_entry_prefix <var>prefix</var></samp></dt> -<dd><p>Prepend <var>prefix</var> to each entry. Useful to generate absolute paths. -By default no prefix is applied. -</p> -</dd> -<dt><samp>segment_list_type <var>type</var></samp></dt> -<dd><p>Select the listing format. -</p> -<p>The following values are recognized: -</p><dl compact="compact"> -<dt>‘<samp>flat</samp>’</dt> -<dd><p>Generate a flat list for the created segments, one segment per line. -</p> -</dd> -<dt>‘<samp>csv, ext</samp>’</dt> -<dd><p>Generate a list for the created segments, one segment per line, -each line matching the format (comma-separated values): -</p><div class="example"> -<pre class="example"><var>segment_filename</var>,<var>segment_start_time</var>,<var>segment_end_time</var> -</pre></div> - -<p><var>segment_filename</var> is the name of the output file generated by the -muxer according to the provided pattern. CSV escaping (according to -RFC4180) is applied if required. -</p> -<p><var>segment_start_time</var> and <var>segment_end_time</var> specify -the segment start and end time expressed in seconds. -</p> -<p>A list file with the suffix <code>".csv"</code> or <code>".ext"</code> will -auto-select this format. -</p> -<p>‘<samp>ext</samp>’ is deprecated in favor or ‘<samp>csv</samp>’. -</p> -</dd> -<dt>‘<samp>ffconcat</samp>’</dt> -<dd><p>Generate an ffconcat file for the created segments. The resulting file -can be read using the FFmpeg <a href="#concat">concat</a> demuxer. -</p> -<p>A list file with the suffix <code>".ffcat"</code> or <code>".ffconcat"</code> will -auto-select this format. -</p> -</dd> -<dt>‘<samp>m3u8</samp>’</dt> -<dd><p>Generate an extended M3U8 file, version 3, compliant with -<a href="http://tools.ietf.org/id/draft-pantos-http-live-streaming">http://tools.ietf.org/id/draft-pantos-http-live-streaming</a>. -</p> -<p>A list file with the suffix <code>".m3u8"</code> will auto-select this format. -</p></dd> -</dl> - -<p>If not specified the type is guessed from the list file name suffix. -</p> -</dd> -<dt><samp>segment_time <var>time</var></samp></dt> -<dd><p>Set segment duration to <var>time</var>, the value must be a duration -specification. Default value is "2". See also the -<samp>segment_times</samp> option. -</p> -<p>Note that splitting may not be accurate, unless you force the -reference stream key-frames at the given time. See the introductory -notice and the examples below. -</p> -</dd> -<dt><samp>segment_atclocktime <var>1|0</var></samp></dt> -<dd><p>If set to "1" split at regular clock time intervals starting from 00:00 -o’clock. The <var>time</var> value specified in <samp>segment_time</samp> is -used for setting the length of the splitting interval. -</p> -<p>For example with <samp>segment_time</samp> set to "900" this makes it possible -to create files at 12:00 o’clock, 12:15, 12:30, etc. -</p> -<p>Default value is "0". -</p> -</dd> -<dt><samp>segment_clocktime_offset <var>duration</var></samp></dt> -<dd><p>Delay the segment splitting times with the specified duration when using -<samp>segment_atclocktime</samp>. -</p> -<p>For example with <samp>segment_time</samp> set to "900" and -<samp>segment_clocktime_offset</samp> set to "300" this makes it possible to -create files at 12:05, 12:20, 12:35, etc. -</p> -<p>Default value is "0". -</p> -</dd> -<dt><samp>segment_clocktime_wrap_duration <var>duration</var></samp></dt> -<dd><p>Force the segmenter to only start a new segment if a packet reaches the muxer -within the specified duration after the segmenting clock time. This way you -can make the segmenter more resilient to backward local time jumps, such as -leap seconds or transition to standard time from daylight savings time. -</p> -<p>Assuming that the delay between the packets of your source is less than 0.5 -second you can detect a leap second by specifying 0.5 as the duration. -</p> -<p>Default is the maximum possible duration which means starting a new segment -regardless of the elapsed time since the last clock time. -</p> -</dd> -<dt><samp>segment_time_delta <var>delta</var></samp></dt> -<dd><p>Specify the accuracy time when selecting the start time for a -segment, expressed as a duration specification. Default value is "0". -</p> -<p>When delta is specified a key-frame will start a new segment if its -PTS satisfies the relation: -</p><div class="example"> -<pre class="example">PTS >= start_time - time_delta -</pre></div> - -<p>This option is useful when splitting video content, which is always -split at GOP boundaries, in case a key frame is found just before the -specified split time. -</p> -<p>In particular may be used in combination with the <samp>ffmpeg</samp> option -<var>force_key_frames</var>. The key frame times specified by -<var>force_key_frames</var> may not be set accurately because of rounding -issues, with the consequence that a key frame time may result set just -before the specified time. For constant frame rate videos a value of -1/(2*<var>frame_rate</var>) should address the worst case mismatch between -the specified time and the time set by <var>force_key_frames</var>. -</p> -</dd> -<dt><samp>segment_times <var>times</var></samp></dt> -<dd><p>Specify a list of split points. <var>times</var> contains a list of comma -separated duration specifications, in increasing order. See also -the <samp>segment_time</samp> option. -</p> -</dd> -<dt><samp>segment_frames <var>frames</var></samp></dt> -<dd><p>Specify a list of split video frame numbers. <var>frames</var> contains a -list of comma separated integer numbers, in increasing order. -</p> -<p>This option specifies to start a new segment whenever a reference -stream key frame is found and the sequential number (starting from 0) -of the frame is greater or equal to the next value in the list. -</p> -</dd> -<dt><samp>segment_wrap <var>limit</var></samp></dt> -<dd><p>Wrap around segment index once it reaches <var>limit</var>. -</p> -</dd> -<dt><samp>segment_start_number <var>number</var></samp></dt> -<dd><p>Set the sequence number of the first segment. Defaults to <code>0</code>. -</p> -</dd> -<dt><samp>strftime <var>1|0</var></samp></dt> -<dd><p>Use the <code>strftime</code> function to define the name of the new -segments to write. If this is selected, the output segment name must -contain a <code>strftime</code> function template. Default value is -<code>0</code>. -</p> -</dd> -<dt><samp>break_non_keyframes <var>1|0</var></samp></dt> -<dd><p>If enabled, allow segments to start on frames other than keyframes. This -improves behavior on some players when the time between keyframes is -inconsistent, but may make things worse on others, and can cause some oddities -during seeking. Defaults to <code>0</code>. -</p> -</dd> -<dt><samp>reset_timestamps <var>1|0</var></samp></dt> -<dd><p>Reset timestamps at the begin of each segment, so that each segment -will start with near-zero timestamps. It is meant to ease the playback -of the generated segments. May not work with some combinations of -muxers/codecs. It is set to <code>0</code> by default. -</p> -</dd> -<dt><samp>initial_offset <var>offset</var></samp></dt> -<dd><p>Specify timestamp offset to apply to the output packet timestamps. The -argument must be a time duration specification, and defaults to 0. -</p> -</dd> -<dt><samp>write_empty_segments <var>1|0</var></samp></dt> -<dd><p>If enabled, write an empty segment if there are no packets during the period a -segment would usually span. Otherwise, the segment will be filled with the next -packet written. Defaults to <code>0</code>. -</p></dd> -</dl> - -<a name="Examples-9"></a> -<h4 class="subsection">4.23.2 Examples<span class="pull-right"><a class="anchor hidden-xs" href="#Examples-9" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Examples-9" aria-hidden="true">TOC</a></span></h4> - -<ul> -<li> Remux the content of file <samp>in.mkv</samp> to a list of segments -<samp>out-000.nut</samp>, <samp>out-001.nut</samp>, etc., and write the list of -generated segments to <samp>out.list</samp>: -<div class="example"> -<pre class="example">ffmpeg -i in.mkv -codec copy -map 0 -f segment -segment_list out.list out%03d.nut -</pre></div> - -</li><li> Segment input and set output format options for the output segments: -<div class="example"> -<pre class="example">ffmpeg -i in.mkv -f segment -segment_time 10 -segment_format_options movflags=+faststart out%03d.mp4 -</pre></div> - -</li><li> Segment the input file according to the split points specified by the -<var>segment_times</var> option: -<div class="example"> -<pre class="example">ffmpeg -i in.mkv -codec copy -map 0 -f segment -segment_list out.csv -segment_times 1,2,3,5,8,13,21 out%03d.nut -</pre></div> - -</li><li> Use the <code>ffmpeg</code> <samp>force_key_frames</samp> -option to force key frames in the input at the specified location, together -with the segment option <samp>segment_time_delta</samp> to account for -possible roundings operated when setting key frame times. -<div class="example"> -<pre class="example">ffmpeg -i in.mkv -force_key_frames 1,2,3,5,8,13,21 -codec:v mpeg4 -codec:a pcm_s16le -map 0 \ --f segment -segment_list out.csv -segment_times 1,2,3,5,8,13,21 -segment_time_delta 0.05 out%03d.nut -</pre></div> -<p>In order to force key frames on the input file, transcoding is -required. -</p> -</li><li> Segment the input file by splitting the input file according to the -frame numbers sequence specified with the <samp>segment_frames</samp> option: -<div class="example"> -<pre class="example">ffmpeg -i in.mkv -codec copy -map 0 -f segment -segment_list out.csv -segment_frames 100,200,300,500,800 out%03d.nut -</pre></div> - -</li><li> Convert the <samp>in.mkv</samp> to TS segments using the <code>libx264</code> -and <code>aac</code> encoders: -<div class="example"> -<pre class="example">ffmpeg -i in.mkv -map 0 -codec:v libx264 -codec:a aac -f ssegment -segment_list out.list out%03d.ts -</pre></div> - -</li><li> Segment the input file, and create an M3U8 live playlist (can be used -as live HLS source): -<div class="example"> -<pre class="example">ffmpeg -re -i in.mkv -codec copy -map 0 -f segment -segment_list playlist.m3u8 \ --segment_list_flags +live -segment_time 10 out%03d.mkv -</pre></div> -</li></ul> - -<a name="smoothstreaming"></a> -<h3 class="section">4.24 smoothstreaming<span class="pull-right"><a class="anchor hidden-xs" href="#smoothstreaming" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-smoothstreaming" aria-hidden="true">TOC</a></span></h3> - -<p>Smooth Streaming muxer generates a set of files (Manifest, chunks) suitable for serving with conventional web server. -</p> -<dl compact="compact"> -<dt><samp>window_size</samp></dt> -<dd><p>Specify the number of fragments kept in the manifest. Default 0 (keep all). -</p> -</dd> -<dt><samp>extra_window_size</samp></dt> -<dd><p>Specify the number of fragments kept outside of the manifest before removing from disk. Default 5. -</p> -</dd> -<dt><samp>lookahead_count</samp></dt> -<dd><p>Specify the number of lookahead fragments. Default 2. -</p> -</dd> -<dt><samp>min_frag_duration</samp></dt> -<dd><p>Specify the minimum fragment duration (in microseconds). Default 5000000. -</p> -</dd> -<dt><samp>remove_at_exit</samp></dt> -<dd><p>Specify whether to remove all fragments when finished. Default 0 (do not remove). -</p> -</dd> -</dl> - -<a name="fifo"></a> -<h3 class="section">4.25 fifo<span class="pull-right"><a class="anchor hidden-xs" href="#fifo" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-fifo" aria-hidden="true">TOC</a></span></h3> - -<p>The fifo pseudo-muxer allows the separation of encoding and muxing by using -first-in-first-out queue and running the actual muxer in a separate thread. This -is especially useful in combination with the <a href="#tee">tee</a> muxer and can be used to -send data to several destinations with different reliability/writing speed/latency. -</p> -<p>API users should be aware that callback functions (interrupt_callback, -io_open and io_close) used within its AVFormatContext must be thread-safe. -</p> -<p>The behavior of the fifo muxer if the queue fills up or if the output fails is -selectable, -</p> -<ul> -<li> output can be transparently restarted with configurable delay between retries -based on real time or time of the processed stream. - -</li><li> encoding can be blocked during temporary failure, or continue transparently -dropping packets in case fifo queue fills up. - -</li></ul> - -<dl compact="compact"> -<dt><samp>fifo_format</samp></dt> -<dd><p>Specify the format name. Useful if it cannot be guessed from the -output name suffix. -</p> -</dd> -<dt><samp>queue_size</samp></dt> -<dd><p>Specify size of the queue (number of packets). Default value is 60. -</p> -</dd> -<dt><samp>format_opts</samp></dt> -<dd><p>Specify format options for the underlying muxer. Muxer options can be specified -as a list of <var>key</var>=<var>value</var> pairs separated by ’:’. -</p> -</dd> -<dt><samp>drop_pkts_on_overflow <var>bool</var></samp></dt> -<dd><p>If set to 1 (true), in case the fifo queue fills up, packets will be dropped -rather than blocking the encoder. This allows to continue streaming without -delaying the input, at the cost of ommiting part of the stream. By default -this option is set to 0 (false), so in such cases the encoder will be blocked -until the muxer processes some of the packets and none of them is lost. -</p> -</dd> -<dt><samp>attempt_recovery <var>bool</var></samp></dt> -<dd><p>If failure occurs, attempt to recover the output. This is especially useful -when used with network output, allows to restart streaming transparently. -By default this option is set to 0 (false). -</p> -</dd> -<dt><samp>max_recovery_attempts</samp></dt> -<dd><p>Sets maximum number of successive unsuccessful recovery attempts after which -the output fails permanently. By default this option is set to 0 (unlimited). -</p> -</dd> -<dt><samp>recovery_wait_time <var>duration</var></samp></dt> -<dd><p>Waiting time before the next recovery attempt after previous unsuccessful -recovery attempt. Default value is 5 seconds. -</p> -</dd> -<dt><samp>recovery_wait_streamtime <var>bool</var></samp></dt> -<dd><p>If set to 0 (false), the real time is used when waiting for the recovery -attempt (i.e. the recovery will be attempted after at least -recovery_wait_time seconds). -If set to 1 (true), the time of the processed stream is taken into account -instead (i.e. the recovery will be attempted after at least <var>recovery_wait_time</var> -seconds of the stream is omitted). -By default, this option is set to 0 (false). -</p> -</dd> -<dt><samp>recover_any_error <var>bool</var></samp></dt> -<dd><p>If set to 1 (true), recovery will be attempted regardless of type of the error -causing the failure. By default this option is set to 0 (false) and in case of -certain (usually permanent) errors the recovery is not attempted even when -<var>attempt_recovery</var> is set to 1. -</p> -</dd> -<dt><samp>restart_with_keyframe <var>bool</var></samp></dt> -<dd><p>Specify whether to wait for the keyframe after recovering from -queue overflow or failure. This option is set to 0 (false) by default. -</p> -</dd> -</dl> - -<a name="Examples-10"></a> -<h4 class="subsection">4.25.1 Examples<span class="pull-right"><a class="anchor hidden-xs" href="#Examples-10" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Examples-10" aria-hidden="true">TOC</a></span></h4> - -<ul> -<li> Stream something to rtmp server, continue processing the stream at real-time -rate even in case of temporary failure (network outage) and attempt to recover -streaming every second indefinitely. -<div class="example"> -<pre class="example">ffmpeg -re -i ... -c:v libx264 -c:a aac -f fifo -fifo_format flv -map 0:v -map 0:a - -drop_pkts_on_overflow 1 -attempt_recovery 1 -recovery_wait_time 1 rtmp://example.com/live/stream_name -</pre></div> - -</li></ul> - -<a name="tee"></a><a name="tee-1"></a> -<h3 class="section">4.26 tee<span class="pull-right"><a class="anchor hidden-xs" href="#tee-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-tee-1" aria-hidden="true">TOC</a></span></h3> - -<p>The tee muxer can be used to write the same data to several files or any -other kind of muxer. It can be used, for example, to both stream a video to -the network and save it to disk at the same time. -</p> -<p>It is different from specifying several outputs to the <code>ffmpeg</code> -command-line tool because the audio and video data will be encoded only once -with the tee muxer; encoding can be a very expensive process. It is not -useful when using the libavformat API directly because it is then possible -to feed the same packets to several muxers directly. -</p> -<p>The slave outputs are specified in the file name given to the muxer, -separated by ’|’. If any of the slave name contains the ’|’ separator, -leading or trailing spaces or any special character, it must be -escaped (see <a href="ffmpeg-utils.html#quoting_005fand_005fescaping">(ffmpeg-utils)the "Quoting and escaping" -section in the ffmpeg-utils(1) manual</a>). -</p> -<p>Muxer options can be specified for each slave by prepending them as a list of -<var>key</var>=<var>value</var> pairs separated by ’:’, between square brackets. If -the options values contain a special character or the ’:’ separator, they -must be escaped; note that this is a second level escaping. -</p> -<p>The following special options are also recognized: -</p><dl compact="compact"> -<dt><samp>f</samp></dt> -<dd><p>Specify the format name. Useful if it cannot be guessed from the -output name suffix. -</p> -</dd> -<dt><samp>bsfs[/<var>spec</var>]</samp></dt> -<dd><p>Specify a list of bitstream filters to apply to the specified -output. -</p> -<p>It is possible to specify to which streams a given bitstream filter -applies, by appending a stream specifier to the option separated by -<code>/</code>. <var>spec</var> must be a stream specifier (see <a href="#Format-stream-specifiers">Format stream specifiers</a>). If the stream specifier is not specified, the -bitstream filters will be applied to all streams in the output. -</p> -<p>Several bitstream filters can be specified, separated by ",". -</p> -</dd> -<dt><samp>select</samp></dt> -<dd><p>Select the streams that should be mapped to the slave output, -specified by a stream specifier. If not specified, this defaults to -all the input streams. You may use multiple stream specifiers -separated by commas (<code>,</code>) e.g.: <code>a:0,v</code> -</p> -</dd> -<dt><samp>onfail</samp></dt> -<dd><p>Specify behaviour on output failure. This can be set to either <code>abort</code> (which is -default) or <code>ignore</code>. <code>abort</code> will cause whole process to fail in case of failure -on this slave output. <code>ignore</code> will ignore failure on this output, so other outputs -will continue without being affected. -</p></dd> -</dl> - -<a name="Examples-11"></a> -<h4 class="subsection">4.26.1 Examples<span class="pull-right"><a class="anchor hidden-xs" href="#Examples-11" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Examples-11" aria-hidden="true">TOC</a></span></h4> - -<ul> -<li> Encode something and both archive it in a WebM file and stream it -as MPEG-TS over UDP (the streams need to be explicitly mapped): -<div class="example"> -<pre class="example">ffmpeg -i ... -c:v libx264 -c:a mp2 -f tee -map 0:v -map 0:a - "archive-20121107.mkv|[f=mpegts]udp://10.0.1.255:1234/" -</pre></div> - -</li><li> As above, but continue streaming even if output to local file fails -(for example local drive fills up): -<div class="example"> -<pre class="example">ffmpeg -i ... -c:v libx264 -c:a mp2 -f tee -map 0:v -map 0:a - "[onfail=ignore]archive-20121107.mkv|[f=mpegts]udp://10.0.1.255:1234/" -</pre></div> - -</li><li> Use <code>ffmpeg</code> to encode the input, and send the output -to three different destinations. The <code>dump_extra</code> bitstream -filter is used to add extradata information to all the output video -keyframes packets, as requested by the MPEG-TS format. The select -option is applied to <samp>out.aac</samp> in order to make it contain only -audio packets. -<div class="example"> -<pre class="example">ffmpeg -i ... -map 0 -flags +global_header -c:v libx264 -c:a aac -strict experimental - -f tee "[bsfs/v=dump_extra]out.ts|[movflags=+faststart]out.mp4|[select=a]out.aac" -</pre></div> - -</li><li> As below, but select only stream <code>a:1</code> for the audio output. Note -that a second level escaping must be performed, as ":" is a special -character used to separate options. -<div class="example"> -<pre class="example">ffmpeg -i ... -map 0 -flags +global_header -c:v libx264 -c:a aac -strict experimental - -f tee "[bsfs/v=dump_extra]out.ts|[movflags=+faststart]out.mp4|[select=\'a:1\']out.aac" -</pre></div> -</li></ul> - -<p>Note: some codecs may need different options depending on the output format; -the auto-detection of this can not work with the tee muxer. The main example -is the <samp>global_header</samp> flag. -</p> -<a name="webm_005fdash_005fmanifest"></a> -<h3 class="section">4.27 webm_dash_manifest<span class="pull-right"><a class="anchor hidden-xs" href="#webm_005fdash_005fmanifest" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-webm_005fdash_005fmanifest" aria-hidden="true">TOC</a></span></h3> - -<p>WebM DASH Manifest muxer. -</p> -<p>This muxer implements the WebM DASH Manifest specification to generate the DASH -manifest XML. It also supports manifest generation for DASH live streams. -</p> -<p>For more information see: -</p> -<ul> -<li> WebM DASH Specification: <a href="https://sites.google.com/a/webmproject.org/wiki/adaptive-streaming/webm-dash-specification">https://sites.google.com/a/webmproject.org/wiki/adaptive-streaming/webm-dash-specification</a> -</li><li> ISO DASH Specification: <a href="http://standards.iso.org/ittf/PubliclyAvailableStandards/c065274_ISO_IEC_23009-1_2014.zip">http://standards.iso.org/ittf/PubliclyAvailableStandards/c065274_ISO_IEC_23009-1_2014.zip</a> -</li></ul> - -<a name="Options-11"></a> -<h4 class="subsection">4.27.1 Options<span class="pull-right"><a class="anchor hidden-xs" href="#Options-11" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Options-11" aria-hidden="true">TOC</a></span></h4> - -<p>This muxer supports the following options: -</p> -<dl compact="compact"> -<dt><samp>adaptation_sets</samp></dt> -<dd><p>This option has the following syntax: "id=x,streams=a,b,c id=y,streams=d,e" where x and y are the -unique identifiers of the adaptation sets and a,b,c,d and e are the indices of the corresponding -audio and video streams. Any number of adaptation sets can be added using this option. -</p> -</dd> -<dt><samp>live</samp></dt> -<dd><p>Set this to 1 to create a live stream DASH Manifest. Default: 0. -</p> -</dd> -<dt><samp>chunk_start_index</samp></dt> -<dd><p>Start index of the first chunk. This will go in the ‘<samp>startNumber</samp>’ attribute -of the ‘<samp>SegmentTemplate</samp>’ element in the manifest. Default: 0. -</p> -</dd> -<dt><samp>chunk_duration_ms</samp></dt> -<dd><p>Duration of each chunk in milliseconds. This will go in the ‘<samp>duration</samp>’ -attribute of the ‘<samp>SegmentTemplate</samp>’ element in the manifest. Default: 1000. -</p> -</dd> -<dt><samp>utc_timing_url</samp></dt> -<dd><p>URL of the page that will return the UTC timestamp in ISO format. This will go -in the ‘<samp>value</samp>’ attribute of the ‘<samp>UTCTiming</samp>’ element in the manifest. -Default: None. -</p> -</dd> -<dt><samp>time_shift_buffer_depth</samp></dt> -<dd><p>Smallest time (in seconds) shifting buffer for which any Representation is -guaranteed to be available. This will go in the ‘<samp>timeShiftBufferDepth</samp>’ -attribute of the ‘<samp>MPD</samp>’ element. Default: 60. -</p> -</dd> -<dt><samp>minimum_update_period</samp></dt> -<dd><p>Minimum update period (in seconds) of the manifest. This will go in the -‘<samp>minimumUpdatePeriod</samp>’ attribute of the ‘<samp>MPD</samp>’ element. Default: 0. -</p> -</dd> -</dl> - -<a name="Example-2"></a> -<h4 class="subsection">4.27.2 Example<span class="pull-right"><a class="anchor hidden-xs" href="#Example-2" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Example-2" aria-hidden="true">TOC</a></span></h4> -<div class="example"> -<pre class="example">ffmpeg -f webm_dash_manifest -i video1.webm \ - -f webm_dash_manifest -i video2.webm \ - -f webm_dash_manifest -i audio1.webm \ - -f webm_dash_manifest -i audio2.webm \ - -map 0 -map 1 -map 2 -map 3 \ - -c copy \ - -f webm_dash_manifest \ - -adaptation_sets "id=0,streams=0,1 id=1,streams=2,3" \ - manifest.xml -</pre></div> - -<a name="webm_005fchunk"></a> -<h3 class="section">4.28 webm_chunk<span class="pull-right"><a class="anchor hidden-xs" href="#webm_005fchunk" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-webm_005fchunk" aria-hidden="true">TOC</a></span></h3> - -<p>WebM Live Chunk Muxer. -</p> -<p>This muxer writes out WebM headers and chunks as separate files which can be -consumed by clients that support WebM Live streams via DASH. -</p> -<a name="Options-12"></a> -<h4 class="subsection">4.28.1 Options<span class="pull-right"><a class="anchor hidden-xs" href="#Options-12" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Options-12" aria-hidden="true">TOC</a></span></h4> - -<p>This muxer supports the following options: -</p> -<dl compact="compact"> -<dt><samp>chunk_start_index</samp></dt> -<dd><p>Index of the first chunk (defaults to 0). -</p> -</dd> -<dt><samp>header</samp></dt> -<dd><p>Filename of the header where the initialization data will be written. -</p> -</dd> -<dt><samp>audio_chunk_duration</samp></dt> -<dd><p>Duration of each audio chunk in milliseconds (defaults to 5000). -</p></dd> -</dl> - -<a name="Example-3"></a> -<h4 class="subsection">4.28.2 Example<span class="pull-right"><a class="anchor hidden-xs" href="#Example-3" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Example-3" aria-hidden="true">TOC</a></span></h4> -<div class="example"> -<pre class="example">ffmpeg -f v4l2 -i /dev/video0 \ - -f alsa -i hw:0 \ - -map 0:0 \ - -c:v libvpx-vp9 \ - -s 640x360 -keyint_min 30 -g 30 \ - -f webm_chunk \ - -header webm_live_video_360.hdr \ - -chunk_start_index 1 \ - webm_live_video_360_%d.chk \ - -map 1:0 \ - -c:a libvorbis \ - -b:a 128k \ - -f webm_chunk \ - -header webm_live_audio_128.hdr \ - -chunk_start_index 1 \ - -audio_chunk_duration 1000 \ - webm_live_audio_128_%d.chk -</pre></div> - -<a name="Metadata-1"></a> -<h2 class="chapter">5 Metadata<span class="pull-right"><a class="anchor hidden-xs" href="#Metadata-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Metadata-1" aria-hidden="true">TOC</a></span></h2> - -<p>FFmpeg is able to dump metadata from media files into a simple UTF-8-encoded -INI-like text file and then load it back using the metadata muxer/demuxer. -</p> -<p>The file format is as follows: -</p><ol> -<li> A file consists of a header and a number of metadata tags divided into sections, -each on its own line. - -</li><li> The header is a ‘<samp>;FFMETADATA</samp>’ string, followed by a version number (now 1). - -</li><li> Metadata tags are of the form ‘<samp>key=value</samp>’ - -</li><li> Immediately after header follows global metadata - -</li><li> After global metadata there may be sections with per-stream/per-chapter -metadata. - -</li><li> A section starts with the section name in uppercase (i.e. STREAM or CHAPTER) in -brackets (‘<samp>[</samp>’, ‘<samp>]</samp>’) and ends with next section or end of file. - -</li><li> At the beginning of a chapter section there may be an optional timebase to be -used for start/end values. It must be in form -‘<samp>TIMEBASE=<var>num</var>/<var>den</var></samp>’, where <var>num</var> and <var>den</var> are -integers. If the timebase is missing then start/end times are assumed to -be in milliseconds. - -<p>Next a chapter section must contain chapter start and end times in form -‘<samp>START=<var>num</var></samp>’, ‘<samp>END=<var>num</var></samp>’, where <var>num</var> is a positive -integer. -</p> -</li><li> Empty lines and lines starting with ‘<samp>;</samp>’ or ‘<samp>#</samp>’ are ignored. - -</li><li> Metadata keys or values containing special characters (‘<samp>=</samp>’, ‘<samp>;</samp>’, -‘<samp>#</samp>’, ‘<samp>\</samp>’ and a newline) must be escaped with a backslash ‘<samp>\</samp>’. - -</li><li> Note that whitespace in metadata (e.g. ‘<samp>foo = bar</samp>’) is considered to be -a part of the tag (in the example above key is ‘<samp>foo </samp>’, value is -‘<samp> bar</samp>’). -</li></ol> - -<p>A ffmetadata file might look like this: -</p><div class="example"> -<pre class="example">;FFMETADATA1 -title=bike\\shed -;this is a comment -artist=FFmpeg troll team - -[CHAPTER] -TIMEBASE=1/1000 -START=0 -#chapter ends at 0:01:00 -END=60000 -title=chapter \#1 -[STREAM] -title=multi\ -line -</pre></div> - -<p>By using the ffmetadata muxer and demuxer it is possible to extract -metadata from an input file to an ffmetadata file, and then transcode -the file into an output file with the edited ffmetadata file. -</p> -<p>Extracting an ffmetadata file with <samp>ffmpeg</samp> goes as follows: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -f ffmetadata FFMETADATAFILE -</pre></div> - -<p>Reinserting edited metadata information from the FFMETADATAFILE file can -be done as: -</p><div class="example"> -<pre class="example">ffmpeg -i INPUT -i FFMETADATAFILE -map_metadata 1 -codec copy OUTPUT -</pre></div> - - -<a name="See-Also"></a> -<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> - -<p><a href="ffmpeg.html">ffmpeg</a>, <a href="ffplay.html">ffplay</a>, <a href="ffprobe.html">ffprobe</a>, <a href="ffserver.html">ffserver</a>, -<a href="libavformat.html">libavformat</a> -</p> - -<a name="Authors"></a> -<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> - -<p>The FFmpeg developers. -</p> -<p>For details about the authorship, see the Git history of the project -(git://source.ffmpeg.org/ffmpeg), e.g. by typing the command -<code>git log</code> in the FFmpeg source directory, or browsing the -online repository at <a href="http://source.ffmpeg.org">http://source.ffmpeg.org</a>. -</p> -<p>Maintainers for the specific components are listed in the file -<samp>MAINTAINERS</samp> in the source code tree. -</p> - - - <p style="font-size: small;"> - This document was generated using <a href="http://www.gnu.org/software/texinfo/"><em>makeinfo</em></a>. - </p> - </div> - </body> -</html> |