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, ffmpeg default = same as source).
170 The following abbreviations are recognized:
232 @item -aspect @var{aspect}
233 Set the video display aspect ratio specified by @var{aspect}.
235 @var{aspect} can be a floating point number string, or a string of the
236 form @var{num}:@var{den}, where @var{num} and @var{den} are the
237 numerator and denominator of the aspect ratio. For example "4:3",
238 "16:9", "1.3333", and "1.7777" are valid argument values.
240 @item -croptop @var{size}
241 @item -cropbottom @var{size}
242 @item -cropleft @var{size}
243 @item -cropright @var{size}
244 All the crop options have been removed. Use -vf
245 crop=width:height:x:y instead.
247 @item -padtop @var{size}
248 @item -padbottom @var{size}
249 @item -padleft @var{size}
250 @item -padright @var{size}
251 @item -padcolor @var{hex_color}
252 All the pad options have been removed. Use -vf
253 pad=width:height:x:y:color instead.
255 Disable video recording.
256 @item -bt @var{tolerance}
257 Set video bitrate tolerance (in bits, default 4000k).
258 Has a minimum value of: (target_bitrate/target_framerate).
259 In 1-pass mode, bitrate tolerance specifies how far ratecontrol is
260 willing to deviate from the target average bitrate value. This is
261 not related to min/max bitrate. Lowering tolerance too much has
262 an adverse effect on quality.
263 @item -maxrate @var{bitrate}
264 Set max video bitrate (in bit/s).
265 Requires -bufsize to be set.
266 @item -minrate @var{bitrate}
267 Set min video bitrate (in bit/s).
268 Most useful in setting up a CBR encode:
270 ffmpeg -i myfile.avi -b 4000k -minrate 4000k -maxrate 4000k -bufsize 1835k out.m2v
272 It is of little use elsewise.
273 @item -bufsize @var{size}
274 Set video buffer verifier buffer size (in bits).
275 @item -vcodec @var{codec}
276 Force video codec to @var{codec}. Use the @code{copy} special value to
277 tell that the raw codec data must be copied as is.
279 Use same quantizer as source (implies VBR).
282 Select the pass number (1 or 2). It is used to do two-pass
283 video encoding. The statistics of the video are recorded in the first
284 pass into a log file (see also the option -passlogfile),
285 and in the second pass that log file is used to generate the video
286 at the exact requested bitrate.
287 On pass 1, you may just deactivate audio and set output to null,
288 examples for Windows and Unix:
290 ffmpeg -i foo.mov -vcodec libxvid -pass 1 -an -f rawvideo -y NUL
291 ffmpeg -i foo.mov -vcodec libxvid -pass 1 -an -f rawvideo -y /dev/null
294 @item -passlogfile @var{prefix}
295 Set two-pass log file name prefix to @var{prefix}, the default file name
296 prefix is ``ffmpeg2pass''. The complete file name will be
297 @file{PREFIX-N.log}, where N is a number specific to the output
301 Add a new video stream to the current output stream.
303 @item -vlang @var{code}
304 Set the ISO 639 language code (3 letters) of the current video stream.
306 @item -vf @var{filter_graph}
307 @var{filter_graph} is a description of the filter graph to apply to
309 Use the option "-filters" to show all the available filters (including
310 also sources and sinks).
314 @section Advanced Video Options
317 @item -pix_fmt @var{format}
318 Set pixel format. Use 'list' as parameter to show all the supported
320 @item -sws_flags @var{flags}
322 @item -g @var{gop_size}
323 Set the group of pictures size.
325 Use only intra frames.
328 @item -qscale @var{q}
329 Use fixed video quantizer scale (VBR).
331 minimum video quantizer scale (VBR)
333 maximum video quantizer scale (VBR)
335 maximum difference between the quantizer scales (VBR)
336 @item -qblur @var{blur}
337 video quantizer scale blur (VBR) (range 0.0 - 1.0)
338 @item -qcomp @var{compression}
339 video quantizer scale compression (VBR) (default 0.5).
340 Constant of ratecontrol equation. Recommended range for default rc_eq: 0.0-1.0
342 @item -lmin @var{lambda}
343 minimum video lagrange factor (VBR)
344 @item -lmax @var{lambda}
345 max video lagrange factor (VBR)
346 @item -mblmin @var{lambda}
347 minimum macroblock quantizer scale (VBR)
348 @item -mblmax @var{lambda}
349 maximum macroblock quantizer scale (VBR)
351 These four options (lmin, lmax, mblmin, mblmax) use 'lambda' units,
352 but you may use the QP2LAMBDA constant to easily convert from 'q' units:
354 ffmpeg -i src.ext -lmax 21*QP2LAMBDA dst.ext
357 @item -rc_init_cplx @var{complexity}
358 initial complexity for single pass encoding
359 @item -b_qfactor @var{factor}
360 qp factor between P- and B-frames
361 @item -i_qfactor @var{factor}
362 qp factor between P- and I-frames
363 @item -b_qoffset @var{offset}
364 qp offset between P- and B-frames
365 @item -i_qoffset @var{offset}
366 qp offset between P- and I-frames
367 @item -rc_eq @var{equation}
368 Set rate control equation (see section "Expression Evaluation")
369 (default = @code{tex^qComp}).
371 When computing the rate control equation expression, besides the
372 standard functions defined in the section "Expression Evaluation", the
373 following functions are available:
379 and the following constants are available:
401 @item -rc_override @var{override}
402 rate control override for specific intervals
403 @item -me_method @var{method}
404 Set motion estimation method to @var{method}.
405 Available methods are (from lowest to best quality):
408 Try just the (0, 0) vector.
417 exhaustive search (slow and marginally better than epzs)
420 @item -dct_algo @var{algo}
421 Set DCT algorithm to @var{algo}. Available values are:
424 FF_DCT_AUTO (default)
437 @item -idct_algo @var{algo}
438 Set IDCT algorithm to @var{algo}. Available values are:
441 FF_IDCT_AUTO (default)
465 Set error resilience to @var{n}.
468 FF_ER_CAREFUL (default)
474 FF_ER_VERY_AGGRESSIVE
477 @item -ec @var{bit_mask}
478 Set error concealment to @var{bit_mask}. @var{bit_mask} is a bit mask of
479 the following values:
482 FF_EC_GUESS_MVS (default = enabled)
484 FF_EC_DEBLOCK (default = enabled)
487 @item -bf @var{frames}
488 Use 'frames' B-frames (supported for MPEG-1, MPEG-2 and MPEG-4).
489 @item -mbd @var{mode}
493 FF_MB_DECISION_SIMPLE: Use mb_cmp (cannot change it yet in ffmpeg).
495 FF_MB_DECISION_BITS: Choose the one which needs the fewest bits.
497 FF_MB_DECISION_RD: rate distortion
501 Use four motion vector by macroblock (MPEG-4 only).
503 Use data partitioning (MPEG-4 only).
504 @item -bug @var{param}
505 Work around encoder bugs that are not auto-detected.
506 @item -strict @var{strictness}
507 How strictly to follow the standards.
509 Enable Advanced intra coding (h263+).
511 Enable Unlimited Motion Vector (h263+)
514 Deinterlace pictures.
516 Force interlacing support in encoder (MPEG-2 and MPEG-4 only).
517 Use this option if your input file is interlaced and you want
518 to keep the interlaced format for minimum losses.
519 The alternative is to deinterlace the input stream with
520 @option{-deinterlace}, but deinterlacing introduces losses.
522 Calculate PSNR of compressed frames.
524 Dump video coding statistics to @file{vstats_HHMMSS.log}.
525 @item -vstats_file @var{file}
526 Dump video coding statistics to @var{file}.
528 top=1/bottom=0/auto=-1 field first
529 @item -dc @var{precision}
531 @item -vtag @var{fourcc/tag}
532 Force video tag/fourcc.
535 @item -vbsf @var{bitstream_filter}
536 Bitstream filters available are "dump_extra", "remove_extra", "noise", "h264_mp4toannexb", "imxdump", "mjpegadump", "mjpeg2jpeg".
538 ffmpeg -i h264.mp4 -vcodec copy -vbsf h264_mp4toannexb -an out.h264
540 @item -force_key_frames @var{time}[,@var{time}...]
541 Force key frames at the specified timestamps, more precisely at the first
542 frames after each specified time.
543 This option can be useful to ensure that a seek point is present at a
544 chapter mark or any other designated place in the output file.
545 The timestamps must be specified in ascending order.
548 @section Audio Options
551 @item -aframes @var{number}
552 Set the number of audio frames to record.
554 Set the audio sampling frequency. For input streams it is set by
555 default to 44100 Hz, for output streams it is set by default to the
556 frequency of the input stream. If the input file has audio streams
557 with different frequencies, the behaviour is undefined.
558 @item -ab @var{bitrate}
559 Set the audio bitrate in bit/s (default = 64k).
561 Set the audio quality (codec-specific, VBR).
562 @item -ac @var{channels}
563 Set the number of audio channels. For input streams it is set by
564 default to 1, for output streams it is set by default to the same
565 number of audio channels in input. If the input file has audio streams
566 with different channel count, the behaviour is undefined.
568 Disable audio recording.
569 @item -acodec @var{codec}
570 Force audio codec to @var{codec}. Use the @code{copy} special value to
571 specify that the raw codec data must be copied as is.
573 Add a new audio track to the output file. If you want to specify parameters,
574 do so before @code{-newaudio} (@code{-acodec}, @code{-ab}, etc..).
576 Mapping will be done automatically, if the number of output streams is equal to
577 the number of input streams, else it will pick the first one that matches. You
578 can override the mapping using @code{-map} as usual.
582 ffmpeg -i file.mpg -vcodec copy -acodec ac3 -ab 384k test.mpg -acodec mp2 -ab 192k -newaudio
584 @item -alang @var{code}
585 Set the ISO 639 language code (3 letters) of the current audio stream.
588 @section Advanced Audio options:
591 @item -atag @var{fourcc/tag}
592 Force audio tag/fourcc.
593 @item -audio_service_type @var{type}
594 Set the type of service that the audio stream contains.
597 Main Audio Service (default)
615 @item -absf @var{bitstream_filter}
616 Bitstream filters available are "dump_extra", "remove_extra", "noise", "mp3comp", "mp3decomp".
619 @section Subtitle options:
622 @item -scodec @var{codec}
623 Force subtitle codec ('copy' to copy stream).
625 Add a new subtitle stream to the current output stream.
626 @item -slang @var{code}
627 Set the ISO 639 language code (3 letters) of the current subtitle stream.
629 Disable subtitle recording.
630 @item -sbsf @var{bitstream_filter}
631 Bitstream filters available are "mov2textsub", "text2movsub".
633 ffmpeg -i file.mov -an -vn -sbsf mov2textsub -scodec copy -f rawvideo sub.txt
637 @section Audio/Video grab options
640 @item -vc @var{channel}
641 Set video grab channel (DV1394 only).
642 @item -tvstd @var{standard}
643 Set television standard (NTSC, PAL (SECAM)).
645 Synchronize read on input.
648 @section Advanced options
651 @item -map @var{input_file_id}.@var{input_stream_id}[:@var{sync_file_id}.@var{sync_stream_id}]
653 Designate an input stream as a source for the output file. Each input
654 stream is identified by the input file index @var{input_file_id} and
655 the input stream index @var{input_stream_id} within the input
656 file. Both indexes start at 0. If specified,
657 @var{sync_file_id}.@var{sync_stream_id} sets which input stream
658 is used as a presentation sync reference.
660 The @code{-map} options must be specified just after the output file.
661 If any @code{-map} options are used, the number of @code{-map} options
662 on the command line must match the number of streams in the output
663 file. The first @code{-map} option on the command line specifies the
664 source for output stream 0, the second @code{-map} option specifies
665 the source for output stream 1, etc.
667 For example, if you have two audio streams in the first input file,
668 these streams are identified by "0.0" and "0.1". You can use
669 @code{-map} to select which stream to place in an output file. For
672 ffmpeg -i INPUT out.wav -map 0.1
674 will map the input stream in @file{INPUT} identified by "0.1" to
675 the (single) output stream in @file{out.wav}.
677 For example, to select the stream with index 2 from input file
678 @file{a.mov} (specified by the identifier "0.2"), and stream with
679 index 6 from input @file{b.mov} (specified by the identifier "1.6"),
680 and copy them to the output file @file{out.mov}:
682 ffmpeg -i a.mov -i b.mov -vcodec copy -acodec copy out.mov -map 0.2 -map 1.6
685 To add more streams to the output file, you can use the
686 @code{-newaudio}, @code{-newvideo}, @code{-newsubtitle} options.
688 @item -map_meta_data @var{outfile}[,@var{metadata}]:@var{infile}[,@var{metadata}]
689 Deprecated, use @var{-map_metadata} instead.
691 @item -map_metadata @var{outfile}[,@var{metadata}]:@var{infile}[,@var{metadata}]
692 Set metadata information of @var{outfile} from @var{infile}. Note that those
693 are file indices (zero-based), not filenames.
694 Optional @var{metadata} parameters specify, which metadata to copy - (g)lobal
695 (i.e. metadata that applies to the whole file), per-(s)tream, per-(c)hapter or
696 per-(p)rogram. All metadata specifiers other than global must be followed by the
697 stream/chapter/program number. If metadata specifier is omitted, it defaults to
700 By default, global metadata is copied from the first input file to all output files,
701 per-stream and per-chapter metadata is copied along with streams/chapters. These
702 default mappings are disabled by creating any mapping of the relevant type. A negative
703 file index can be used to create a dummy mapping that just disables automatic copying.
705 For example to copy metadata from the first stream of the input file to global metadata
708 ffmpeg -i in.ogg -map_metadata 0:0,s0 out.mp3
710 @item -map_chapters @var{outfile}:@var{infile}
711 Copy chapters from @var{infile} to @var{outfile}. If no chapter mapping is specified,
712 then chapters are copied from the first input file with at least one chapter to all
713 output files. Use a negative file index to disable any chapter copying.
715 Print specific debug info.
717 Show benchmarking information at the end of an encode.
718 Shows CPU time used and maximum memory consumption.
719 Maximum memory consumption is not supported on all systems,
720 it will usually display as 0 if not supported.
722 Dump each input packet.
724 When dumping packets, also dump the payload.
726 Only use bit exact algorithms (for codec testing).
728 Set RTP payload size in bytes.
730 Read input at native frame rate. Mainly used to simulate a grab device.
732 Loop over the input stream. Currently it works only for image
733 streams. This option is used for automatic FFserver testing.
734 @item -loop_output @var{number_of_times}
735 Repeatedly loop output for formats that support looping such as animated GIF
736 (0 will loop the output infinitely).
737 @item -threads @var{count}
739 @item -vsync @var{parameter}
744 Each frame is passed with its timestamp from the demuxer to the muxer.
746 Frames will be duplicated and dropped to achieve exactly the requested
749 Frames are passed through with their timestamp or dropped so as to
750 prevent 2 frames from having the same timestamp.
752 Chooses between 1 and 2 depending on muxer capabilities. This is the
756 With -map you can select from which stream the timestamps should be
757 taken. You can leave either video or audio unchanged and sync the
758 remaining stream(s) to the unchanged one.
760 @item -async @var{samples_per_second}
761 Audio sync method. "Stretches/squeezes" the audio stream to match the timestamps,
762 the parameter is the maximum samples per second by which the audio is changed.
763 -async 1 is a special case where only the start of the audio stream is corrected
764 without any later correction.
766 Copy timestamps from input to output.
768 Copy input stream time base from input to output when stream copying.
770 Finish encoding when the shortest input stream ends.
771 @item -dts_delta_threshold
772 Timestamp discontinuity delta threshold.
773 @item -muxdelay @var{seconds}
774 Set the maximum demux-decode delay.
775 @item -muxpreload @var{seconds}
776 Set the initial demux-decode delay.
777 @item -streamid @var{output-stream-index}:@var{new-value}
778 Assign a new stream-id value to an output stream. This option should be
779 specified prior to the output filename to which it applies.
780 For the situation where multiple output files exist, a streamid
781 may be reassigned to a different value.
783 For example, to set the stream 0 PID to 33 and the stream 1 PID to 36 for
784 an output mpegts file:
786 ffmpeg -i infile -streamid 0:33 -streamid 1:36 out.ts
790 @section Preset files
792 A preset file contains a sequence of @var{option}=@var{value} pairs,
793 one for each line, specifying a sequence of options which would be
794 awkward to specify on the command line. Lines starting with the hash
795 ('#') character are ignored and are used to provide comments. Check
796 the @file{ffpresets} directory in the Libav source tree for examples.
798 Preset files are specified with the @code{vpre}, @code{apre},
799 @code{spre}, and @code{fpre} options. The @code{fpre} option takes the
800 filename of the preset instead of a preset name as input and can be
801 used for any kind of codec. For the @code{vpre}, @code{apre}, and
802 @code{spre} options, the options specified in a preset file are
803 applied to the currently selected codec of the same type as the preset
806 The argument passed to the @code{vpre}, @code{apre}, and @code{spre}
807 preset options identifies the preset file to use according to the
810 First ffmpeg searches for a file named @var{arg}.ffpreset in the
811 directories @file{$FFMPEG_DATADIR} (if set), and @file{$HOME/.ffmpeg}, and in
812 the datadir defined at configuration time (usually @file{PREFIX/share/ffmpeg})
813 in that order. For example, if the argument is @code{libx264-max}, it will
814 search for the file @file{libx264-max.ffpreset}.
816 If no such file is found, then ffmpeg will search for a file named
817 @var{codec_name}-@var{arg}.ffpreset in the above-mentioned
818 directories, where @var{codec_name} is the name of the codec to which
819 the preset file options will be applied. For example, if you select
820 the video codec with @code{-vcodec libx264} and use @code{-vpre max},
821 then it will search for the file @file{libx264-max.ffpreset}.
829 For streaming at very low bitrate application, use a low frame rate
830 and a small GOP size. This is especially true for RealVideo where
831 the Linux player does not seem to be very fast, so it can miss
832 frames. An example is:
835 ffmpeg -g 3 -r 3 -t 10 -b 50k -s qcif -f rv10 /tmp/b.rm
839 The parameter 'q' which is displayed while encoding is the current
840 quantizer. The value 1 indicates that a very good quality could
841 be achieved. The value 31 indicates the worst quality. If q=31 appears
842 too often, it means that the encoder cannot compress enough to meet
843 your bitrate. You must either increase the bitrate, decrease the
844 frame rate or decrease the frame size.
847 If your computer is not fast enough, you can speed up the
848 compression at the expense of the compression ratio. You can use
849 '-me zero' to speed up motion estimation, and '-intra' to disable
850 motion estimation completely (you have only I-frames, which means it
851 is about as good as JPEG compression).
854 To have very low audio bitrates, reduce the sampling frequency
855 (down to 22050 Hz for MPEG audio, 22050 or 11025 for AC-3).
858 To have a constant quality (but a variable bitrate), use the option
859 '-qscale n' when 'n' is between 1 (excellent quality) and 31 (worst
863 When converting video files, you can use the '-sameq' option which
864 uses the same quality factor in the encoder as in the decoder.
865 It allows almost lossless encoding.
871 @c man begin EXAMPLES
873 @section Video and Audio grabbing
875 If you specify the input format and device then ffmpeg can grab video
879 ffmpeg -f oss -i /dev/dsp -f video4linux2 -i /dev/video0 /tmp/out.mpg
882 Note that you must activate the right video source and channel before
883 launching ffmpeg with any TV viewer such as xawtv
884 (@url{http://linux.bytesex.org/xawtv/}) by Gerd Knorr. You also
885 have to set the audio recording levels correctly with a
888 @section X11 grabbing
890 Grab the X11 display with ffmpeg via
893 ffmpeg -f x11grab -s cif -r 25 -i :0.0 /tmp/out.mpg
896 0.0 is display.screen number of your X11 server, same as
897 the DISPLAY environment variable.
900 ffmpeg -f x11grab -s cif -r 25 -i :0.0+10,20 /tmp/out.mpg
903 0.0 is display.screen number of your X11 server, same as the DISPLAY environment
904 variable. 10 is the x-offset and 20 the y-offset for the grabbing.
906 @section Video and Audio file format conversion
908 Any supported file format and protocol can serve as input to ffmpeg:
913 You can use YUV files as input:
916 ffmpeg -i /tmp/test%d.Y /tmp/out.mpg
919 It will use the files:
921 /tmp/test0.Y, /tmp/test0.U, /tmp/test0.V,
922 /tmp/test1.Y, /tmp/test1.U, /tmp/test1.V, etc...
925 The Y files use twice the resolution of the U and V files. They are
926 raw files, without header. They can be generated by all decent video
927 decoders. You must specify the size of the image with the @option{-s} option
928 if ffmpeg cannot guess it.
931 You can input from a raw YUV420P file:
934 ffmpeg -i /tmp/test.yuv /tmp/out.avi
937 test.yuv is a file containing raw YUV planar data. Each frame is composed
938 of the Y plane followed by the U and V planes at half vertical and
939 horizontal resolution.
942 You can output to a raw YUV420P file:
945 ffmpeg -i mydivx.avi hugefile.yuv
949 You can set several input files and output files:
952 ffmpeg -i /tmp/a.wav -s 640x480 -i /tmp/a.yuv /tmp/a.mpg
955 Converts the audio file a.wav and the raw YUV video file a.yuv
959 You can also do audio and video conversions at the same time:
962 ffmpeg -i /tmp/a.wav -ar 22050 /tmp/a.mp2
965 Converts a.wav to MPEG audio at 22050 Hz sample rate.
968 You can encode to several formats at the same time and define a
969 mapping from input stream to output streams:
972 ffmpeg -i /tmp/a.wav -ab 64k /tmp/a.mp2 -ab 128k /tmp/b.mp2 -map 0:0 -map 0:0
975 Converts a.wav to a.mp2 at 64 kbits and to b.mp2 at 128 kbits. '-map
976 file:index' specifies which input stream is used for each output
977 stream, in the order of the definition of output streams.
980 You can transcode decrypted VOBs:
983 ffmpeg -i snatch_1.vob -f avi -vcodec mpeg4 -b 800k -g 300 -bf 2 -acodec libmp3lame -ab 128k snatch.avi
986 This is a typical DVD ripping example; the input is a VOB file, the
987 output an AVI file with MPEG-4 video and MP3 audio. Note that in this
988 command we use B-frames so the MPEG-4 stream is DivX5 compatible, and
989 GOP size is 300 which means one intra frame every 10 seconds for 29.97fps
990 input video. Furthermore, the audio stream is MP3-encoded so you need
991 to enable LAME support by passing @code{--enable-libmp3lame} to configure.
992 The mapping is particularly useful for DVD transcoding
993 to get the desired audio language.
995 NOTE: To see the supported input formats, use @code{ffmpeg -formats}.
998 You can extract images from a video, or create a video from many images:
1000 For extracting images from a video:
1002 ffmpeg -i foo.avi -r 1 -s WxH -f image2 foo-%03d.jpeg
1005 This will extract one video frame per second from the video and will
1006 output them in files named @file{foo-001.jpeg}, @file{foo-002.jpeg},
1007 etc. Images will be rescaled to fit the new WxH values.
1009 If you want to extract just a limited number of frames, you can use the
1010 above command in combination with the -vframes or -t option, or in
1011 combination with -ss to start extracting from a certain point in time.
1013 For creating a video from many images:
1015 ffmpeg -f image2 -i foo-%03d.jpeg -r 12 -s WxH foo.avi
1018 The syntax @code{foo-%03d.jpeg} specifies to use a decimal number
1019 composed of three digits padded with zeroes to express the sequence
1020 number. It is the same syntax supported by the C printf function, but
1021 only formats accepting a normal integer are suitable.
1024 You can put many streams of the same type in the output:
1027 ffmpeg -i test1.avi -i test2.avi -vcodec copy -acodec copy -vcodec copy -acodec copy test12.avi -newvideo -newaudio
1030 In addition to the first video and audio streams, the resulting
1031 output file @file{test12.avi} will contain the second video
1032 and the second audio stream found in the input streams list.
1034 The @code{-newvideo}, @code{-newaudio} and @code{-newsubtitle}
1035 options have to be specified immediately after the name of the output
1036 file to which you want to add them.
1042 @include encoders.texi
1043 @include demuxers.texi
1044 @include muxers.texi
1045 @include indevs.texi
1046 @include outdevs.texi
1047 @include protocols.texi
1048 @include bitstream_filters.texi
1049 @include filters.texi
1050 @include metadata.texi
1055 @settitle ffmpeg video converter
1057 @c man begin SEEALSO
1058 ffplay(1), ffprobe(1), ffserver(1) and the Libav HTML documentation
1061 @c man begin AUTHORS
1062 The Libav developers