2cfed01b13d9ce1dc1676641983253f001c46bec
[ffmpeg.git] / doc / avconv.texi
1 \input texinfo @c -*- texinfo -*-
2
3 @settitle avconv Documentation
4 @titlepage
5 @center @titlefont{avconv Documentation}
6 @end titlepage
7
8 @top
9
10 @contents
11
12 @chapter Synopsis
13
14 The generic syntax is:
15
16 @example
17 @c man begin SYNOPSIS
18 avconv [global options] [[infile options][@option{-i} @var{infile}]]... @{[outfile options] @var{outfile}@}...
19 @c man end
20 @end example
21
22 @chapter Description
23 @c man begin DESCRIPTION
24
25 avconv 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.
28
29 As a general rule, options are applied to the next specified
30 file. Therefore, order is important, and you can have the same
31 option on the command line multiple times. Each occurrence is
32 then applied to the next input or output file.
33 Exceptions from this rule are the global options (e.g. verbosity level),
34 which should be specified first.
35
36 @itemize
37 @item
38 To set the video bitrate of the output file to 64kbit/s:
39 @example
40 avconv -i input.avi -b 64k output.avi
41 @end example
42
43 @item
44 To force the frame rate of the output file to 24 fps:
45 @example
46 avconv -i input.avi -r 24 output.avi
47 @end example
48
49 @item
50 To force the frame rate of the input file (valid for raw formats only)
51 to 1 fps and the frame rate of the output file to 24 fps:
52 @example
53 avconv -r 1 -i input.m2v -r 24 output.avi
54 @end example
55 @end itemize
56
57 The format option may be needed for raw input files.
58
59 @c man end DESCRIPTION
60
61 @chapter Stream selection
62 @c man begin STREAM SELECTION
63
64 By default avconv tries to pick the "best" stream of each type present in input
65 files and add them to each output file. For video, this means the highest
66 resolution, for audio the highest channel count. For subtitle it's simply the
67 first subtitle stream.
68
69 You can disable some of those defaults by using @code{-vn/-an/-sn} options. For
70 full manual control, use the @code{-map} option, which disables the defaults just
71 described.
72
73 @c man end STREAM SELECTION
74
75 @chapter Options
76 @c man begin OPTIONS
77
78 @include avtools-common-opts.texi
79
80 @section Main options
81
82 @table @option
83
84 @item -f @var{fmt} (@emph{input/output})
85 Force format.
86
87 @item -i @var{filename} (@emph{input})
88 input file name
89
90 @item -y (@emph{global})
91 Overwrite output files.
92
93 @item -c[:@var{stream_specifier}] @var{codec} (@emph{input/output,per-stream})
94 @itemx -codec[:@var{stream_specifier}] @var{codec} (@emph{input/output,per-stream})
95 Select an encoder (when used before an output file) or a decoder (when used
96 before an input file) for one or more streams. @var{codec} is the name of a
97 decoder/encoder or a special value @code{copy} (output only) to indicate that
98 the stream is not to be reencoded.
99
100 For example
101 @example
102 avconv -i INPUT -map 0 -c:v libx264 -c:a copy OUTPUT
103 @end example
104 encodes all video streams with libx264 and copies all audio streams.
105
106 For each stream, the last matching @code{c} option is applied, so
107 @example
108 avconv -i INPUT -map 0 -c copy -c:v:1 libx264 -c:a:137 libvorbis OUTPUT
109 @end example
110 will copy all the streams except the second video, which will be encoded with
111 libx264, and the 138th audio, which will be encoded with libvorbis.
112
113 @item -t @var{duration} (@emph{output})
114 Restrict the transcoded/captured video sequence
115 to the duration specified in seconds.
116 @code{hh:mm:ss[.xxx]} syntax is also supported.
117
118 @item -fs @var{limit_size} (@emph{output})
119 Set the file size limit.
120
121 @item -ss @var{position} (@emph{input/output})
122 When used as an input option (before @code{-i}), seeks in this input file to
123 @var{position}. When used as an output option (before an output filename),
124 decodes but discards input until the timestamps reach @var{position}. This is
125 slower, but more accurate.
126
127 @var{position} may be either in seconds or in @code{hh:mm:ss[.xxx]} form.
128
129 @item -itsoffset @var{offset} (@emph{input})
130 Set the input time offset in seconds.
131 @code{[-]hh:mm:ss[.xxx]} syntax is also supported.
132 The offset is added to the timestamps of the input files.
133 Specifying a positive offset means that the corresponding
134 streams are delayed by 'offset' seconds.
135
136 @item -metadata[:metadata_specifier] @var{key}=@var{value} (@emph{output,per-metadata})
137 Set a metadata key/value pair.
138
139 An optional @var{metadata_specifier} may be given to set metadata
140 on streams or chapters. See @code{-map_metadata} documentation for
141 details.
142
143 This option overrides metadata set with @code{-map_metadata}. It is
144 also possible to delete metadata by using an empty value.
145
146 For example, for setting the title in the output file:
147 @example
148 avconv -i in.avi -metadata title="my title" out.flv
149 @end example
150
151 To set the language of the second stream:
152 @example
153 avconv -i INPUT -metadata:s:1 language=eng OUTPUT
154 @end example
155
156 @item -v @var{number} (@emph{global})
157 This option is deprecated and has no effect, use -loglevel
158 to set verbosity level.
159
160 @item -target @var{type} (@emph{output})
161 Specify target file type ("vcd", "svcd", "dvd", "dv", "dv50", "pal-vcd",
162 "ntsc-svcd", ... ). All the format options (bitrate, codecs,
163 buffer sizes) are then set automatically. You can just type:
164
165 @example
166 avconv -i myfile.avi -target vcd /tmp/vcd.mpg
167 @end example
168
169 Nevertheless you can specify additional options as long as you know
170 they do not conflict with the standard, as in:
171
172 @example
173 avconv -i myfile.avi -target vcd -bf 2 /tmp/vcd.mpg
174 @end example
175
176 @item -dframes @var{number} (@emph{output})
177 Set the number of data frames to record. This is an alias for @code{-frames:d}.
178
179 @item -frames[:@var{stream_specifier}] @var{framecount} (@emph{output,per-stream})
180 Stop writing to the stream after @var{framecount} frames.
181
182 @item -q[:@var{stream_specifier}] @var{q} (@emph{output,per-stream})
183 @itemx -qscale[:@var{stream_specifier}] @var{q} (@emph{output,per-stream})
184 Use fixed quality scale (VBR). The meaning of @var{q} is
185 codec-dependent.
186
187 @item -filter[:@var{stream_specifier}] @var{filter_graph}
188 @var{filter_graph} is a description of the filter graph to apply to
189 the stream. Use @code{-filters} to show all the available filters
190 (including also sources and sinks).
191
192 @end table
193
194 @section Video Options
195
196 @table @option
197 @item -vframes @var{number} (@emph{output})
198 Set the number of video frames to record. This is an alias for @code{-frames:v}.
199 @item -r[:@var{stream_specifier}] @var{fps} (@emph{input/output,per-stream})
200 Set frame rate (Hz value, fraction or abbreviation), (default = 25).
201 @item -s[:@var{stream_specifier}] @var{size} (@emph{input/output,per-stream})
202 Set frame size. The format is @samp{wxh} (avserver default = 160x128, avconv default = same as source).
203 The following abbreviations are recognized:
204 @table @samp
205 @item sqcif
206 128x96
207 @item qcif
208 176x144
209 @item cif
210 352x288
211 @item 4cif
212 704x576
213 @item 16cif
214 1408x1152
215 @item qqvga
216 160x120
217 @item qvga
218 320x240
219 @item vga
220 640x480
221 @item svga
222 800x600
223 @item xga
224 1024x768
225 @item uxga
226 1600x1200
227 @item qxga
228 2048x1536
229 @item sxga
230 1280x1024
231 @item qsxga
232 2560x2048
233 @item hsxga
234 5120x4096
235 @item wvga
236 852x480
237 @item wxga
238 1366x768
239 @item wsxga
240 1600x1024
241 @item wuxga
242 1920x1200
243 @item woxga
244 2560x1600
245 @item wqsxga
246 3200x2048
247 @item wquxga
248 3840x2400
249 @item whsxga
250 6400x4096
251 @item whuxga
252 7680x4800
253 @item cga
254 320x200
255 @item ega
256 640x350
257 @item hd480
258 852x480
259 @item hd720
260 1280x720
261 @item hd1080
262 1920x1080
263 @end table
264
265 @item -aspect[:@var{stream_specifier}] @var{aspect} (@emph{output,per-stream})
266 Set the video display aspect ratio specified by @var{aspect}.
267
268 @var{aspect} can be a floating point number string, or a string of the
269 form @var{num}:@var{den}, where @var{num} and @var{den} are the
270 numerator and denominator of the aspect ratio. For example "4:3",
271 "16:9", "1.3333", and "1.7777" are valid argument values.
272
273 @item -vn (@emph{output})
274 Disable video recording.
275 @item -bt @var{tolerance}
276 Set video bitrate tolerance (in bits, default 4000k).
277 Has a minimum value of: (target_bitrate/target_framerate).
278 In 1-pass mode, bitrate tolerance specifies how far ratecontrol is
279 willing to deviate from the target average bitrate value. This is
280 not related to min/max bitrate. Lowering tolerance too much has
281 an adverse effect on quality.
282 @item -maxrate @var{bitrate}
283 Set max video bitrate (in bit/s).
284 Requires -bufsize to be set.
285 @item -minrate @var{bitrate}
286 Set min video bitrate (in bit/s).
287 Most useful in setting up a CBR encode:
288 @example
289 avconv -i myfile.avi -b 4000k -minrate 4000k -maxrate 4000k -bufsize 1835k out.m2v
290 @end example
291 It is of little use elsewise.
292 @item -bufsize @var{size}
293 Set video buffer verifier buffer size (in bits).
294 @item -vcodec @var{codec} (@emph{output})
295 Set the video codec. This is an alias for @code{-codec:v}.
296 @item -same_quant
297 Use same quantizer as source (implies VBR).
298
299 Note that this is NOT SAME QUALITY. Do not use this option unless you know you
300 need it.
301
302 @item -pass @var{n}
303 Select the pass number (1 or 2). It is used to do two-pass
304 video encoding. The statistics of the video are recorded in the first
305 pass into a log file (see also the option -passlogfile),
306 and in the second pass that log file is used to generate the video
307 at the exact requested bitrate.
308 On pass 1, you may just deactivate audio and set output to null,
309 examples for Windows and Unix:
310 @example
311 avconv -i foo.mov -c:v libxvid -pass 1 -an -f rawvideo -y NUL
312 avconv -i foo.mov -c:v libxvid -pass 1 -an -f rawvideo -y /dev/null
313 @end example
314
315 @item -passlogfile @var{prefix} (@emph{global})
316 Set two-pass log file name prefix to @var{prefix}, the default file name
317 prefix is ``av2pass''. The complete file name will be
318 @file{PREFIX-N.log}, where N is a number specific to the output
319 stream.
320
321 @item -vf @var{filter_graph} (@emph{output})
322 @var{filter_graph} is a description of the filter graph to apply to
323 the input video.
324 Use the option "-filters" to show all the available filters (including
325 also sources and sinks).  This is an alias for @code{-filter:v}.
326
327 @end table
328
329 @section Advanced Video Options
330
331 @table @option
332 @item -pix_fmt[:@var{stream_specifier}] @var{format} (@emph{input/output,per-stream})
333 Set pixel format. Use @code{-pix_fmts} to show all the supported
334 pixel formats.
335 @item -sws_flags @var{flags} (@emph{input/output})
336 Set SwScaler flags.
337 @item -g @var{gop_size}
338 Set the group of pictures size.
339 @item -vdt @var{n}
340 Discard threshold.
341 @item -qmin @var{q}
342 minimum video quantizer scale (VBR)
343 @item -qmax @var{q}
344 maximum video quantizer scale (VBR)
345 @item -qdiff @var{q}
346 maximum difference between the quantizer scales (VBR)
347 @item -qblur @var{blur}
348 video quantizer scale blur (VBR) (range 0.0 - 1.0)
349 @item -qcomp @var{compression}
350 video quantizer scale compression (VBR) (default 0.5).
351 Constant of ratecontrol equation. Recommended range for default rc_eq: 0.0-1.0
352
353 @item -lmin @var{lambda}
354 minimum video lagrange factor (VBR)
355 @item -lmax @var{lambda}
356 max video lagrange factor (VBR)
357 @item -mblmin @var{lambda}
358 minimum macroblock quantizer scale (VBR)
359 @item -mblmax @var{lambda}
360 maximum macroblock quantizer scale (VBR)
361
362 These four options (lmin, lmax, mblmin, mblmax) use 'lambda' units,
363 but you may use the QP2LAMBDA constant to easily convert from 'q' units:
364 @example
365 avconv -i src.ext -lmax 21*QP2LAMBDA dst.ext
366 @end example
367
368 @item -rc_init_cplx @var{complexity}
369 initial complexity for single pass encoding
370 @item -b_qfactor @var{factor}
371 qp factor between P- and B-frames
372 @item -i_qfactor @var{factor}
373 qp factor between P- and I-frames
374 @item -b_qoffset @var{offset}
375 qp offset between P- and B-frames
376 @item -i_qoffset @var{offset}
377 qp offset between P- and I-frames
378 @item -rc_eq @var{equation}
379 Set rate control equation (see section "Expression Evaluation")
380 (default = @code{tex^qComp}).
381
382 When computing the rate control equation expression, besides the
383 standard functions defined in the section "Expression Evaluation", the
384 following functions are available:
385 @table @var
386 @item bits2qp(bits)
387 @item qp2bits(qp)
388 @end table
389
390 and the following constants are available:
391 @table @var
392 @item iTex
393 @item pTex
394 @item tex
395 @item mv
396 @item fCode
397 @item iCount
398 @item mcVar
399 @item var
400 @item isI
401 @item isP
402 @item isB
403 @item avgQP
404 @item qComp
405 @item avgIITex
406 @item avgPITex
407 @item avgPPTex
408 @item avgBPTex
409 @item avgTex
410 @end table
411
412 @item -rc_override[:@var{stream_specifier}] @var{override} (@emph{output,per-stream})
413 rate control override for specific intervals
414 @item -me_method @var{method}
415 Set motion estimation method to @var{method}.
416 Available methods are (from lowest to best quality):
417 @table @samp
418 @item zero
419 Try just the (0, 0) vector.
420 @item phods
421 @item log
422 @item x1
423 @item hex
424 @item umh
425 @item epzs
426 (default method)
427 @item full
428 exhaustive search (slow and marginally better than epzs)
429 @end table
430
431 @item -er @var{n}
432 Set error resilience to @var{n}.
433 @table @samp
434 @item 1
435 FF_ER_CAREFUL (default)
436 @item 2
437 FF_ER_COMPLIANT
438 @item 3
439 FF_ER_AGGRESSIVE
440 @item 4
441 FF_ER_VERY_AGGRESSIVE
442 @end table
443
444 @item -ec @var{bit_mask}
445 Set error concealment to @var{bit_mask}. @var{bit_mask} is a bit mask of
446 the following values:
447 @table @samp
448 @item 1
449 FF_EC_GUESS_MVS (default = enabled)
450 @item 2
451 FF_EC_DEBLOCK (default = enabled)
452 @end table
453
454 @item -bf @var{frames}
455 Use 'frames' B-frames (supported for MPEG-1, MPEG-2 and MPEG-4).
456 @item -mbd @var{mode}
457 macroblock decision
458 @table @samp
459 @item 0
460 FF_MB_DECISION_SIMPLE: Use mb_cmp (cannot change it yet in avconv).
461 @item 1
462 FF_MB_DECISION_BITS: Choose the one which needs the fewest bits.
463 @item 2
464 FF_MB_DECISION_RD: rate distortion
465 @end table
466
467 @item -bug @var{param}
468 Work around encoder bugs that are not auto-detected.
469 @item -strict @var{strictness}
470 How strictly to follow the standards.
471
472 @item -deinterlace
473 Deinterlace pictures.
474 @item -vstats
475 Dump video coding statistics to @file{vstats_HHMMSS.log}.
476 @item -vstats_file @var{file}
477 Dump video coding statistics to @var{file}.
478 @item -top[:@var{stream_specifier}] @var{n} (@emph{output,per-stream})
479 top=1/bottom=0/auto=-1 field first
480 @item -dc @var{precision}
481 Intra_dc_precision.
482 @item -vtag @var{fourcc/tag} (@emph{output})
483 Force video tag/fourcc. This is an alias for @code{-tag:v}.
484 @item -qphist (@emph{global})
485 Show QP histogram.
486 @item -force_key_frames[:@var{stream_specifier}] @var{time}[,@var{time}...] (@emph{output,per-stream})
487 Force key frames at the specified timestamps, more precisely at the first
488 frames after each specified time.
489 This option can be useful to ensure that a seek point is present at a
490 chapter mark or any other designated place in the output file.
491 The timestamps must be specified in ascending order.
492 @end table
493
494 @section Audio Options
495
496 @table @option
497 @item -aframes @var{number} (@emph{output})
498 Set the number of audio frames to record. This is an alias for @code{-frames:a}.
499 @item -ar[:@var{stream_specifier}] @var{freq} (@emph{input/output,per-stream})
500 Set the audio sampling frequency. For output streams it is set by
501 default to the frequency of the corresponding input stream. For input
502 streams this option only makes sense for audio grabbing devices and raw
503 demuxers and is mapped to the corresponding demuxer options.
504 @item -aq @var{q} (@emph{output})
505 Set the audio quality (codec-specific, VBR). This is an alias for -q:a.
506 @item -ac[:@var{stream_specifier}] @var{channels} (@emph{input/output,per-stream})
507 Set the number of audio channels. For output streams it is set by
508 default to the number of input audio channels. For input streams
509 this option only makes sense for audio grabbing devices and raw demuxers
510 and is mapped to the corresponding demuxer options.
511 @item -an (@emph{output})
512 Disable audio recording.
513 @item -acodec @var{codec} (@emph{input/output})
514 Set the audio codec. This is an alias for @code{-codec:a}.
515 @item -sample_fmt[:@var{stream_specifier}] @var{sample_fmt} (@emph{output,per-stream})
516 Set the audio sample format. Use @code{-help sample_fmts} to get a list
517 of supported sample formats.
518 @end table
519
520 @section Advanced Audio options:
521
522 @table @option
523 @item -atag @var{fourcc/tag} (@emph{output})
524 Force audio tag/fourcc. This is an alias for @code{-tag:a}.
525 @item -audio_service_type @var{type}
526 Set the type of service that the audio stream contains.
527 @table @option
528 @item ma
529 Main Audio Service (default)
530 @item ef
531 Effects
532 @item vi
533 Visually Impaired
534 @item hi
535 Hearing Impaired
536 @item di
537 Dialogue
538 @item co
539 Commentary
540 @item em
541 Emergency
542 @item vo
543 Voice Over
544 @item ka
545 Karaoke
546 @end table
547 @end table
548
549 @section Subtitle options:
550
551 @table @option
552 @item -scodec @var{codec} (@emph{input/output})
553 Set the subtitle codec. This is an alias for @code{-codec:s}.
554 @item -sn (@emph{output})
555 Disable subtitle recording.
556 @end table
557
558 @section Audio/Video grab options
559
560 @table @option
561 @item -isync (@emph{global})
562 Synchronize read on input.
563 @end table
564
565 @section Advanced options
566
567 @table @option
568 @item -map [-]@var{input_file_id}[:@var{stream_specifier}][,@var{sync_file_id}[:@var{stream_specifier}]] (@emph{output})
569
570 Designate one or more input streams as a source for the output file. Each input
571 stream is identified by the input file index @var{input_file_id} and
572 the input stream index @var{input_stream_id} within the input
573 file. Both indices start at 0. If specified,
574 @var{sync_file_id}:@var{stream_specifier} sets which input stream
575 is used as a presentation sync reference.
576
577 The first @code{-map} option on the command line specifies the
578 source for output stream 0, the second @code{-map} option specifies
579 the source for output stream 1, etc.
580
581 A @code{-} character before the stream identifier creates a "negative" mapping.
582 It disables matching streams from already created mappings.
583
584 For example, to map ALL streams from the first input file to output
585 @example
586 avconv -i INPUT -map 0 output
587 @end example
588
589 For example, if you have two audio streams in the first input file,
590 these streams are identified by "0:0" and "0:1". You can use
591 @code{-map} to select which streams to place in an output file. For
592 example:
593 @example
594 avconv -i INPUT -map 0:1 out.wav
595 @end example
596 will map the input stream in @file{INPUT} identified by "0:1" to
597 the (single) output stream in @file{out.wav}.
598
599 For example, to select the stream with index 2 from input file
600 @file{a.mov} (specified by the identifier "0:2"), and stream with
601 index 6 from input @file{b.mov} (specified by the identifier "1:6"),
602 and copy them to the output file @file{out.mov}:
603 @example
604 avconv -i a.mov -i b.mov -c copy -map 0:2 -map 1:6 out.mov
605 @end example
606
607 To select all video and the third audio stream from an input file:
608 @example
609 avconv -i INPUT -map 0:v -map 0:a:2 OUTPUT
610 @end example
611
612 To map all the streams except the second audio, use negative mappings
613 @example
614 avconv -i INPUT -map 0 -map -0:a:1 OUTPUT
615 @end example
616
617 Note that using this option disables the default mappings for this output file.
618
619 @item -map_metadata[:@var{metadata_type}][:@var{index}] @var{infile}[:@var{metadata_type}][:@var{index}] (@emph{output,per-metadata})
620 Set metadata information of the next output file from @var{infile}. Note that
621 those are file indices (zero-based), not filenames.
622 Optional @var{metadata_type} parameters specify, which metadata to copy - (g)lobal
623 (i.e. metadata that applies to the whole file), per-(s)tream, per-(c)hapter or
624 per-(p)rogram. All metadata specifiers other than global must be followed by the
625 stream/chapter/program index. If metadata specifier is omitted, it defaults to
626 global.
627
628 By default, global metadata is copied from the first input file,
629 per-stream and per-chapter metadata is copied along with streams/chapters. These
630 default mappings are disabled by creating any mapping of the relevant type. A negative
631 file index can be used to create a dummy mapping that just disables automatic copying.
632
633 For example to copy metadata from the first stream of the input file to global metadata
634 of the output file:
635 @example
636 avconv -i in.ogg -map_metadata 0:s:0 out.mp3
637 @end example
638 @item -map_chapters @var{input_file_index} (@emph{output})
639 Copy chapters from input file with index @var{input_file_index} to the next
640 output file. If no chapter mapping is specified, then chapters are copied from
641 the first input file with at least one chapter. Use a negative file index to
642 disable any chapter copying.
643 @item -debug
644 Print specific debug info.
645 @item -benchmark (@emph{global})
646 Show benchmarking information at the end of an encode.
647 Shows CPU time used and maximum memory consumption.
648 Maximum memory consumption is not supported on all systems,
649 it will usually display as 0 if not supported.
650 @item -timelimit @var{duration} (@emph{global})
651 Exit after avconv has been running for @var{duration} seconds.
652 @item -dump (@emph{global})
653 Dump each input packet.
654 @item -hex (@emph{global})
655 When dumping packets, also dump the payload.
656 @item -ps @var{size}
657 Set RTP payload size in bytes.
658 @item -re (@emph{input})
659 Read input at native frame rate. Mainly used to simulate a grab device.
660 @item -threads @var{count}
661 Thread count.
662 @item -vsync @var{parameter}
663 Video sync method.
664
665 @table @option
666 @item 0
667 Each frame is passed with its timestamp from the demuxer to the muxer.
668 @item 1
669 Frames will be duplicated and dropped to achieve exactly the requested
670 constant framerate.
671 @item 2
672 Frames are passed through with their timestamp or dropped so as to
673 prevent 2 frames from having the same timestamp.
674 @item -1
675 Chooses between 1 and 2 depending on muxer capabilities. This is the
676 default method.
677 @end table
678
679 With -map you can select from which stream the timestamps should be
680 taken. You can leave either video or audio unchanged and sync the
681 remaining stream(s) to the unchanged one.
682
683 @item -async @var{samples_per_second}
684 Audio sync method. "Stretches/squeezes" the audio stream to match the timestamps,
685 the parameter is the maximum samples per second by which the audio is changed.
686 -async 1 is a special case where only the start of the audio stream is corrected
687 without any later correction.
688 @item -copyts
689 Copy timestamps from input to output.
690 @item -copytb
691 Copy input stream time base from input to output when stream copying.
692 @item -shortest
693 Finish encoding when the shortest input stream ends.
694 @item -dts_delta_threshold
695 Timestamp discontinuity delta threshold.
696 @item -muxdelay @var{seconds} (@emph{input})
697 Set the maximum demux-decode delay.
698 @item -muxpreload @var{seconds} (@emph{input})
699 Set the initial demux-decode delay.
700 @item -streamid @var{output-stream-index}:@var{new-value} (@emph{output})
701 Assign a new stream-id value to an output stream. This option should be
702 specified prior to the output filename to which it applies.
703 For the situation where multiple output files exist, a streamid
704 may be reassigned to a different value.
705
706 For example, to set the stream 0 PID to 33 and the stream 1 PID to 36 for
707 an output mpegts file:
708 @example
709 avconv -i infile -streamid 0:33 -streamid 1:36 out.ts
710 @end example
711
712 @item -bsf[:@var{stream_specifier}] @var{bitstream_filters} (@emph{output,per-stream})
713 Set bitstream filters for matching streams. @var{bistream_filters} is
714 a comma-separated list of bitstream filters. Use the @code{-bsfs} option
715 to get the list of bitstream filters.
716 @example
717 avconv -i h264.mp4 -c:v copy -vbsf h264_mp4toannexb -an out.h264
718 @end example
719 @example
720 avconv -i file.mov -an -vn -sbsf mov2textsub -c:s copy -f rawvideo sub.txt
721 @end example
722
723 @item -tag[:@var{stream_specifier}] @var{codec_tag} (@emph{output,per-stream})
724 Force a tag/fourcc for matching streams.
725 @end table
726 @c man end OPTIONS
727
728 @chapter Tips
729 @c man begin TIPS
730
731 @itemize
732 @item
733 For streaming at very low bitrate application, use a low frame rate
734 and a small GOP size. This is especially true for RealVideo where
735 the Linux player does not seem to be very fast, so it can miss
736 frames. An example is:
737
738 @example
739 avconv -g 3 -r 3 -t 10 -b 50k -s qcif -f rv10 /tmp/b.rm
740 @end example
741
742 @item
743 The parameter 'q' which is displayed while encoding is the current
744 quantizer. The value 1 indicates that a very good quality could
745 be achieved. The value 31 indicates the worst quality. If q=31 appears
746 too often, it means that the encoder cannot compress enough to meet
747 your bitrate. You must either increase the bitrate, decrease the
748 frame rate or decrease the frame size.
749
750 @item
751 If your computer is not fast enough, you can speed up the
752 compression at the expense of the compression ratio. You can use
753 '-me zero' to speed up motion estimation, and '-intra' to disable
754 motion estimation completely (you have only I-frames, which means it
755 is about as good as JPEG compression).
756
757 @item
758 To have very low audio bitrates, reduce the sampling frequency
759 (down to 22050 Hz for MPEG audio, 22050 or 11025 for AC-3).
760
761 @item
762 To have a constant quality (but a variable bitrate), use the option
763 '-qscale n' when 'n' is between 1 (excellent quality) and 31 (worst
764 quality).
765
766 @end itemize
767 @c man end TIPS
768
769 @chapter Examples
770 @c man begin EXAMPLES
771
772 @section Video and Audio grabbing
773
774 If you specify the input format and device then avconv can grab video
775 and audio directly.
776
777 @example
778 avconv -f oss -i /dev/dsp -f video4linux2 -i /dev/video0 /tmp/out.mpg
779 @end example
780
781 Note that you must activate the right video source and channel before
782 launching avconv with any TV viewer such as
783 @uref{http://linux.bytesex.org/xawtv/, xawtv} by Gerd Knorr. You also
784 have to set the audio recording levels correctly with a
785 standard mixer.
786
787 @section X11 grabbing
788
789 Grab the X11 display with avconv via
790
791 @example
792 avconv -f x11grab -s cif -r 25 -i :0.0 /tmp/out.mpg
793 @end example
794
795 0.0 is display.screen number of your X11 server, same as
796 the DISPLAY environment variable.
797
798 @example
799 avconv -f x11grab -s cif -r 25 -i :0.0+10,20 /tmp/out.mpg
800 @end example
801
802 0.0 is display.screen number of your X11 server, same as the DISPLAY environment
803 variable. 10 is the x-offset and 20 the y-offset for the grabbing.
804
805 @section Video and Audio file format conversion
806
807 Any supported file format and protocol can serve as input to avconv:
808
809 Examples:
810 @itemize
811 @item
812 You can use YUV files as input:
813
814 @example
815 avconv -i /tmp/test%d.Y /tmp/out.mpg
816 @end example
817
818 It will use the files:
819 @example
820 /tmp/test0.Y, /tmp/test0.U, /tmp/test0.V,
821 /tmp/test1.Y, /tmp/test1.U, /tmp/test1.V, etc...
822 @end example
823
824 The Y files use twice the resolution of the U and V files. They are
825 raw files, without header. They can be generated by all decent video
826 decoders. You must specify the size of the image with the @option{-s} option
827 if avconv cannot guess it.
828
829 @item
830 You can input from a raw YUV420P file:
831
832 @example
833 avconv -i /tmp/test.yuv /tmp/out.avi
834 @end example
835
836 test.yuv is a file containing raw YUV planar data. Each frame is composed
837 of the Y plane followed by the U and V planes at half vertical and
838 horizontal resolution.
839
840 @item
841 You can output to a raw YUV420P file:
842
843 @example
844 avconv -i mydivx.avi hugefile.yuv
845 @end example
846
847 @item
848 You can set several input files and output files:
849
850 @example
851 avconv -i /tmp/a.wav -s 640x480 -i /tmp/a.yuv /tmp/a.mpg
852 @end example
853
854 Converts the audio file a.wav and the raw YUV video file a.yuv
855 to MPEG file a.mpg.
856
857 @item
858 You can also do audio and video conversions at the same time:
859
860 @example
861 avconv -i /tmp/a.wav -ar 22050 /tmp/a.mp2
862 @end example
863
864 Converts a.wav to MPEG audio at 22050 Hz sample rate.
865
866 @item
867 You can encode to several formats at the same time and define a
868 mapping from input stream to output streams:
869
870 @example
871 avconv -i /tmp/a.wav -map 0:a -b 64k /tmp/a.mp2 -map 0:a -b 128k /tmp/b.mp2
872 @end example
873
874 Converts a.wav to a.mp2 at 64 kbits and to b.mp2 at 128 kbits. '-map
875 file:index' specifies which input stream is used for each output
876 stream, in the order of the definition of output streams.
877
878 @item
879 You can transcode decrypted VOBs:
880
881 @example
882 avconv -i snatch_1.vob -f avi -c:v mpeg4 -b:v 800k -g 300 -bf 2 -c:a libmp3lame -b:a 128k snatch.avi
883 @end example
884
885 This is a typical DVD ripping example; the input is a VOB file, the
886 output an AVI file with MPEG-4 video and MP3 audio. Note that in this
887 command we use B-frames so the MPEG-4 stream is DivX5 compatible, and
888 GOP size is 300 which means one intra frame every 10 seconds for 29.97fps
889 input video. Furthermore, the audio stream is MP3-encoded so you need
890 to enable LAME support by passing @code{--enable-libmp3lame} to configure.
891 The mapping is particularly useful for DVD transcoding
892 to get the desired audio language.
893
894 NOTE: To see the supported input formats, use @code{avconv -formats}.
895
896 @item
897 You can extract images from a video, or create a video from many images:
898
899 For extracting images from a video:
900 @example
901 avconv -i foo.avi -r 1 -s WxH -f image2 foo-%03d.jpeg
902 @end example
903
904 This will extract one video frame per second from the video and will
905 output them in files named @file{foo-001.jpeg}, @file{foo-002.jpeg},
906 etc. Images will be rescaled to fit the new WxH values.
907
908 If you want to extract just a limited number of frames, you can use the
909 above command in combination with the -vframes or -t option, or in
910 combination with -ss to start extracting from a certain point in time.
911
912 For creating a video from many images:
913 @example
914 avconv -f image2 -i foo-%03d.jpeg -r 12 -s WxH foo.avi
915 @end example
916
917 The syntax @code{foo-%03d.jpeg} specifies to use a decimal number
918 composed of three digits padded with zeroes to express the sequence
919 number. It is the same syntax supported by the C printf function, but
920 only formats accepting a normal integer are suitable.
921
922 @item
923 You can put many streams of the same type in the output:
924
925 @example
926 avconv -i test1.avi -i test2.avi -map 0.3 -map 0.2 -map 0.1 -map 0.0 -c copy test12.nut
927 @end example
928
929 The resulting output file @file{test12.avi} will contain first four streams from
930 the input file in reverse order.
931
932 @end itemize
933 @c man end EXAMPLES
934
935 @include eval.texi
936 @include encoders.texi
937 @include demuxers.texi
938 @include muxers.texi
939 @include indevs.texi
940 @include outdevs.texi
941 @include protocols.texi
942 @include bitstream_filters.texi
943 @include filters.texi
944 @include metadata.texi
945
946 @ignore
947
948 @setfilename avconv
949 @settitle avconv video converter
950
951 @c man begin SEEALSO
952 avplay(1), avprobe(1), avserver(1) and the Libav HTML documentation
953 @c man end
954
955 @c man begin AUTHORS
956 The Libav developers
957 @c man end
958
959 @end ignore
960
961 @bye