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