\input texinfo @c -*- texinfo -*-@settitle FFmpeg Documentation@titlepage@sp 7@center @titlefont{FFmpeg Documentation}@sp 3@end titlepage@chapter IntroductionFFmpeg is a very fast video and audio converter. It can also grab froma live audio/video source.The command line interface is designed to be intuitive, in the sensethat FFmpeg tries to figure out all parameters that can possibly bederived automatically. You usually only have to specify the targetbitrate you want.FFmpeg can also convert from any sample rate to any other, and resizevideo on the fly with a high quality polyphase filter.@chapter Quick Start@c man begin EXAMPLES@section Video and Audio grabbingFFmpeg can use a video4linux compatible video source and any Open SoundSystem audio source:@exampleffmpeg /tmp/out.mpg@end exampleNote that you must activate the right video source and channel beforelaunching FFmpeg with any TV viewer such as xawtv(@url{http://bytesex.org/xawtv/}) by Gerd Knorr. You alsohave to set the audio recording levels correctly with astandard mixer.@section Video and Audio file format conversion* FFmpeg can use any supported file format and protocol as input:Examples:* You can use YUV files as input:@exampleffmpeg -i /tmp/test%d.Y /tmp/out.mpg@end exampleIt will use the files:@example/tmp/test0.Y, /tmp/test0.U, /tmp/test0.V,/tmp/test1.Y, /tmp/test1.U, /tmp/test1.V, etc...@end exampleThe Y files use twice the resolution of the U and V files. They areraw files, without header. They can be generated by all decent videodecoders. You must specify the size of the image with the @option{-s} optionif FFmpeg cannot guess it.* You can input from a raw YUV420P file:@exampleffmpeg -i /tmp/test.yuv /tmp/out.avi@end exampletest.yuv is a file containing raw YUV planar data. Each frame is composedof the Y plane followed by the U and V planes at half vertical andhorizontal resolution.* You can output to a raw YUV420P file:@exampleffmpeg -i mydivx.avi hugefile.yuv@end example* You can set several input files and output files:@exampleffmpeg -i /tmp/a.wav -s 640x480 -i /tmp/a.yuv /tmp/a.mpg@end exampleConverts the audio file a.wav and the raw YUV video file a.yuvto MPEG file a.mpg.* You can also do audio and video conversions at the same time:@exampleffmpeg -i /tmp/a.wav -ar 22050 /tmp/a.mp2@end exampleConverts a.wav to MPEG audio at 22050Hz sample rate.* You can encode to several formats at the same time and define amapping from input stream to output streams:@exampleffmpeg -i /tmp/a.wav -ab 64 /tmp/a.mp2 -ab 128 /tmp/b.mp2 -map 0:0 -map 0:0@end exampleConverts a.wav to a.mp2 at 64 kbits and to b.mp2 at 128 kbits. '-mapfile:index' specifies which input stream is used for each outputstream, in the order of the definition of output streams.* You can transcode decrypted VOBs@exampleffmpeg -i snatch_1.vob -f avi -vcodec mpeg4 -b 800 -g 300 -bf 2 -acodec mp3 -ab 128 snatch.avi@end exampleThis is a typical DVD ripping example; the input is a VOB file, theoutput an AVI file with MPEG-4 video and MP3 audio. Note that in thiscommand we use B-frames so the MPEG-4 stream is DivX5 compatible, andGOP size is 300 which means one intra frame every 10 seconds for 29.97fpsinput video. Furthermore, the audio stream is MP3-encoded so you needto enable LAME support by passing @code{--enable-mp3lame} to configure.The mapping is particularly useful for DVD transcodingto get the desired audio language.NOTE: To see the supported input formats, use @code{ffmpeg -formats}.@c man end@chapter Invocation@section SyntaxThe generic syntax is:@example@c man begin SYNOPSISffmpeg [[infile options][@option{-i} @var{infile}]]... @{[outfile options] @var{outfile}@}...@c man end@end example@c man begin DESCRIPTIONIf no input file is given, audio/video grabbing is done.As a general rule, options are applied to the next specifiedfile. For example, if you give the @option{-b 64} option, it sets the videobitrate of the next file. The format option may be needed for raw inputfiles.By default, FFmpeg tries to convert as losslessly as possible: Ituses the same audio and video parameters for the outputs as the onespecified for the inputs.@c man end@c man begin OPTIONS@section Main options@table @option@item -LShow license.@item -hShow help.@item -formatsShow available formats, codecs, protocols, ...@item -f fmtForce format.@item -i filenameinput filename@item -yOverwrite output files.@item -t durationSet the recording time in seconds.@code{hh:mm:ss[.xxx]} syntax is also supported.@item -ss positionSeek to given time position in seconds.@code{hh:mm:ss[.xxx]} syntax is also supported.@item -title stringSet the title.@item -author stringSet the author.@item -copyright stringSet the copyright.@item -comment stringSet the comment.@item -target typeSpecify target file type ("vcd", "svcd", "dvd", "dv", "pal-vcd","ntsc-svcd", ... ). All the format options (bitrate, codecs,buffer sizes) are then set automatically. You can just type:@exampleffmpeg -i myfile.avi -target vcd /tmp/vcd.mpg@end exampleNevertheless you can specify additional options as long as you knowthey do not conflict with the standard, as in:@exampleffmpeg -i myfile.avi -target vcd -bf 2 /tmp/vcd.mpg@end example@item -hqActivate high quality settings.@item -itsoffset offsetSet the input time offset in seconds.@code{[-]hh:mm:ss[.xxx]} syntax is also supported.This option affects all the input files that follow it.The offset is added to the timestamps of the input files.Specifying a positive offset means that the correspondingstreams are delayed by 'offset' seconds.@end table@section Video Options@table @option@item -b bitrateSet the video bitrate in kbit/s (default = 200 kb/s).@item -r fpsSet frame rate (default = 25).@item -s sizeSet frame size. The format is @samp{wxh} (default = 160x128).The following abbreviations are recognized:@table @samp@item sqcif128x96@item qcif176x144@item cif352x288@item 4cif704x576@end table@item -aspect aspectSet aspect ratio (4:3, 16:9 or 1.3333, 1.7777).@item -croptop sizeSet top crop band size (in pixels).@item -cropbottom sizeSet bottom crop band size (in pixels).@item -cropleft sizeSet left crop band size (in pixels).@item -cropright sizeSet right crop band size (in pixels).@item -padtop sizeSet top pad band size (in pixels).@item -padbottom sizeSet bottom pad band size (in pixels).@item -padleft sizeSet left pad band size (in pixels).@item -padright sizeSet right pad band size (in pixels).@item -padcolor (hex color)Set color of padded bands. The value for padcolor is expressedas a six digit hexadecimal number where the first two digitsrepresent red, the middle two digits green and last two digitsblue (default = 000000 (black)).@item -vnDisable video recording.@item -bt toleranceSet video bitrate tolerance (in kbit/s).@item -maxrate bitrateSet max video bitrate tolerance (in kbit/s).@item -minrate bitrateSet min video bitrate tolerance (in kbit/s).@item -bufsize sizeSet rate control buffer size (in kbit).@item -vcodec codecForce video codec to @var{codec}. Use the @code{copy} special value totell that the raw codec data must be copied as is.@item -sameqUse same video quality as source (implies VBR).@item -pass nSelect the pass number (1 or 2). It is useful to do two passencoding. The statistics of the video are recorded in the firstpass and the video is generated at the exact requested bitratein the second pass.@item -passlogfile fileSet two pass logfile name to @var{file}.@end table@section Advanced Video Options@table @option@item -g gop_sizeSet the group of pictures size.@item -intraUse only intra frames.@item -qscale qUse fixed video quantiser scale (VBR).@item -qmin qminimum video quantiser scale (VBR)@item -qmax qmaximum video quantiser scale (VBR)@item -qdiff qmaximum difference between the quantiser scales (VBR)@item -qblur blurvideo quantiser scale blur (VBR)@item -qcomp compressionvideo quantiser scale compression (VBR)@item -rc_init_cplx complexityinitial complexity for single pass encoding@item -b_qfactor factorqp factor between P- and B-frames@item -i_qfactor factorqp factor between P- and I-frames@item -b_qoffset offsetqp offset between P- and B-frames@item -i_qoffset offsetqp offset between P- and I-frames@item -rc_eq equationSet rate control equation (@pxref{FFmpeg formulaevaluator}) (default = @code{tex^qComp}).@item -rc_override overriderate control override for specific intervals@item -me methodSet motion estimation method to @var{method}.Available methods are (from lowest to best quality):@table @samp@item zeroTry just the (0, 0) vector.@item phods@item log@item x1@item epzs(default method)@item fullexhaustive search (slow and marginally better than epzs)@end table@item -dct_algo algo