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 This option is deprecated, use -loop.
735 @item -loop_output @var{number_of_times}
736 Repeatedly loop output for formats that support looping such as animated GIF
737 (0 will loop the output infinitely).
738 This option is deprecated, use -loop.
739 @item -threads @var{count}
741 @item -vsync @var{parameter}
746 Each frame is passed with its timestamp from the demuxer to the muxer.
748 Frames will be duplicated and dropped to achieve exactly the requested
751 Frames are passed through with their timestamp or dropped so as to
752 prevent 2 frames from having the same timestamp.
754 Chooses between 1 and 2 depending on muxer capabilities. This is the
758 With -map you can select from which stream the timestamps should be
759 taken. You can leave either video or audio unchanged and sync the
760 remaining stream(s) to the unchanged one.
762 @item -async @var{samples_per_second}
763 Audio sync method. "Stretches/squeezes" the audio stream to match the timestamps,
764 the parameter is the maximum samples per second by which the audio is changed.
765 -async 1 is a special case where only the start of the audio stream is corrected
766 without any later correction.
768 Copy timestamps from input to output.
770 Copy input stream time base from input to output when stream copying.
772 Finish encoding when the shortest input stream ends.
773 @item -dts_delta_threshold
774 Timestamp discontinuity delta threshold.
775 @item -muxdelay @var{seconds}
776 Set the maximum demux-decode delay.
777 @item -muxpreload @var{seconds}
778 Set the initial demux-decode delay.
779 @item -streamid @var{output-stream-index}:@var{new-value}
780 Assign a new stream-id value to an output stream. This option should be
781 specified prior to the output filename to which it applies.
782 For the situation where multiple output files exist, a streamid
783 may be reassigned to a different value.
785 For example, to set the stream 0 PID to 33 and the stream 1 PID to 36 for
786 an output mpegts file:
788 ffmpeg -i infile -streamid 0:33 -streamid 1:36 out.ts
792 @section Preset files
794 A preset file contains a sequence of @var{option}=@var{value} pairs,
795 one for each line, specifying a sequence of options which would be
796 awkward to specify on the command line. Lines starting with the hash
797 ('#') character are ignored and are used to provide comments. Check
798 the @file{ffpresets} directory in the Libav source tree for examples.
800 Preset files are specified with the @code{vpre}, @code{apre},
801 @code{spre}, and @code{fpre} options. The @code{fpre} option takes the
802 filename of the preset instead of a preset name as input and can be
803 used for any kind of codec. For the @code{vpre}, @code{apre}, and
804 @code{spre} options, the options specified in a preset file are
805 applied to the currently selected codec of the same type as the preset
808 The argument passed to the @code{vpre}, @code{apre}, and @code{spre}
809 preset options identifies the preset file to use according to the
812 First ffmpeg searches for a file named @var{arg}.ffpreset in the
813 directories @file{$FFMPEG_DATADIR} (if set), and @file{$HOME/.ffmpeg}, and in
814 the datadir defined at configuration time (usually @file{PREFIX/share/ffmpeg})
815 in that order. For example, if the argument is @code{libx264-max}, it will
816 search for the file @file{libx264-max.ffpreset}.
818 If no such file is found, then ffmpeg will search for a file named
819 @var{codec_name}-@var{arg}.ffpreset in the above-mentioned
820 directories, where @var{codec_name} is the name of the codec to which
821 the preset file options will be applied. For example, if you select
822 the video codec with @code{-vcodec libx264} and use @code{-vpre max},
823 then it will search for the file @file{libx264-max.ffpreset}.
831 For streaming at very low bitrate application, use a low frame rate
832 and a small GOP size. This is especially true for RealVideo where
833 the Linux player does not seem to be very fast, so it can miss
834 frames. An example is:
837 ffmpeg -g 3 -r 3 -t 10 -b 50k -s qcif -f rv10 /tmp/b.rm
841 The parameter 'q' which is displayed while encoding is the current
842 quantizer. The value 1 indicates that a very good quality could
843 be achieved. The value 31 indicates the worst quality. If q=31 appears
844 too often, it means that the encoder cannot compress enough to meet
845 your bitrate. You must either increase the bitrate, decrease the
846 frame rate or decrease the frame size.
849 If your computer is not fast enough, you can speed up the
850 compression at the expense of the compression ratio. You can use
851 '-me zero' to speed up motion estimation, and '-intra' to disable
852 motion estimation completely (you have only I-frames, which means it
853 is about as good as JPEG compression).
856 To have very low audio bitrates, reduce the sampling frequency
857 (down to 22050 Hz for MPEG audio, 22050 or 11025 for AC-3).
860 To have a constant quality (but a variable bitrate), use the option
861 '-qscale n' when 'n' is between 1 (excellent quality) and 31 (worst
865 When converting video files, you can use the '-sameq' option which
866 uses the same quality factor in the encoder as in the decoder.
867 It allows almost lossless encoding.
873 @c man begin EXAMPLES
875 @section Video and Audio grabbing
877 If you specify the input format and device then ffmpeg can grab video
881 ffmpeg -f oss -i /dev/dsp -f video4linux2 -i /dev/video0 /tmp/out.mpg
884 Note that you must activate the right video source and channel before
885 launching ffmpeg with any TV viewer such as xawtv
886 (@url{http://linux.bytesex.org/xawtv/}) by Gerd Knorr. You also
887 have to set the audio recording levels correctly with a
890 @section X11 grabbing
892 Grab the X11 display with ffmpeg via
895 ffmpeg -f x11grab -s cif -r 25 -i :0.0 /tmp/out.mpg
898 0.0 is display.screen number of your X11 server, same as
899 the DISPLAY environment variable.
902 ffmpeg -f x11grab -s cif -r 25 -i :0.0+10,20 /tmp/out.mpg
905 0.0 is display.screen number of your X11 server, same as the DISPLAY environment
906 variable. 10 is the x-offset and 20 the y-offset for the grabbing.
908 @section Video and Audio file format conversion
910 Any supported file format and protocol can serve as input to ffmpeg:
915 You can use YUV files as input:
918 ffmpeg -i /tmp/test%d.Y /tmp/out.mpg
921 It will use the files:
923 /tmp/test0.Y, /tmp/test0.U, /tmp/test0.V,
924 /tmp/test1.Y, /tmp/test1.U, /tmp/test1.V, etc...
927 The Y files use twice the resolution of the U and V files. They are
928 raw files, without header. They can be generated by all decent video
929 decoders. You must specify the size of the image with the @option{-s} option
930 if ffmpeg cannot guess it.
933 You can input from a raw YUV420P file:
936 ffmpeg -i /tmp/test.yuv /tmp/out.avi
939 test.yuv is a file containing raw YUV planar data. Each frame is composed
940 of the Y plane followed by the U and V planes at half vertical and
941 horizontal resolution.
944 You can output to a raw YUV420P file:
947 ffmpeg -i mydivx.avi hugefile.yuv
951 You can set several input files and output files:
954 ffmpeg -i /tmp/a.wav -s 640x480 -i /tmp/a.yuv /tmp/a.mpg
957 Converts the audio file a.wav and the raw YUV video file a.yuv
961 You can also do audio and video conversions at the same time:
964 ffmpeg -i /tmp/a.wav -ar 22050 /tmp/a.mp2
967 Converts a.wav to MPEG audio at 22050 Hz sample rate.
970 You can encode to several formats at the same time and define a
971 mapping from input stream to output streams:
974 ffmpeg -i /tmp/a.wav -ab 64k /tmp/a.mp2 -ab 128k /tmp/b.mp2 -map 0:0 -map 0:0
977 Converts a.wav to a.mp2 at 64 kbits and to b.mp2 at 128 kbits. '-map
978 file:index' specifies which input stream is used for each output
979 stream, in the order of the definition of output streams.
982 You can transcode decrypted VOBs:
985 ffmpeg -i snatch_1.vob -f avi -vcodec mpeg4 -b 800k -g 300 -bf 2 -acodec libmp3lame -ab 128k snatch.avi
988 This is a typical DVD ripping example; the input is a VOB file, the
989 output an AVI file with MPEG-4 video and MP3 audio. Note that in this
990 command we use B-frames so the MPEG-4 stream is DivX5 compatible, and
991 GOP size is 300 which means one intra frame every 10 seconds for 29.97fps
992 input video. Furthermore, the audio stream is MP3-encoded so you need
993 to enable LAME support by passing @code{--enable-libmp3lame} to configure.
994 The mapping is particularly useful for DVD transcoding
995 to get the desired audio language.
997 NOTE: To see the supported input formats, use @code{ffmpeg -formats}.
1000 You can extract images from a video, or create a video from many images:
1002 For extracting images from a video:
1004 ffmpeg -i foo.avi -r 1 -s WxH -f image2 foo-%03d.jpeg
1007 This will extract one video frame per second from the video and will
1008 output them in files named @file{foo-001.jpeg}, @file{foo-002.jpeg},
1009 etc. Images will be rescaled to fit the new WxH values.
1011 If you want to extract just a limited number of frames, you can use the
1012 above command in combination with the -vframes or -t option, or in
1013 combination with -ss to start extracting from a certain point in time.
1015 For creating a video from many images:
1017 ffmpeg -f image2 -i foo-%03d.jpeg -r 12 -s WxH foo.avi
1020 The syntax @code{foo-%03d.jpeg} specifies to use a decimal number
1021 composed of three digits padded with zeroes to express the sequence
1022 number. It is the same syntax supported by the C printf function, but
1023 only formats accepting a normal integer are suitable.
1026 You can put many streams of the same type in the output:
1029 ffmpeg -i test1.avi -i test2.avi -vcodec copy -acodec copy -vcodec copy -acodec copy test12.avi -newvideo -newaudio
1032 In addition to the first video and audio streams, the resulting
1033 output file @file{test12.avi} will contain the second video
1034 and the second audio stream found in the input streams list.
1036 The @code{-newvideo}, @code{-newaudio} and @code{-newsubtitle}
1037 options have to be specified immediately after the name of the output
1038 file to which you want to add them.
1044 @include encoders.texi
1045 @include demuxers.texi
1046 @include muxers.texi
1047 @include indevs.texi
1048 @include outdevs.texi
1049 @include protocols.texi
1050 @include bitstream_filters.texi
1051 @include filters.texi
1052 @include metadata.texi
1057 @settitle ffmpeg video converter
1059 @c man begin SEEALSO
1060 ffplay(1), ffprobe(1), ffserver(1) and the Libav HTML documentation
1063 @c man begin AUTHORS
1064 The Libav developers