1 \input texinfo @c -*- texinfo -*-
3 @settitle ffmpeg Documentation
5 @center @titlefont{ffmpeg Documentation}
14 The generic syntax is:
18 ffmpeg [[infile options][@option{-i} @var{infile}]]... @{[outfile options] @var{outfile}@}...
23 @c man begin DESCRIPTION
25 ffmpeg is a very fast video and audio converter that can also grab from
26 a live audio/video source. It can also convert between arbitrary sample
27 rates and resize video on the fly with a high quality polyphase filter.
29 The command line interface is designed to be intuitive, in the sense
30 that ffmpeg tries to figure out all parameters that can possibly be
31 derived automatically. You usually only have to specify the target
34 As a general rule, options are applied to the next specified
35 file. Therefore, order is important, and you can have the same
36 option on the command line multiple times. Each occurrence is
37 then applied to the next input or output file.
41 To set the video bitrate of the output file to 64kbit/s:
43 ffmpeg -i input.avi -b 64k output.avi
47 To force the frame rate of the output file to 24 fps:
49 ffmpeg -i input.avi -r 24 output.avi
53 To force the frame rate of the input file (valid for raw formats only)
54 to 1 fps and the frame rate of the output file to 24 fps:
56 ffmpeg -r 1 -i input.m2v -r 24 output.avi
60 The format option may be needed for raw input files.
62 By default ffmpeg tries to convert as losslessly as possible: It
63 uses the same audio and video parameters for the outputs as the one
64 specified for the inputs.
66 @c man end DESCRIPTION
71 @include fftools-common-opts.texi
80 @item -i @var{filename}
84 Overwrite output files.
86 @item -t @var{duration}
87 Restrict the transcoded/captured video sequence
88 to the duration specified in seconds.
89 @code{hh:mm:ss[.xxx]} syntax is also supported.
91 @item -fs @var{limit_size}
92 Set the file size limit.
94 @item -ss @var{position}
95 Seek to given time position in seconds.
96 @code{hh:mm:ss[.xxx]} syntax is also supported.
98 @item -itsoffset @var{offset}
99 Set the input time offset in seconds.
100 @code{[-]hh:mm:ss[.xxx]} syntax is also supported.
101 This option affects all the input files that follow it.
102 The offset is added to the timestamps of the input files.
103 Specifying a positive offset means that the corresponding
104 streams are delayed by 'offset' seconds.
106 @item -timestamp @var{time}
107 Set the recording timestamp in the container.
108 The syntax for @var{time} is:
110 now|([(YYYY-MM-DD|YYYYMMDD)[T|t| ]]((HH[:MM[:SS[.m...]]])|(HH[MM[SS[.m...]]]))[Z|z])
112 If the value is "now" it takes the current time.
113 Time is local time unless 'Z' or 'z' is appended, in which case it is
115 If the year-month-day part is not specified it takes the current
118 @item -metadata @var{key}=@var{value}
119 Set a metadata key/value pair.
121 For example, for setting the title in the output file:
123 ffmpeg -i in.avi -metadata title="my title" out.flv
126 @item -v @var{number}
127 Set the logging verbosity level.
129 @item -target @var{type}
130 Specify target file type ("vcd", "svcd", "dvd", "dv", "dv50", "pal-vcd",
131 "ntsc-svcd", ... ). All the format options (bitrate, codecs,
132 buffer sizes) are then set automatically. You can just type:
135 ffmpeg -i myfile.avi -target vcd /tmp/vcd.mpg
138 Nevertheless you can specify additional options as long as you know
139 they do not conflict with the standard, as in:
142 ffmpeg -i myfile.avi -target vcd -bf 2 /tmp/vcd.mpg
145 @item -dframes @var{number}
146 Set the number of data frames to record.
148 @item -scodec @var{codec}
149 Force subtitle codec ('copy' to copy stream).
152 Add a new subtitle stream to the current output stream.
154 @item -slang @var{code}
155 Set the ISO 639 language code (3 letters) of the current subtitle stream.
159 @section Video Options
162 @item -b @var{bitrate}
163 Set the video bitrate in bit/s (default = 200 kb/s).
164 @item -vframes @var{number}
165 Set the number of video frames to record.
167 Set frame rate (Hz value, fraction or abbreviation), (default = 25).
169 Set frame size. The format is @samp{wxh} (ffserver default = 160x128).
170 There is no default for input streams,
171 for output streams it is set by default to the size of the source stream.
172 If the input file has video streams with different resolutions, the behaviour is undefined.
173 The following abbreviations are recognized:
235 @item -aspect @var{aspect}
236 Set the video display aspect ratio specified by @var{aspect}.
238 @var{aspect} can be a floating point number string, or a string of the
239 form @var{num}:@var{den}, where @var{num} and @var{den} are the
240 numerator and denominator of the aspect ratio. For example "4:3",
241 "16:9", "1.3333", and "1.7777" are valid argument values.
243 @item -croptop @var{size}
244 @item -cropbottom @var{size}
245 @item -cropleft @var{size}
246 @item -cropright @var{size}
247 All the crop options have been removed. Use -vf
248 crop=width:height:x:y instead.
250 @item -padtop @var{size}
251 @item -padbottom @var{size}
252 @item -padleft @var{size}
253 @item -padright @var{size}
254 @item -padcolor @var{hex_color}
255 All the pad options have been removed. Use -vf
256 pad=width:height:x:y:color instead.
258 Disable video recording.
259 @item -bt @var{tolerance}
260 Set video bitrate tolerance (in bits, default 4000k).
261 Has a minimum value of: (target_bitrate/target_framerate).
262 In 1-pass mode, bitrate tolerance specifies how far ratecontrol is
263 willing to deviate from the target average bitrate value. This is
264 not related to min/max bitrate. Lowering tolerance too much has
265 an adverse effect on quality.
266 @item -maxrate @var{bitrate}
267 Set max video bitrate (in bit/s).
268 Requires -bufsize to be set.
269 @item -minrate @var{bitrate}
270 Set min video bitrate (in bit/s).
271 Most useful in setting up a CBR encode:
273 ffmpeg -i myfile.avi -b 4000k -minrate 4000k -maxrate 4000k -bufsize 1835k out.m2v
275 It is of little use elsewise.
276 @item -bufsize @var{size}
277 Set video buffer verifier buffer size (in bits).
278 @item -vcodec @var{codec}
279 Force video codec to @var{codec}. Use the @code{copy} special value to
280 tell that the raw codec data must be copied as is.
282 Use same quantizer as source (implies VBR).
285 Select the pass number (1 or 2). It is used to do two-pass
286 video encoding. The statistics of the video are recorded in the first
287 pass into a log file (see also the option -passlogfile),
288 and in the second pass that log file is used to generate the video
289 at the exact requested bitrate.
290 On pass 1, you may just deactivate audio and set output to null,
291 examples for Windows and Unix:
293 ffmpeg -i foo.mov -vcodec libxvid -pass 1 -an -f rawvideo -y NUL
294 ffmpeg -i foo.mov -vcodec libxvid -pass 1 -an -f rawvideo -y /dev/null
297 @item -passlogfile @var{prefix}
298 Set two-pass log file name prefix to @var{prefix}, the default file name
299 prefix is ``ffmpeg2pass''. The complete file name will be
300 @file{PREFIX-N.log}, where N is a number specific to the output
304 Add a new video stream to the current output stream.
306 @item -vlang @var{code}
307 Set the ISO 639 language code (3 letters) of the current video stream.
309 @item -vf @var{filter_graph}
310 @var{filter_graph} is a description of the filter graph to apply to
312 Use the option "-filters" to show all the available filters (including
313 also sources and sinks).
317 @section Advanced Video Options
320 @item -pix_fmt @var{format}
321 Set pixel format. Use 'list' as parameter to show all the supported
323 @item -sws_flags @var{flags}
325 @item -g @var{gop_size}
326 Set the group of pictures size.
328 Use only intra frames.
331 @item -qscale @var{q}
332 Use fixed video quantizer scale (VBR).
334 minimum video quantizer scale (VBR)
336 maximum video quantizer scale (VBR)
338 maximum difference between the quantizer scales (VBR)
339 @item -qblur @var{blur}
340 video quantizer scale blur (VBR) (range 0.0 - 1.0)
341 @item -qcomp @var{compression}
342 video quantizer scale compression (VBR) (default 0.5).
343 Constant of ratecontrol equation. Recommended range for default rc_eq: 0.0-1.0
345 @item -lmin @var{lambda}
346 minimum video lagrange factor (VBR)
347 @item -lmax @var{lambda}
348 max video lagrange factor (VBR)
349 @item -mblmin @var{lambda}
350 minimum macroblock quantizer scale (VBR)
351 @item -mblmax @var{lambda}
352 maximum macroblock quantizer scale (VBR)
354 These four options (lmin, lmax, mblmin, mblmax) use 'lambda' units,
355 but you may use the QP2LAMBDA constant to easily convert from 'q' units:
357 ffmpeg -i src.ext -lmax 21*QP2LAMBDA dst.ext
360 @item -rc_init_cplx @var{complexity}
361 initial complexity for single pass encoding
362 @item -b_qfactor @var{factor}
363 qp factor between P- and B-frames
364 @item -i_qfactor @var{factor}
365 qp factor between P- and I-frames
366 @item -b_qoffset @var{offset}
367 qp offset between P- and B-frames
368 @item -i_qoffset @var{offset}
369 qp offset between P- and I-frames
370 @item -rc_eq @var{equation}
371 Set rate control equation (see section "Expression Evaluation")
372 (default = @code{tex^qComp}).
374 When computing the rate control equation expression, besides the
375 standard functions defined in the section "Expression Evaluation", the
376 following functions are available:
382 and the following constants are available:
404 @item -rc_override @var{override}
405 Rate control override for specific intervals, formated as "int,int,int"
406 list separated with slashes. Two first values are the beginning and
407 end frame numbers, last one is quantizer to use if positive, or quality
409 @item -me_method @var{method}
410 Set motion estimation method to @var{method}.
411 Available methods are (from lowest to best quality):
414 Try just the (0, 0) vector.
423 exhaustive search (slow and marginally better than epzs)
426 @item -dct_algo @var{algo}
427 Set DCT algorithm to @var{algo}. Available values are:
430 FF_DCT_AUTO (default)
443 @item -idct_algo @var{algo}
444 Set IDCT algorithm to @var{algo}. Available values are:
447 FF_IDCT_AUTO (default)
471 Set error resilience to @var{n}.
474 FF_ER_CAREFUL (default)
480 FF_ER_VERY_AGGRESSIVE
483 @item -ec @var{bit_mask}
484 Set error concealment to @var{bit_mask}. @var{bit_mask} is a bit mask of
485 the following values:
488 FF_EC_GUESS_MVS (default = enabled)
490 FF_EC_DEBLOCK (default = enabled)
493 @item -bf @var{frames}
494 Use 'frames' B-frames (supported for MPEG-1, MPEG-2 and MPEG-4).
495 @item -mbd @var{mode}
499 FF_MB_DECISION_SIMPLE: Use mb_cmp (cannot change it yet in ffmpeg).
501 FF_MB_DECISION_BITS: Choose the one which needs the fewest bits.
503 FF_MB_DECISION_RD: rate distortion
507 Use four motion vector by macroblock (MPEG-4 only).
509 Use data partitioning (MPEG-4 only).
510 @item -bug @var{param}
511 Work around encoder bugs that are not auto-detected.
512 @item -strict @var{strictness}
513 How strictly to follow the standards.
515 Enable Advanced intra coding (h263+).
517 Enable Unlimited Motion Vector (h263+)
520 Deinterlace pictures.
522 Force interlacing support in encoder (MPEG-2 and MPEG-4 only).
523 Use this option if your input file is interlaced and you want
524 to keep the interlaced format for minimum losses.
525 The alternative is to deinterlace the input stream with
526 @option{-deinterlace}, but deinterlacing introduces losses.
528 Calculate PSNR of compressed frames.
530 Dump video coding statistics to @file{vstats_HHMMSS.log}.
531 @item -vstats_file @var{file}
532 Dump video coding statistics to @var{file}.
534 top=1/bottom=0/auto=-1 field first
535 @item -dc @var{precision}
537 @item -vtag @var{fourcc/tag}
538 Force video tag/fourcc.
541 @item -vbsf @var{bitstream_filter}
542 Bitstream filters available are "dump_extra", "remove_extra", "noise", "h264_mp4toannexb", "imxdump", "mjpegadump", "mjpeg2jpeg".
544 ffmpeg -i h264.mp4 -vcodec copy -vbsf h264_mp4toannexb -an out.h264
546 @item -force_key_frames @var{time}[,@var{time}...]
547 Force key frames at the specified timestamps, more precisely at the first
548 frames after each specified time.
549 This option can be useful to ensure that a seek point is present at a
550 chapter mark or any other designated place in the output file.
551 The timestamps must be specified in ascending order.
554 @section Audio Options
557 @item -aframes @var{number}
558 Set the number of audio frames to record.
560 Set the audio sampling frequency. For input streams it is set by
561 default to 44100 Hz, for output streams it is set by default to the
562 frequency of the input stream. If the input file has audio streams
563 with different frequencies, the behaviour is undefined.
564 @item -ab @var{bitrate}
565 Set the audio bitrate in bit/s (default = 64k).
567 Set the audio quality (codec-specific, VBR).
568 @item -ac @var{channels}
569 Set the number of audio channels. For input streams it is set by
570 default to 1, for output streams it is set by default to the same
571 number of audio channels in input. If the input file has audio streams
572 with different channel count, the behaviour is undefined.
574 Disable audio recording.
575 @item -acodec @var{codec}
576 Force audio codec to @var{codec}. Use the @code{copy} special value to
577 specify that the raw codec data must be copied as is.
579 Add a new audio track to the output file. If you want to specify parameters,
580 do so before @code{-newaudio} (@code{-acodec}, @code{-ab}, etc..).
582 Mapping will be done automatically, if the number of output streams is equal to
583 the number of input streams, else it will pick the first one that matches. You
584 can override the mapping using @code{-map} as usual.
588 ffmpeg -i file.mpg -vcodec copy -acodec ac3 -ab 384k test.mpg -acodec mp2 -ab 192k -newaudio
590 @item -alang @var{code}
591 Set the ISO 639 language code (3 letters) of the current audio stream.
594 @section Advanced Audio options:
597 @item -atag @var{fourcc/tag}
598 Force audio tag/fourcc.
599 @item -audio_service_type @var{type}
600 Set the type of service that the audio stream contains.
603 Main Audio Service (default)
621 @item -absf @var{bitstream_filter}
622 Bitstream filters available are "dump_extra", "remove_extra", "noise", "mp3comp", "mp3decomp".
625 @section Subtitle options:
628 @item -scodec @var{codec}
629 Force subtitle codec ('copy' to copy stream).
631 Add a new subtitle stream to the current output stream.
632 @item -slang @var{code}
633 Set the ISO 639 language code (3 letters) of the current subtitle stream.
635 Disable subtitle recording.
636 @item -sbsf @var{bitstream_filter}
637 Bitstream filters available are "mov2textsub", "text2movsub".
639 ffmpeg -i file.mov -an -vn -sbsf mov2textsub -scodec copy -f rawvideo sub.txt
643 @section Audio/Video grab options
646 @item -vc @var{channel}
647 Set video grab channel (DV1394 only).
648 @item -tvstd @var{standard}
649 Set television standard (NTSC, PAL (SECAM)).
651 Synchronize read on input.
654 @section Advanced options
657 @item -map @var{input_file_id}.@var{input_stream_id}[:@var{sync_file_id}.@var{sync_stream_id}]
659 Designate an input stream as a source for the output file. Each input
660 stream is identified by the input file index @var{input_file_id} and
661 the input stream index @var{input_stream_id} within the input
662 file. Both indexes start at 0. If specified,
663 @var{sync_file_id}.@var{sync_stream_id} sets which input stream
664 is used as a presentation sync reference.
666 The @code{-map} options must be specified just after the output file.
667 If any @code{-map} options are used, the number of @code{-map} options
668 on the command line must match the number of streams in the output
669 file. The first @code{-map} option on the command line specifies the
670 source for output stream 0, the second @code{-map} option specifies
671 the source for output stream 1, etc.
673 For example, if you have two audio streams in the first input file,
674 these streams are identified by "0.0" and "0.1". You can use
675 @code{-map} to select which stream to place in an output file. For
678 ffmpeg -i INPUT out.wav -map 0.1
680 will map the input stream in @file{INPUT} identified by "0.1" to
681 the (single) output stream in @file{out.wav}.
683 For example, to select the stream with index 2 from input file
684 @file{a.mov} (specified by the identifier "0.2"), and stream with
685 index 6 from input @file{b.mov} (specified by the identifier "1.6"),
686 and copy them to the output file @file{out.mov}:
688 ffmpeg -i a.mov -i b.mov -vcodec copy -acodec copy out.mov -map 0.2 -map 1.6
691 To add more streams to the output file, you can use the
692 @code{-newaudio}, @code{-newvideo}, @code{-newsubtitle} options.
694 @item -map_meta_data @var{outfile}[,@var{metadata}]:@var{infile}[,@var{metadata}]
695 Deprecated, use @var{-map_metadata} instead.
697 @item -map_metadata @var{outfile}[,@var{metadata}]:@var{infile}[,@var{metadata}]
698 Set metadata information of @var{outfile} from @var{infile}. Note that those
699 are file indices (zero-based), not filenames.
700 Optional @var{metadata} parameters specify, which metadata to copy - (g)lobal
701 (i.e. metadata that applies to the whole file), per-(s)tream, per-(c)hapter or
702 per-(p)rogram. All metadata specifiers other than global must be followed by the
703 stream/chapter/program number. If metadata specifier is omitted, it defaults to
706 By default, global metadata is copied from the first input file to all output files,
707 per-stream and per-chapter metadata is copied along with streams/chapters. These
708 default mappings are disabled by creating any mapping of the relevant type. A negative
709 file index can be used to create a dummy mapping that just disables automatic copying.
711 For example to copy metadata from the first stream of the input file to global metadata
714 ffmpeg -i in.ogg -map_metadata 0:0,s0 out.mp3
716 @item -map_chapters @var{outfile}:@var{infile}
717 Copy chapters from @var{infile} to @var{outfile}. If no chapter mapping is specified,
718 then chapters are copied from the first input file with at least one chapter to all
719 output files. Use a negative file index to disable any chapter copying.
721 Print specific debug info.
723 Show benchmarking information at the end of an encode.
724 Shows CPU time used and maximum memory consumption.
725 Maximum memory consumption is not supported on all systems,
726 it will usually display as 0 if not supported.
728 Dump each input packet.
730 When dumping packets, also dump the payload.
732 Only use bit exact algorithms (for codec testing).
734 Set RTP payload size in bytes.
736 Read input at native frame rate. Mainly used to simulate a grab device.
738 Loop over the input stream. Currently it works only for image
739 streams. This option is used for automatic FFserver testing.
740 @item -loop_output @var{number_of_times}
741 Repeatedly loop output for formats that support looping such as animated GIF
742 (0 will loop the output infinitely).
743 @item -threads @var{count}
745 @item -vsync @var{parameter}
750 Each frame is passed with its timestamp from the demuxer to the muxer.
752 Frames will be duplicated and dropped to achieve exactly the requested
755 Frames are passed through with their timestamp or dropped so as to
756 prevent 2 frames from having the same timestamp.
758 Chooses between 1 and 2 depending on muxer capabilities. This is the
762 With -map you can select from which stream the timestamps should be
763 taken. You can leave either video or audio unchanged and sync the
764 remaining stream(s) to the unchanged one.
766 @item -async @var{samples_per_second}
767 Audio sync method. "Stretches/squeezes" the audio stream to match the timestamps,
768 the parameter is the maximum samples per second by which the audio is changed.
769 -async 1 is a special case where only the start of the audio stream is corrected
770 without any later correction.
772 Copy timestamps from input to output.
774 Copy input stream time base from input to output when stream copying.
776 Finish encoding when the shortest input stream ends.
777 @item -dts_delta_threshold
778 Timestamp discontinuity delta threshold.
779 @item -muxdelay @var{seconds}
780 Set the maximum demux-decode delay.
781 @item -muxpreload @var{seconds}
782 Set the initial demux-decode delay.
783 @item -streamid @var{output-stream-index}:@var{new-value}
784 Assign a new stream-id value to an output stream. This option should be
785 specified prior to the output filename to which it applies.
786 For the situation where multiple output files exist, a streamid
787 may be reassigned to a different value.
789 For example, to set the stream 0 PID to 33 and the stream 1 PID to 36 for
790 an output mpegts file:
792 ffmpeg -i infile -streamid 0:33 -streamid 1:36 out.ts
796 @section Preset files
798 A preset file contains a sequence of @var{option}=@var{value} pairs,
799 one for each line, specifying a sequence of options which would be
800 awkward to specify on the command line. Lines starting with the hash
801 ('#') character are ignored and are used to provide comments. Check
802 the @file{ffpresets} directory in the FFmpeg source tree for examples.
804 Preset files are specified with the @code{vpre}, @code{apre},
805 @code{spre}, and @code{fpre} options. The @code{fpre} option takes the
806 filename of the preset instead of a preset name as input and can be
807 used for any kind of codec. For the @code{vpre}, @code{apre}, and
808 @code{spre} options, the options specified in a preset file are
809 applied to the currently selected codec of the same type as the preset
812 The argument passed to the @code{vpre}, @code{apre}, and @code{spre}
813 preset options identifies the preset file to use according to the
816 First ffmpeg searches for a file named @var{arg}.ffpreset in the
817 directories @file{$FFMPEG_DATADIR} (if set), and @file{$HOME/.ffmpeg}, and in
818 the datadir defined at configuration time (usually @file{PREFIX/share/ffmpeg})
819 or in a @file{ffpresets} folder along the executable on win32,
820 in that order. For example, if the argument is @code{libx264-max}, it will
821 search for the file @file{libx264-max.ffpreset}.
823 If no such file is found, then ffmpeg will search for a file named
824 @var{codec_name}-@var{arg}.ffpreset in the above-mentioned
825 directories, where @var{codec_name} is the name of the codec to which
826 the preset file options will be applied. For example, if you select
827 the video codec with @code{-vcodec libx264} and use @code{-vpre max},
828 then it will search for the file @file{libx264-max.ffpreset}.
836 For streaming at very low bitrate application, use a low frame rate
837 and a small GOP size. This is especially true for RealVideo where
838 the Linux player does not seem to be very fast, so it can miss
839 frames. An example is:
842 ffmpeg -g 3 -r 3 -t 10 -b 50k -s qcif -f rv10 /tmp/b.rm
846 The parameter 'q' which is displayed while encoding is the current
847 quantizer. The value 1 indicates that a very good quality could
848 be achieved. The value 31 indicates the worst quality. If q=31 appears
849 too often, it means that the encoder cannot compress enough to meet
850 your bitrate. You must either increase the bitrate, decrease the
851 frame rate or decrease the frame size.
854 If your computer is not fast enough, you can speed up the
855 compression at the expense of the compression ratio. You can use
856 '-me zero' to speed up motion estimation, and '-intra' to disable
857 motion estimation completely (you have only I-frames, which means it
858 is about as good as JPEG compression).
861 To have very low audio bitrates, reduce the sampling frequency
862 (down to 22050 Hz for MPEG audio, 22050 or 11025 for AC-3).
865 To have a constant quality (but a variable bitrate), use the option
866 '-qscale n' when 'n' is between 1 (excellent quality) and 31 (worst
870 When converting video files, you can use the '-sameq' option which
871 uses the same quality factor in the encoder as in the decoder.
872 It allows almost lossless encoding.
878 @c man begin EXAMPLES
880 @section Video and Audio grabbing
882 If you specify the input format and device then ffmpeg can grab video
886 ffmpeg -f oss -i /dev/dsp -f video4linux2 -i /dev/video0 /tmp/out.mpg
889 Note that you must activate the right video source and channel before
890 launching ffmpeg with any TV viewer such as xawtv
891 (@url{http://linux.bytesex.org/xawtv/}) by Gerd Knorr. You also
892 have to set the audio recording levels correctly with a
895 @section X11 grabbing
897 Grab the X11 display with ffmpeg via
900 ffmpeg -f x11grab -s cif -r 25 -i :0.0 /tmp/out.mpg
903 0.0 is display.screen number of your X11 server, same as
904 the DISPLAY environment variable.
907 ffmpeg -f x11grab -s cif -r 25 -i :0.0+10,20 /tmp/out.mpg
910 0.0 is display.screen number of your X11 server, same as the DISPLAY environment
911 variable. 10 is the x-offset and 20 the y-offset for the grabbing.
913 @section Video and Audio file format conversion
915 Any supported file format and protocol can serve as input to ffmpeg:
920 You can use YUV files as input:
923 ffmpeg -i /tmp/test%d.Y /tmp/out.mpg
926 It will use the files:
928 /tmp/test0.Y, /tmp/test0.U, /tmp/test0.V,
929 /tmp/test1.Y, /tmp/test1.U, /tmp/test1.V, etc...
932 The Y files use twice the resolution of the U and V files. They are
933 raw files, without header. They can be generated by all decent video
934 decoders. You must specify the size of the image with the @option{-s} option
935 if ffmpeg cannot guess it.
938 You can input from a raw YUV420P file:
941 ffmpeg -i /tmp/test.yuv /tmp/out.avi
944 test.yuv is a file containing raw YUV planar data. Each frame is composed
945 of the Y plane followed by the U and V planes at half vertical and
946 horizontal resolution.
949 You can output to a raw YUV420P file:
952 ffmpeg -i mydivx.avi hugefile.yuv
956 You can set several input files and output files:
959 ffmpeg -i /tmp/a.wav -s 640x480 -i /tmp/a.yuv /tmp/a.mpg
962 Converts the audio file a.wav and the raw YUV video file a.yuv
966 You can also do audio and video conversions at the same time:
969 ffmpeg -i /tmp/a.wav -ar 22050 /tmp/a.mp2
972 Converts a.wav to MPEG audio at 22050 Hz sample rate.
975 You can encode to several formats at the same time and define a
976 mapping from input stream to output streams:
979 ffmpeg -i /tmp/a.wav -ab 64k /tmp/a.mp2 -ab 128k /tmp/b.mp2 -map 0:0 -map 0:0
982 Converts a.wav to a.mp2 at 64 kbits and to b.mp2 at 128 kbits. '-map
983 file:index' specifies which input stream is used for each output
984 stream, in the order of the definition of output streams.
987 You can transcode decrypted VOBs:
990 ffmpeg -i snatch_1.vob -f avi -vcodec mpeg4 -b 800k -g 300 -bf 2 -acodec libmp3lame -ab 128k snatch.avi
993 This is a typical DVD ripping example; the input is a VOB file, the
994 output an AVI file with MPEG-4 video and MP3 audio. Note that in this
995 command we use B-frames so the MPEG-4 stream is DivX5 compatible, and
996 GOP size is 300 which means one intra frame every 10 seconds for 29.97fps
997 input video. Furthermore, the audio stream is MP3-encoded so you need
998 to enable LAME support by passing @code{--enable-libmp3lame} to configure.
999 The mapping is particularly useful for DVD transcoding
1000 to get the desired audio language.
1002 NOTE: To see the supported input formats, use @code{ffmpeg -formats}.
1005 You can extract images from a video, or create a video from many images:
1007 For extracting images from a video:
1009 ffmpeg -i foo.avi -r 1 -s WxH -f image2 foo-%03d.jpeg
1012 This will extract one video frame per second from the video and will
1013 output them in files named @file{foo-001.jpeg}, @file{foo-002.jpeg},
1014 etc. Images will be rescaled to fit the new WxH values.
1016 If you want to extract just a limited number of frames, you can use the
1017 above command in combination with the -vframes or -t option, or in
1018 combination with -ss to start extracting from a certain point in time.
1020 For creating a video from many images:
1022 ffmpeg -f image2 -i foo-%03d.jpeg -r 12 -s WxH foo.avi
1025 The syntax @code{foo-%03d.jpeg} specifies to use a decimal number
1026 composed of three digits padded with zeroes to express the sequence
1027 number. It is the same syntax supported by the C printf function, but
1028 only formats accepting a normal integer are suitable.
1031 You can put many streams of the same type in the output:
1034 ffmpeg -i test1.avi -i test2.avi -vcodec copy -acodec copy -vcodec copy -acodec copy test12.avi -newvideo -newaudio
1037 In addition to the first video and audio streams, the resulting
1038 output file @file{test12.avi} will contain the second video
1039 and the second audio stream found in the input streams list.
1041 The @code{-newvideo}, @code{-newaudio} and @code{-newsubtitle}
1042 options have to be specified immediately after the name of the output
1043 file to which you want to add them.
1049 @include decoders.texi
1050 @include encoders.texi
1051 @include demuxers.texi
1052 @include muxers.texi
1053 @include indevs.texi
1054 @include outdevs.texi
1055 @include protocols.texi
1056 @include bitstream_filters.texi
1057 @include filters.texi
1058 @include metadata.texi
1063 @settitle ffmpeg video converter
1065 @c man begin SEEALSO
1066 ffplay(1), ffprobe(1), ffserver(1) and the FFmpeg HTML documentation
1069 @c man begin AUTHORS
1070 The FFmpeg developers