Statistics
| Branch: | Revision:

ffmpeg / doc / faq.texi @ 3a74415d

History | View | Annotate | Download (13.7 KB)

1 7ff56c72 Fabrice Bellard
\input texinfo @c -*- texinfo -*-
2
3
@settitle FFmpeg FAQ
4
@titlepage
5
@sp 7
6
@center @titlefont{FFmpeg FAQ}
7
@sp 3
8
@end titlepage
9
10
11
@chapter General Problems
12
13 cacf7199 Mike Melanson
@section I cannot read this file although this format seems to be supported by ffmpeg.
14 7ff56c72 Fabrice Bellard
15
Even if ffmpeg can read the file format, it may not support all its
16
codecs. Please consult the supported codec list in the ffmpeg
17
documentation.
18
19 87759af9 Diego Biurrun
@section How do I encode JPEGs to another format ?
20 7ff56c72 Fabrice Bellard
21 87759af9 Diego Biurrun
If the JPEGs are named img1.jpg, img2.jpg, img3.jpg,..., use:
22 7ff56c72 Fabrice Bellard
23
@example
24 a9d21e78 Michel Bardiaux
  ffmpeg -f image2 -i img%d.jpg /tmp/a.mpg
25 7ff56c72 Fabrice Bellard
@end example
26
27
@samp{%d} is replaced by the image number.
28
29
@file{img%03d.jpg} generates @file{img001.jpg}, @file{img002.jpg}, etc...
30
31
The same system is used for the other image formats.
32
33 3c88ea24 Baptiste Coudurier
@section How do I encode movie to single pictures ?
34 a9d21e78 Michel Bardiaux
35 3c88ea24 Baptiste Coudurier
Use:
36 ad21ad45 Víctor Paesa
37
@example
38 3c88ea24 Baptiste Coudurier
  ffmpeg -i movie.mpg movie%d.jpg
39 ad21ad45 Víctor Paesa
@end example
40
41 3c88ea24 Baptiste Coudurier
The @file{movie.mpg} used as input will be converted to
42
@file{movie1.jpg}, @file{movie2.jpg}, etc...
43 ad21ad45 Víctor Paesa
44
Instead of relying on file format self-recognition, you may also use
45
@table @option
46
@item -vcodec ppm
47
@item -vcodec png
48
@item -vcodec mjpeg
49
@end table
50
to force the encoding.
51
52
Applying that to the previous example:
53
@example
54 3c88ea24 Baptiste Coudurier
  ffmpeg -i movie.mpg -f image2 -vcodec mjpeg menu%d.jpg
