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. It can also grab from
26 a live audio/video source.
28 The command line interface is designed to be intuitive, in the sense
29 that FFmpeg tries to figure out all parameters that can possibly be
30 derived automatically. You usually only have to specify the target
33 FFmpeg can also convert from any sample rate to any other, and resize
34 video on the fly with a high quality polyphase filter.
36 As a general rule, options are applied to the next specified
37 file. Therefore, order is important, and you can have the same
38 option on the command line multiple times. Each occurrence is
39 then applied to the next input or output file.
43 To set the video bitrate of the output file to 64kbit/s:
45 ffmpeg -i input.avi -b 64k output.avi
49 To force the frame rate of the output file to 24 fps:
51 ffmpeg -i input.avi -r 24 output.avi
55 To force the frame rate of the input file (valid for raw formats only)
56 to 1 fps and the frame rate of the output file to 24 fps:
58 ffmpeg -r 1 -i input.m2v -r 24 output.avi
62 The format option may be needed for raw input files.
64 By default, FFmpeg tries to convert as losslessly as possible: It
65 uses the same audio and video parameters for the outputs as the one
66 specified for the inputs.
68 @c man end DESCRIPTION
73 @include fftools-common-opts.texi
82 @item -i @var{filename}
86 Overwrite output files.
88 @item -t @var{duration}
89 Restrict the transcoded/captured video sequence
90 to the duration specified in seconds.
91 @code{hh:mm:ss[.xxx]} syntax is also supported.
93 @item -fs @var{limit_size}
94 Set the file size limit.
96 @item -ss @var{position}
97 Seek to given time position in seconds.
98 @code{hh:mm:ss[.xxx]} syntax is also supported.
100 @item -itsoffset @var{offset}
101 Set the input time offset in seconds.
102 @code{[-]hh:mm:ss[.xxx]} syntax is also supported.
103 This option affects all the input files that follow it.
104 The offset is added to the timestamps of the input files.
105 Specifying a positive offset means that the corresponding
106 streams are delayed by 'offset' seconds.
108 @item -timestamp @var{time}
109 Set the recording timestamp in the container.
110 The syntax for @var{time} is:
112 now|([(YYYY-MM-DD|YYYYMMDD)[T|t| ]]((HH[:MM[:SS[.m...]]])|(HH[MM[SS[.m...]]]))[Z|z])
114 If the value is "now" it takes the current time.
115 Time is local time unless 'Z' or 'z' is appended, in which case it is
117 If the year-month-day part is not specified it takes the current
120 @item -metadata @var{key}=@var{value}
121 Set a metadata key/value pair.
123 For example, for setting the title in the output file:
125 ffmpeg -i in.avi -metadata title="my title" out.flv
128 @item -v @var{number}
129 Set the logging verbosity level.
131 @item -target @var{type}
132 Specify target file type ("vcd", "svcd", "dvd", "dv", "dv50", "pal-vcd",
133 "ntsc-svcd", ... ). All the format options (bitrate, codecs,
134 buffer sizes) are then set automatically. You can just type:
137 ffmpeg -i myfile.avi -target vcd /tmp/vcd.mpg
140 Nevertheless you can specify additional options as long as you know
141 they do not conflict with the standard, as in:
144 ffmpeg -i myfile.avi -target vcd -bf 2 /tmp/vcd.mpg
147 @item -dframes @var{number}
148 Set the number of data frames to record.
150 @item -scodec @var{codec}
151 Force subtitle codec ('copy' to copy stream).
154 Add a new subtitle stream to the current output stream.
156 @item -slang @var{code}
157 Set the ISO 639 language code (3 letters) of the current subtitle stream.
161 @section Video Options
164 @item -b @var{bitrate}
165 Set the video bitrate in bit/s (default = 200 kb/s).
166 @item -vframes @var{number}
167 Set the number of video frames to record.
169 Set frame rate (Hz value, fraction or abbreviation), (default = 25).
171 Set frame size. The format is @samp{wxh} (ffserver default = 160x128, ffmpeg default = same as source).
172 The following abbreviations are recognized:
234 @item -aspect @var{aspect}
235 Set the video display aspect ratio specified by @var{aspect}.
237 @var{aspect} can be a floating point number string, or a string of the
238 form @var{num}:@var{den}, where @var{num} and @var{den} are the
239 numerator and denominator of the aspect ratio. For example "4:3",
240 "16:9", "1.3333", and "1.7777" are valid argument values.
242 @item -croptop @var{size}
243 @item -cropbottom @var{size}
244 @item -cropleft @var{size}
245 @item -cropright @var{size}
246 All the crop options have been removed. Use -vf
247 crop=width:height:x:y instead.
249 @item -padtop @var{size}
250 @item -padbottom @var{size}
251 @item -padleft @var{size}
252 @item -padright @var{size}
253 @item -padcolor @var{hex_color}
254 All the pad options have been removed. Use -vf
255 pad=width:height:x:y:color instead.
257 Disable video recording.
258 @item -bt @var{tolerance}
259 Set video bitrate tolerance (in bits, default 4000k).
260 Has a minimum value of: (target_bitrate/target_framerate).
261 In 1-pass mode, bitrate tolerance specifies how far ratecontrol is
262 willing to deviate from the target average bitrate value. This is
263 not related to min/max bitrate. Lowering tolerance too much has
264 an adverse effect on quality.
265 @item -maxrate @var{bitrate}
266 Set max video bitrate (in bit/s).
267 Requires -bufsize to be set.
268 @item -minrate @var{bitrate}
269 Set min video bitrate (in bit/s).
270 Most useful in setting up a CBR encode:
272 ffmpeg -i myfile.avi -b 4000k -minrate 4000k -maxrate 4000k -bufsize 1835k out.m2v
274 It is of little use elsewise.
275 @item -bufsize @var{size}
276 Set video buffer verifier buffer size (in bits).
277 @item -vcodec @var{codec}
278 Force video codec to @var{codec}. Use the @code{copy} special value to
279 tell that the raw codec data must be copied as is.
281 Use same video quality as source (implies VBR).
284 Select the pass number (1 or 2). It is used to do two-pass
285 video encoding. The statistics of the video are recorded in the first
286 pass into a log file (see also the option -passlogfile),
287 and in the second pass that log file is used to generate the video
288 at the exact requested bitrate.
289 On pass 1, you may just deactivate audio and set output to null,
290 examples for Windows and Unix:
292 ffmpeg -i foo.mov -vcodec libxvid -pass 1 -an -f rawvideo -y NUL
293 ffmpeg -i foo.mov -vcodec libxvid -pass 1 -an -f rawvideo -y /dev/null
296 @item -passlogfile @var{prefix}
297 Set two-pass log file name prefix to @var{prefix}, the default file name
298 prefix is ``ffmpeg2pass''. The complete file name will be
299 @file{PREFIX-N.log}, where N is a number specific to the output
303 Add a new video stream to the current output stream.
305 @item -vlang @var{code}
306 Set the ISO 639 language code (3 letters) of the current video stream.
308 @item -vf @var{filter_graph}
309 @var{filter_graph} is a description of the filter graph to apply to
311 Use the option "-filters" to show all the available filters (including
312 also sources and sinks).
316 @section Advanced Video Options
319 @item -pix_fmt @var{format}
320 Set pixel format. Use 'list' as parameter to show all the supported
322 @item -sws_flags @var{flags}
324 @item -g @var{gop_size}
325 Set the group of pictures size.
327 Use only intra frames.
330 @item -qscale @var{q}
331 Use fixed video quantizer scale (VBR).
333 minimum video quantizer scale (VBR)
335 maximum video quantizer scale (VBR)
337 maximum difference between the quantizer scales (VBR)
338 @item -qblur @var{blur}
339 video quantizer scale blur (VBR) (range 0.0 - 1.0)
340 @item -qcomp @var{compression}
341 video quantizer scale compression (VBR) (default 0.5).
342 Constant of ratecontrol equation. Recommended range for default rc_eq: 0.0-1.0
344 @item -lmin @var{lambda}
345 minimum video lagrange factor (VBR)
346 @item -lmax @var{lambda}
347 max video lagrange factor (VBR)
348 @item -mblmin @var{lambda}
349 minimum macroblock quantizer scale (VBR)
350 @item -mblmax @var{lambda}
351 maximum macroblock quantizer scale (VBR)
353 These four options (lmin, lmax, mblmin, mblmax) use 'lambda' units,
354 but you may use the QP2LAMBDA constant to easily convert from 'q' units:
356 ffmpeg -i src.ext -lmax 21*QP2LAMBDA dst.ext
359 @item -rc_init_cplx @var{complexity}
360 initial complexity for single pass encoding
361 @item -b_qfactor @var{factor}
362 qp factor between P- and B-frames
363 @item -i_qfactor @var{factor}
364 qp factor between P- and I-frames
365 @item -b_qoffset @var{offset}
366 qp offset between P- and B-frames
367 @item -i_qoffset @var{offset}
368 qp offset between P- and I-frames
369 @item -rc_eq @var{equation}
370 Set rate control equation (see section "Expression Evaluation")
371 (default = @code{tex^qComp}).
373 When computing the rate control equation expression, besides the
374 standard functions defined in the section "Expression Evaluation", the
375 following functions are available:
381 and the following constants are available:
403 @item -rc_override @var{override}
404 rate control override for specific intervals
405 @item -me_method @var{method}
406 Set motion estimation method to @var{method}.
407 Available methods are (from lowest to best quality):
410 Try just the (0, 0) vector.
419 exhaustive search (slow and marginally better than epzs)
422 @item -dct_algo @var{algo}
423 Set DCT algorithm to @var{algo}. Available values are:
426 FF_DCT_AUTO (default)
439 @item -idct_algo @var{algo}
440 Set IDCT algorithm to @var{algo}. Available values are:
443 FF_IDCT_AUTO (default)
467 Set error resilience to @var{n}.
470 FF_ER_CAREFUL (default)
476 FF_ER_VERY_AGGRESSIVE
479 @item -ec @var{bit_mask}
480 Set error concealment to @var{bit_mask}. @var{bit_mask} is a bit mask of
481 the following values:
484 FF_EC_GUESS_MVS (default = enabled)
486 FF_EC_DEBLOCK (default = enabled)
489 @item -bf @var{frames}
490 Use 'frames' B-frames (supported for MPEG-1, MPEG-2 and MPEG-4).
491 @item -mbd @var{mode}
495 FF_MB_DECISION_SIMPLE: Use mb_cmp (cannot change it yet in FFmpeg).
497 FF_MB_DECISION_BITS: Choose the one which needs the fewest bits.
499 FF_MB_DECISION_RD: rate distortion
503 Use four motion vector by macroblock (MPEG-4 only).
505 Use data partitioning (MPEG-4 only).
506 @item -bug @var{param}
507 Work around encoder bugs that are not auto-detected.
508 @item -strict @var{strictness}
509 How strictly to follow the standards.
511 Enable Advanced intra coding (h263+).
513 Enable Unlimited Motion Vector (h263+)
516 Deinterlace pictures.
518 Force interlacing support in encoder (MPEG-2 and MPEG-4 only).
519 Use this option if your input file is interlaced and you want
520 to keep the interlaced format for minimum losses.
521 The alternative is to deinterlace the input stream with
522 @option{-deinterlace}, but deinterlacing introduces losses.
524 Calculate PSNR of compressed frames.
526 Dump video coding statistics to @file{vstats_HHMMSS.log}.
527 @item -vstats_file @var{file}
528 Dump video coding statistics to @var{file}.
530 top=1/bottom=0/auto=-1 field first
531 @item -dc @var{precision}
533 @item -vtag @var{fourcc/tag}
534 Force video tag/fourcc.
537 @item -vbsf @var{bitstream_filter}
538 Bitstream filters available are "dump_extra", "remove_extra", "noise", "h264_mp4toannexb", "imxdump", "mjpegadump", "mjpeg2jpeg".
540 ffmpeg -i h264.mp4 -vcodec copy -vbsf h264_mp4toannexb -an out.h264
542 @item -force_key_frames @var{time}[,@var{time}...]
543 Force key frames at the specified timestamps, more precisely at the first
544 frames after each specified time.
545 This option can be useful to ensure that a seek point is present at a
546 chapter mark or any other designated place in the output file.
547 The timestamps must be specified in ascending order.
550 @section Audio Options
553 @item -aframes @var{number}
554 Set the number of audio frames to record.
556 Set the audio sampling frequency. For input streams it is set by
557 default to 44100 Hz, for output streams it is set by default to the
558 frequency of the input stream. If the input file has audio streams
559 with different frequencies, the behaviour is undefined.
560 @item -ab @var{bitrate}
561 Set the audio bitrate in bit/s (default = 64k).
563 Set the audio quality (codec-specific, VBR).
564 @item -ac @var{channels}
565 Set the number of audio channels. For input streams it is set by
566 default to 1, for output streams it is set by default to the same
567 number of audio channels in input. If the input file has audio streams
568 with different channel count, the behaviour is undefined.
570 Disable audio recording.
571 @item -acodec @var{codec}
572 Force audio codec to @var{codec}. Use the @code{copy} special value to
573 specify that the raw codec data must be copied as is.
575 Add a new audio track to the output file. If you want to specify parameters,
576 do so before @code{-newaudio} (@code{-acodec}, @code{-ab}, etc..).
578 Mapping will be done automatically, if the number of output streams is equal to
579 the number of input streams, else it will pick the first one that matches. You
580 can override the mapping using @code{-map} as usual.
584 ffmpeg -i file.mpg -vcodec copy -acodec ac3 -ab 384k test.mpg -acodec mp2 -ab 192k -newaudio
586 @item -alang @var{code}
587 Set the ISO 639 language code (3 letters) of the current audio stream.
590 @section Advanced Audio options:
593 @item -atag @var{fourcc/tag}
594 Force audio tag/fourcc.
595 @item -audio_service_type @var{type}
596 Set the type of service that the audio stream contains.
599 Main Audio Service (default)
617 @item -absf @var{bitstream_filter}
618 Bitstream filters available are "dump_extra", "remove_extra", "noise", "mp3comp", "mp3decomp".
621 @section Subtitle options:
624 @item -scodec @var{codec}
625 Force subtitle codec ('copy' to copy stream).
627 Add a new subtitle stream to the current output stream.
628 @item -slang @var{code}
629 Set the ISO 639 language code (3 letters) of the current subtitle stream.
631 Disable subtitle recording.
632 @item -sbsf @var{bitstream_filter}
633 Bitstream filters available are "mov2textsub", "text2movsub".
635 ffmpeg -i file.mov -an -vn -sbsf mov2textsub -scodec copy -f rawvideo sub.txt
639 @section Audio/Video grab options
642 @item -vc @var{channel}
643 Set video grab channel (DV1394 only).
644 @item -tvstd @var{standard}
645 Set television standard (NTSC, PAL (SECAM)).
647 Synchronize read on input.
650 @section Advanced options
653 @item -map @var{input_file_id}.@var{input_stream_id}[:@var{sync_file_id}.@var{sync_stream_id}]
655 Designate an input stream as a source for the output file. Each input
656 stream is identified by the input file index @var{input_file_id} and
657 the input stream index @var{input_stream_id} within the input
658 file. Both indexes start at 0. If specified,
659 @var{sync_file_id}.@var{sync_stream_id} sets which input stream
660 is used as a presentation sync reference.
662 The @code{-map} options must be specified just after the output file.
663 If any @code{-map} options are used, the number of @code{-map} options
664 on the command line must match the number of streams in the output
665 file. The first @code{-map} option on the command line specifies the
666 source for output stream 0, the second @code{-map} option specifies
667 the source for output stream 1, etc.
669 For example, if you have two audio streams in the first input file,
670 these streams are identified by "0.0" and "0.1". You can use
671 @code{-map} to select which stream to place in an output file. For
674 ffmpeg -i INPUT out.wav -map 0.1
676 will map the input stream in @file{INPUT} identified by "0.1" to
677 the (single) output stream in @file{out.wav}.
679 For example, to select the stream with index 2 from input file
680 @file{a.mov} (specified by the identifier "0.2"), and stream with
681 index 6 from input @file{b.mov} (specified by the identifier "1.6"),
682 and copy them to the output file @file{out.mov}:
684 ffmpeg -i a.mov -i b.mov -vcodec copy -acodec copy out.mov -map 0.2 -map 1.6
687 To add more streams to the output file, you can use the
688 @code{-newaudio}, @code{-newvideo}, @code{-newsubtitle} options.
690 @item -map_meta_data @var{outfile}[,@var{metadata}]:@var{infile}[,@var{metadata}]
691 Deprecated, use @var{-map_metadata} instead.
693 @item -map_metadata @var{outfile}[,@var{metadata}]:@var{infile}[,@var{metadata}]
694 Set metadata information of @var{outfile} from @var{infile}. Note that those
695 are file indices (zero-based), not filenames.
696 Optional @var{metadata} parameters specify, which metadata to copy - (g)lobal
697 (i.e. metadata that applies to the whole file), per-(s)tream, per-(c)hapter or
698 per-(p)rogram. All metadata specifiers other than global must be followed by the
699 stream/chapter/program number. If metadata specifier is omitted, it defaults to
702 By default, global metadata is copied from the first input file to all output files,
703 per-stream and per-chapter metadata is copied along with streams/chapters. These
704 default mappings are disabled by creating any mapping of the relevant type. A negative
705 file index can be used to create a dummy mapping that just disables automatic copying.
707 For example to copy metadata from the first stream of the input file to global metadata
710 ffmpeg -i in.ogg -map_metadata 0:0,s0 out.mp3
712 @item -map_chapters @var{outfile}:@var{infile}
713 Copy chapters from @var{infile} to @var{outfile}. If no chapter mapping is specified,
714 then chapters are copied from the first input file with at least one chapter to all
715 output files. Use a negative file index to disable any chapter copying.
717 Print specific debug info.
719 Show benchmarking information at the end of an encode.
720 Shows CPU time used and maximum memory consumption.
721 Maximum memory consumption is not supported on all systems,
722 it will usually display as 0 if not supported.
724 Dump each input packet.
726 When dumping packets, also dump the payload.
728 Only use bit exact algorithms (for codec testing).
730 Set RTP payload size in bytes.
732 Read input at native frame rate. Mainly used to simulate a grab device.
734 Loop over the input stream. Currently it works only for image
735 streams. This option is used for automatic FFserver testing.
736 @item -loop_output @var{number_of_times}
737 Repeatedly loop output for formats that support looping such as animated GIF
738 (0 will loop the output infinitely).
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 FFmpeg 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 FFmpeg can grab video and audio from devices given that you specify the input
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 FFmpeg can grab the X11 display.
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 FFmpeg can use any supported file format and protocol as input:
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 FFmpeg HTML documentation
1063 @c man begin AUTHORS
1064 The FFmpeg developers