55 ad21ad45 Víctor Paesa
@end example
56
57
Beware that there is no "jpeg" codec. Use "mjpeg" instead.
58
59 7ff56c72 Fabrice Bellard
@section FFmpeg does not support codec XXX. Can you include a Windows DLL loader to support it ?
60
61
No. FFmpeg only supports open source codecs. Windows DLLs are not
62
portable, bloated and often slow.
63
64 7a9d265b Benjamin Larsson
@section I get "Unsupported codec (id=86043) for input stream #0.1". What is the problem ?
65
66
This is the Qcelp codec, FFmpeg has no support for that codec currently. Try mencoder/mplayer it might work.
67
68 f2fe8752 Roman Shaposhnik
@section Why do I see a slight quality degradation with multithreaded MPEG* encoding ?
69
70
For multithreaded MPEG* encoding, the encoded slices must be independent,
71 cacf7199 Mike Melanson
otherwise thread n would practically have to wait for n-1 to finish, so it's
72
quite logical that there is a small reduction of quality. This is not a bug.
73 f2fe8752 Roman Shaposhnik
74 47d944d2 Fabrice Bellard
@section How can I read from the standard input or write to the standard output ?
75
76
Use @file{-} as filename.
77
78 cacf7199 Mike Melanson
@section Why does ffmpeg not decode audio in VOB files ?
79 db0e9b03 Fabrice Bellard
80 cacf7199 Mike Melanson
The audio is AC3 (a.k.a. A/52). AC3 decoding is an optional component in ffmpeg
81 115329f1 Diego Biurrun
as the component that handles AC3 decoding (liba52) is currently released under
82 cacf7199 Mike Melanson
the GPL. If you have liba52 installed on your system, enable AC3 decoding
83 ab9c4087 Panagiotis Issaris
with @code{./configure --enable-liba52 --enable-gpl}. Take care: by
84 db0e9b03 Fabrice Bellard
enabling AC3, you automatically change the license of libavcodec from
85
LGPL to GPL.
86
87 87759af9 Diego Biurrun
@section Which codecs are supported by Windows ?
88 c75f51f6 Michael Niedermayer
89 115329f1 Diego Biurrun
Windows does not support standard formats like MPEG very well, unless you
90 c75f51f6 Michael Niedermayer
install some additional codecs
91
92 9ba42958 Diego Biurrun
The following list of video codecs should work on most Windows systems:
93 c75f51f6 Michael Niedermayer
@table @option
94
@item msmpeg4v2
95
.avi/.asf
96
@item msmpeg4
97
.asf only
98
@item wmv1
99
.asf only
100
@item wmv2
101
.asf only
102
@item mpeg4
103 9ba42958 Diego Biurrun
only if you have some MPEG-4 codec installed like ffdshow or XviD
104 c75f51f6 Michael Niedermayer
@item mpeg1
105
.mpg only
106
@end table
107 115329f1 Diego Biurrun
Note, ASF files often have .wmv or .wma extensions in Windows. It should also
108
be mentioned that Microsoft claims a patent on the ASF format, and may sue
109 cacf7199 Mike Melanson
or threaten users who create ASF files with non-Microsoft software. It is
110
strongly advised to avoid ASF where possible.
111 c75f51f6 Michael Niedermayer
112 9ba42958 Diego Biurrun
The following list of audio codecs should work on most Windows systems:
113 c75f51f6 Michael Niedermayer
@table @option
114
@item adpcm_ima_wav
115
@item adpcm_ms
116
@item pcm
117
@item mp3
118 9ba42958 Diego Biurrun
if some MP3 codec like LAME is installed
119 c75f51f6 Michael Niedermayer
@end table
120
121 9ba42958 Diego Biurrun
@section Why does the chrominance data seem to be sampled at a different time from the luminance data on bt8x8 captures on Linux?
122 7c0dc383 Michael Niedermayer
123 115329f1 Diego Biurrun
This is a well-known bug in the bt8x8 driver. For 2.4.26 there is a patch at
124 5d171758 Michael Niedermayer
(@url{http://svn.mplayerhq.hu/michael/trunk/patches/bttv-420-2.4.26.patch?view=co}). This may also
125 cacf7199 Mike Melanson
apply cleanly to other 2.4-series kernels.
126 7c0dc383 Michael Niedermayer
127 87759af9 Diego Biurrun
@section How do I avoid the ugly aliasing artifacts in bt8x8 captures on Linux?
128 7c0dc383 Michael Niedermayer
129 cacf7199 Mike Melanson
Pass 'combfilter=1 lumafilter=1' to the bttv driver. Note though that 'combfilter=1'
130 5d171758 Michael Niedermayer
will cause somewhat too strong filtering. A fix is to apply (@url{http://svn.mplayerhq.hu/michael/trunk/patches/bttv-comb-2.4.26.patch?view=co})
131
or (@url{http://svn.mplayerhq.hu/michael/trunk/patches/bttv-comb-2.6.6.patch?view=co})
132 cacf7199 Mike Melanson
and pass 'combfilter=2'.
133 7c0dc383 Michael Niedermayer
134 9ba42958 Diego Biurrun
@section I have a problem with an old version of ffmpeg; where should I report it?
135 cacf7199 Mike Melanson
Nowhere. Upgrade to the latest release or if there is no recent release upgrade
136 1c1b5a40 Diego Biurrun
to Subversion HEAD. You could also try to report it. Maybe you will get lucky and
137 87759af9 Diego Biurrun
become the first person in history to get an answer different from "upgrade
138 1c1b5a40 Diego Biurrun
to Subversion HEAD".
139 dd1368db Michael Niedermayer
140 9ba42958 Diego Biurrun
@section -f jpeg doesn't work.
141 fc3e9202 Michael Niedermayer
142 a9d21e78 Michel Bardiaux
Try '-f image2 test%d.jpg'.
143 fc3e9202 Michael Niedermayer
144 cacf7199 Mike Melanson
@section Why can I not change the framerate?
145 73468318 Michael Niedermayer
146 9ba42958 Diego Biurrun
Some codecs, like MPEG-1/2, only allow a small number of fixed framerates.
147 cacf7199 Mike Melanson
Choose a different codec with the -vcodec command line option.
148 73468318 Michael Niedermayer
149 cacf7199 Mike Melanson
@section ffmpeg does not work; What is wrong?
150 9291d591 Michael Niedermayer
151 123bff4b Benoit Fouet
Try a 'make distclean' in the ffmpeg source directory before the build. If this does not help see
152 7a771569 Diego Biurrun
(@url{http://ffmpeg.org/bugreports.php}).
153 9291d591 Michael Niedermayer
154 87759af9 Diego Biurrun
@section How do I encode XviD or DivX video with ffmpeg?
155 f62e9435 Mike Melanson
156 87759af9 Diego Biurrun
Both XviD and DivX (version 4+) are implementations of the ISO MPEG-4
157 f62e9435 Mike Melanson
standard (note that there are many other coding formats that use this
158
same standard). Thus, use '-vcodec mpeg4' to encode these formats. The
159 c9a08db9 Diego Biurrun
default fourcc stored in an MPEG-4-coded file will be 'FMP4'. If you want
160 115329f1 Diego Biurrun
a different fourcc, use the '-vtag' option. E.g., '-vtag xvid' will
161
force the fourcc 'xvid' to be stored as the video fourcc rather than the
162 f62e9435 Mike Melanson
default.
163
164 18e7d87c Diego Biurrun
@section How do I encode videos which play on the iPod?
165 b4aead58 Michael Niedermayer
166
@table @option
167 18e7d87c Diego Biurrun
@item needed stuff
168 b4aead58 Michael Niedermayer
-acodec aac -vcodec mpeg4 width<=320 height<=240
169 18e7d87c Diego Biurrun
@item working stuff
170 b4aead58 Michael Niedermayer
4mv, title
171 18e7d87c Diego Biurrun
@item non-working stuff
172
B-frames
173 b4aead58 Michael Niedermayer
@item example command line
174 5438308f Panagiotis Issaris
ffmpeg -i input -acodec aac -ab 128kb -vcodec mpeg4 -b 1200kb -mbd 2 -flags +4mv+trell -aic 2 -cmp 2 -subcmp 2 -s 320x180 -title X output.mp4
175 b4aead58 Michael Niedermayer
@end table
176
177 18e7d87c Diego Biurrun
@section How do I encode videos which play on the PSP?
178 b4aead58 Michael Niedermayer
179
@table @option
180 18e7d87c Diego Biurrun
@item needed stuff
181 b4aead58 Michael Niedermayer
-acodec aac -vcodec mpeg4 width*height<=76800 width%16=0 height%16=0 -ar 24000 -r 30000/1001 or 15000/1001 -f psp
182 18e7d87c Diego Biurrun
@item working stuff
183 b4aead58 Michael Niedermayer
4mv, title
184 18e7d87c Diego Biurrun
@item non-working stuff
185
B-frames
186 b4aead58 Michael Niedermayer
@item example command line
187 5438308f Panagiotis Issaris
ffmpeg -i input -acodec aac -ab 128kb -vcodec mpeg4 -b 1200kb -ar 24000 -mbd 2 -flags +4mv+trell -aic 2 -cmp 2 -subcmp 2 -s 368x192 -r 30000/1001 -title X -f psp output.mp4
188 f7709b1a Michael Niedermayer
@item needed stuff for H.264
189
-acodec aac -vcodec h264 width*height<=76800 width%16=0? height%16=0? -ar 48000 -coder 1 -r 30000/1001 or 15000/1001 -f psp
190
@item working stuff for H.264
191
title, loop filter
192
@item non-working stuff for H.264
193
CAVLC
194
@item example command line
195 5438308f Panagiotis Issaris
ffmpeg -i input -acodec aac -ab 128kb -vcodec h264 -b 1200kb -ar 48000 -mbd 2 -coder 1 -cmp 2 -subcmp 2 -s 368x192 -r 30000/1001 -title X -f psp -flags loop -trellis 2 -partitions parti4x4+parti8x8+partp4x4+partp8x8+partb8x8 output.mp4
196 b4aead58 Michael Niedermayer
@end table
197
198 16ab894e Diego Biurrun
@section Which are good parameters for encoding high quality MPEG-4?
199 c62997a5 Michael Niedermayer
200 16ab894e Diego Biurrun
'-mbd rd -flags +4mv+trell+aic -cmp 2 -subcmp 2 -g 300 -pass 1/2',
201
things to try: '-bf 2', '-flags qprd', '-flags mv0', '-flags skiprd'.
202 c62997a5 Michael Niedermayer
203 16ab894e Diego Biurrun
@section Which are good parameters for encoding high quality MPEG-1/MPEG-2?
204 c62997a5 Michael Niedermayer
205 16ab894e Diego Biurrun
'-mbd rd -flags +trell -cmp 2 -subcmp 2 -g 100 -pass 1/2'
206
but beware the '-g 100' might cause problems with some decoders.
207
Things to try: '-bf 2', '-flags qprd', '-flags mv0', '-flags skiprd.
208 c62997a5 Michael Niedermayer
209
@section Interlaced video looks very bad when encoded with ffmpeg, whats wrong?
210
211 16ab894e Diego Biurrun
You should use '-flags +ilme+ildct' and maybe '-flags +alt' for interlaced
212
material, and try '-top 0/1' if the result looks really messed-up.
213 c62997a5 Michael Niedermayer
214 99f6278e Diego Biurrun
@section How can I read DirectShow files?
215 2c29781d Víctor Paesa
216 99f6278e Diego Biurrun
If you have built FFmpeg with @code{./configure --enable-avisynth}
217
(only possible on MinGW/Cygwin platforms),
218
then you may use any file that DirectShow can read as input.
219
(Be aware that this feature has been recently added,
220
so you will need to help yourself in case of problems.)
221 2c29781d Víctor Paesa
222
Just create an "input.avs" text file with this single line ...
223
@example
224
  DirectShowSource("C:\path to your file\yourfile.asf")
225
@end example
226 99f6278e Diego Biurrun
... and then feed that text file to FFmpeg:
227 2c29781d Víctor Paesa
@example
228
  ffmpeg -i input.avs
229
@end example
230
231
For ANY other help on Avisynth, please visit @url{http://www.avisynth.org/}.
232
233 626fe955 Diego Biurrun
@section My bugreport/mail to ffmpeg-devel/user has not received any replies.
234
235 92574878 Michael Niedermayer
Likely reasons
236 626fe955 Diego Biurrun
@itemize
237
@item We are busy and haven't had time yet to read your report or
238
investigate the issue.
239
@item You didn't follow bugreports.html.
240
@item You didn't use Subversion HEAD.
241
@item You reported a segmentation fault without gdb output.
242
@item You describe a problem but not how to reproduce it.
243
@item It's unclear if you use ffmpeg as command line tool or use
244
libav* from another application.
245
@item You speak about a video having problems on playback but
246
not what you use to play it.
247
@item We have no faint clue what you are talking about besides
248
that it is related to FFmpeg.
249
@end itemize
250 92574878 Michael Niedermayer
251 7ff56c72 Fabrice Bellard
@chapter Development
252
253 f007d358 Diego Biurrun
@section When will the next FFmpeg version be released? / Why are FFmpeg releases so few and far between?
254
255
Like most open source projects FFmpeg suffers from a certain lack of
256
manpower. For this reason the developers have to prioritize the work
257
they do and putting out releases is not at the top of the list, fixing
258
bugs and reviewing patches takes precedence. Please don't complain or
259
request more timely and/or frequent releases unless you are willing to
260
help out creating them.
261
262 4519b8a6 Diego Biurrun
@section Why doesn't FFmpeg support feature [xyz]?
263
264
Because no one has taken on that task yet. FFmpeg development is
265
driven by the tasks that are important to the individual developers.
266
If there is a feature that is important to you, the best way to get
267
it implemented is to undertake the task yourself.
268
269
270 cacf7199 Mike Melanson
@section Are there examples illustrating how to use the FFmpeg libraries, particularly libavcodec and libavformat ?
271 a93b9dba Fabrice Bellard
272 cacf7199 Mike Melanson
Yes. Read the Developers Guide of the FFmpeg documentation. Alternatively,
273 115329f1 Diego Biurrun
examine the source code for one of the many open source projects that
274 cacf7199 Mike Melanson
already incorporate ffmpeg at (@url{projects.php}).
275 a93b9dba Fabrice Bellard
276 7ff56c72 Fabrice Bellard
@section Can you support my C compiler XXX ?
277
278 e867d9b9 Diego Biurrun
It depends. If your compiler is C99-compliant, then patches to support
279
it are likely to be welcome if they do not pollute the source code
280
with @code{#ifdef}s related to the compiler.
281 7ff56c72 Fabrice Bellard
282 2f0b8fbb Diego Biurrun
@section Visual C++ produces many errors.
283
284
Visual C++ is not compliant to the C standard and does not support
285
the inline assembly used in FFmpeg.
286
If you wish - for whatever weird reason - to use Visual C++ for your
287
project then you can link the Visual C++ code with libav* as long as
288
you compile the latter with a working C compiler. For more information, see
289
the @emph{Visual C++ compatibility} section in the FFmpeg documentation.
290
291
There have been efforts to make FFmpeg compatible with Visual C++ in the
292
past. However, they have all been rejected as too intrusive, especially
293
since MinGW does the job perfectly adequately. None of the core developers
294
work with Visual C++ and thus this item is low priority. Should you find
295
the silver bullet that solves this problem, feel free to shoot it at us.
296
297 988a9f9e Fabrice Bellard
@section Can I use FFmpeg or libavcodec under Windows ?
298 7ff56c72 Fabrice Bellard
299 988a9f9e Fabrice Bellard
Yes, but the MinGW tools @emph{must} be used to compile FFmpeg. You
300
can link the resulting DLLs with any other Windows program. Read the
301 be0efc0c Martin Boehme
@emph{Native Windows Compilation} and @emph{Visual C++ compatibility}
302
sections in the FFmpeg documentation to find more information.
303 7ff56c72 Fabrice Bellard
304 e2ef53fc Diego Biurrun
To get help and instructions for using FFmpeg under Windows, check out
305
the FFmpeg Windows Help Forum at
306
@url{http://arrozcru.no-ip.org/ffmpeg/}.
307
308 7ff56c72 Fabrice Bellard
@section Can you add automake, libtool or autoconf support ?
309
310 e867d9b9 Diego Biurrun
No. These tools are too bloated and they complicate the build.
311 7ff56c72 Fabrice Bellard
312 cacf7199 Mike Melanson
@section Why not rewrite ffmpeg in object-oriented C++ ?
313 fbf33e4f Michael Niedermayer
314 87759af9 Diego Biurrun
ffmpeg is already organized in a highly modular manner and does not need to
315 115329f1 Diego Biurrun
be rewritten in a formal object language. Further, many of the developers
316 cacf7199 Mike Melanson
favor straight C; it works for them. For more arguments on this matter,
317 bc155732 Diego Biurrun
read "Programming Religion" at (@url{http://www.tux.org/lkml/#s15}).
318 cacf7199 Mike Melanson
319
@section Why are the ffmpeg programs devoid of debugging symbols ?
320
321
The build process creates ffmpeg_g, ffplay_g, etc. which contain full debug
322
information. Those binaries are strip'd to create ffmpeg, ffplay, etc. If
323
you need the debug information, used the *_g versions.
324 fbf33e4f Michael Niedermayer
325 e180129f Diego Biurrun
@section I do not like the LGPL, can I contribute code under the GPL instead ?
326 61a1e081 Michael Niedermayer
327 e180129f Diego Biurrun
Yes, as long as the code is optional and can easily and cleanly be placed
328
under #ifdef CONFIG_GPL without breaking anything. So for example a new codec
329
or filter would be OK under GPL while a bugfix to LGPL code would not.
330 61a1e081 Michael Niedermayer
331 e180129f Diego Biurrun
@section I want to compile xyz.c alone but my compiler produced many errors.
332 61a1e081 Michael Niedermayer
333 e180129f Diego Biurrun
Common code is in its own files in libav* and is used by the individual
334
codecs. They will not work without the common parts, you have to compile
335
the whole libav*. If you wish, disable some parts with configure switches.
336
You can also try to hack it and remove more, but if you had problems fixing
337
the compilation failure then you are probably not qualified for this.
338 61a1e081 Michael Niedermayer
339 f994f61e Michael Niedermayer
@section I have a file in memory / a API different from *open/*read/ libc how do i use it with libavformat ?
340
341 1c1b5a40 Diego Biurrun
You have to implement a URLProtocol, see libavformat/file.c in FFmpeg
342
and libmpdemux/demux_lavf.c in MPlayer sources.
343 f994f61e Michael Niedermayer
344 e9766450 Ramiro Polla
@section I get "No compatible shell script interpreter found." in MSys.
345
346
The standard MSys bash (2.04) is broken. You need to install 2.05 or later.
347
348 5c159f40 Diego Biurrun
@section I tried to pass RTP packets into a decoder, but it doesn't work.
349 b72ad042 Michael Niedermayer
350 5c159f40 Diego Biurrun
Of course not, you MUST strip ALL RTP headers and assemble valid packets
351
first, an MP3 decoder decodes MP3 packets not bastardized MP3 packets
352
encapsulated in RTP. The same applies to all decoders, this is not specific
353
to ffmpeg or libavcodec.
354 b72ad042 Michael Niedermayer
355 7c1ebf17 Diego Biurrun
@section Where can I find libav* headers for Pascal/Delphi?
356 04704a78 Michael Niedermayer
357
see @url{http://www.iversenit.dk/dev/ffmpeg-headers/}
358
359 7c1ebf17 Diego Biurrun
@section Where is the documentation about ffv1, msmpeg4, asv1, 4xm?
360 afe28f7c Michael Niedermayer
361
see @url{http://svn.mplayerhq.hu/michael/trunk/docs/}
362
363 7ff56c72 Fabrice Bellard
@bye