2002-11-04 19:50:04 +01:00
|
|
|
\input texinfo @c -*- texinfo -*-
|
|
|
|
|
|
|
|
@settitle FFmpeg FAQ
|
|
|
|
@titlepage
|
|
|
|
@sp 7
|
|
|
|
@center @titlefont{FFmpeg FAQ}
|
|
|
|
@sp 3
|
|
|
|
@end titlepage
|
|
|
|
|
|
|
|
|
|
|
|
@chapter General Problems
|
|
|
|
|
2004-10-01 04:35:21 +02:00
|
|
|
@section I cannot read this file although this format seems to be supported by ffmpeg.
|
2002-11-04 19:50:04 +01:00
|
|
|
|
|
|
|
Even if ffmpeg can read the file format, it may not support all its
|
|
|
|
codecs. Please consult the supported codec list in the ffmpeg
|
|
|
|
documentation.
|
|
|
|
|
2005-06-09 19:54:48 +02:00
|
|
|
@section How do I encode JPEGs to another format ?
|
2002-11-04 19:50:04 +01:00
|
|
|
|
2005-06-09 19:54:48 +02:00
|
|
|
If the JPEGs are named img1.jpg, img2.jpg, img3.jpg,..., use:
|
2002-11-04 19:50:04 +01:00
|
|
|
|
|
|
|
@example
|
2006-08-24 16:03:08 +02:00
|
|
|
ffmpeg -f image2 -i img%d.jpg /tmp/a.mpg
|
2002-11-04 19:50:04 +01:00
|
|
|
@end example
|
|
|
|
|
|
|
|
@samp{%d} is replaced by the image number.
|
|
|
|
|
|
|
|
@file{img%03d.jpg} generates @file{img001.jpg}, @file{img002.jpg}, etc...
|
|
|
|
|
|
|
|
The same system is used for the other image formats.
|
|
|
|
|
2006-11-05 14:31:57 +01:00
|
|
|
@section How do I encode movie to single pictures ?
|
2006-08-24 16:03:08 +02:00
|
|
|
|
2006-11-05 14:31:57 +01:00
|
|
|
Use:
|
2006-07-25 13:42:13 +02:00
|
|
|
|
|
|
|
@example
|
2006-11-05 14:31:57 +01:00
|
|
|
ffmpeg -i movie.mpg movie%d.jpg
|
2006-07-25 13:42:13 +02:00
|
|
|
@end example
|
|
|
|
|
2006-11-05 14:31:57 +01:00
|
|
|
The @file{movie.mpg} used as input will be converted to
|
|
|
|
@file{movie1.jpg}, @file{movie2.jpg}, etc...
|
2006-07-25 13:42:13 +02:00
|
|
|
|
|
|
|
Instead of relying on file format self-recognition, you may also use
|
|
|
|
@table @option
|
|
|
|
@item -vcodec ppm
|
|
|
|
@item -vcodec png
|
|
|
|
@item -vcodec mjpeg
|
|
|
|
@end table
|
|
|
|
to force the encoding.
|
|
|
|
|
|
|
|
Applying that to the previous example:
|
|
|
|
@example
|
2006-11-05 14:31:57 +01:00
|
|
|
ffmpeg -i movie.mpg -f image2 -vcodec mjpeg menu%d.jpg
|
2006-07-25 13:42:13 +02:00
|
|
|
@end example
|
|
|
|
|
|
|
|
Beware that there is no "jpeg" codec. Use "mjpeg" instead.
|
|
|
|
|
2002-11-04 19:50:04 +01:00
|
|
|
@section FFmpeg does not support codec XXX. Can you include a Windows DLL loader to support it ?
|
|
|
|
|
|
|
|
No. FFmpeg only supports open source codecs. Windows DLLs are not
|
|
|
|
portable, bloated and often slow.
|
|
|
|
|
2006-09-18 22:19:11 +02:00
|
|
|
@section I get "Unsupported codec (id=86043) for input stream #0.1". What is the problem ?
|
|
|
|
|
|
|
|
This is the Qcelp codec, FFmpeg has no support for that codec currently. Try mencoder/mplayer it might work.
|
|
|
|
|
2004-08-23 21:48:41 +02:00
|
|
|
@section Why do I see a slight quality degradation with multithreaded MPEG* encoding ?
|
|
|
|
|
|
|
|
For multithreaded MPEG* encoding, the encoded slices must be independent,
|
2004-10-01 04:35:21 +02:00
|
|
|
otherwise thread n would practically have to wait for n-1 to finish, so it's
|
|
|
|
quite logical that there is a small reduction of quality. This is not a bug.
|
2004-08-23 21:48:41 +02:00
|
|
|
|
2002-11-19 20:16:26 +01:00
|
|
|
@section How can I read from the standard input or write to the standard output ?
|
|
|
|
|
|
|
|
Use @file{-} as filename.
|
|
|
|
|
2004-10-01 04:35:21 +02:00
|
|
|
@section Why does ffmpeg not decode audio in VOB files ?
|
2003-09-08 23:39:36 +02:00
|
|
|
|
2004-10-01 04:35:21 +02:00
|
|
|
The audio is AC3 (a.k.a. A/52). AC3 decoding is an optional component in ffmpeg
|
2005-12-17 19:14:38 +01:00
|
|
|
as the component that handles AC3 decoding (liba52) is currently released under
|
2004-10-01 04:35:21 +02:00
|
|
|
the GPL. If you have liba52 installed on your system, enable AC3 decoding
|
|
|
|
with @code{./configure --enable-a52}. Take care: by
|
2003-09-08 23:39:36 +02:00
|
|
|
enabling AC3, you automatically change the license of libavcodec from
|
|
|
|
LGPL to GPL.
|
|
|
|
|
2005-06-09 19:54:48 +02:00
|
|
|
@section Which codecs are supported by Windows ?
|
2004-06-29 14:13:34 +02:00
|
|
|
|
2005-12-17 19:14:38 +01:00
|
|
|
Windows does not support standard formats like MPEG very well, unless you
|
2004-06-29 14:13:34 +02:00
|
|
|
install some additional codecs
|
|
|
|
|
2005-06-09 21:54:58 +02:00
|
|
|
The following list of video codecs should work on most Windows systems:
|
2004-06-29 14:13:34 +02:00
|
|
|
@table @option
|
|
|
|
@item msmpeg4v2
|
|
|
|
.avi/.asf
|
|
|
|
@item msmpeg4
|
|
|
|
.asf only
|
|
|
|
@item wmv1
|
|
|
|
.asf only
|
|
|
|
@item wmv2
|
|
|
|
.asf only
|
|
|
|
@item mpeg4
|
2005-06-09 21:54:58 +02:00
|
|
|
only if you have some MPEG-4 codec installed like ffdshow or XviD
|
2004-06-29 14:13:34 +02:00
|
|
|
@item mpeg1
|
|
|
|
.mpg only
|
|
|
|
@end table
|
2005-12-17 19:14:38 +01:00
|
|
|
Note, ASF files often have .wmv or .wma extensions in Windows. It should also
|
|
|
|
be mentioned that Microsoft claims a patent on the ASF format, and may sue
|
2004-10-01 04:35:21 +02:00
|
|
|
or threaten users who create ASF files with non-Microsoft software. It is
|
|
|
|
strongly advised to avoid ASF where possible.
|
2004-06-29 14:13:34 +02:00
|
|
|
|
2005-06-09 21:54:58 +02:00
|
|
|
The following list of audio codecs should work on most Windows systems:
|
2004-06-29 14:13:34 +02:00
|
|
|
@table @option
|
|
|
|
@item adpcm_ima_wav
|
|
|
|
@item adpcm_ms
|
|
|
|
@item pcm
|
|
|
|
@item mp3
|
2005-06-09 21:54:58 +02:00
|
|
|
if some MP3 codec like LAME is installed
|
2004-06-29 14:13:34 +02:00
|
|
|
@end table
|
|
|
|
|
2005-06-09 21:54:58 +02:00
|
|
|
@section Why does the chrominance data seem to be sampled at a different time from the luminance data on bt8x8 captures on Linux?
|
2004-07-02 17:17:12 +02:00
|
|
|
|
2005-12-17 19:14:38 +01:00
|
|
|
This is a well-known bug in the bt8x8 driver. For 2.4.26 there is a patch at
|
2006-02-22 11:52:00 +01:00
|
|
|
(@url{http://mplayerhq.hu/~michael/bttv-420-2.4.26.patch}). This may also
|
2004-10-01 04:35:21 +02:00
|
|
|
apply cleanly to other 2.4-series kernels.
|
2004-07-02 17:17:12 +02:00
|
|
|
|
2005-06-09 19:54:48 +02:00
|
|
|
@section How do I avoid the ugly aliasing artifacts in bt8x8 captures on Linux?
|
2004-07-02 17:17:12 +02:00
|
|
|
|
2004-10-01 04:35:21 +02:00
|
|
|
Pass 'combfilter=1 lumafilter=1' to the bttv driver. Note though that 'combfilter=1'
|
2006-02-22 11:52:00 +01:00
|
|
|
will cause somewhat too strong filtering. A fix is to apply (@url{http://mplayerhq.hu/~michael/bttv-comb-2.4.26.patch})
|
|
|
|
or (@url{http://mplayerhq.hu/~michael/bttv-comb-2.6.6.patch})
|
2004-10-01 04:35:21 +02:00
|
|
|
and pass 'combfilter=2'.
|
2004-07-02 17:17:12 +02:00
|
|
|
|
2005-06-09 21:54:58 +02:00
|
|
|
@section I have a problem with an old version of ffmpeg; where should I report it?
|
2004-10-01 04:35:21 +02:00
|
|
|
Nowhere. Upgrade to the latest release or if there is no recent release upgrade
|
2006-06-09 11:55:04 +02:00
|
|
|
to Subversion HEAD. You could also try to report it. Maybe you will get lucky and
|
2005-06-09 19:54:48 +02:00
|
|
|
become the first person in history to get an answer different from "upgrade
|
2006-06-09 11:55:04 +02:00
|
|
|
to Subversion HEAD".
|
2004-07-23 03:26:56 +02:00
|
|
|
|
2005-06-09 21:54:58 +02:00
|
|
|
@section -f jpeg doesn't work.
|
2004-07-09 22:11:52 +02:00
|
|
|
|
2006-08-24 16:03:08 +02:00
|
|
|
Try '-f image2 test%d.jpg'.
|
2004-07-09 22:11:52 +02:00
|
|
|
|
2004-10-01 04:35:21 +02:00
|
|
|
@section Why can I not change the framerate?
|
2004-09-12 18:46:15 +02:00
|
|
|
|
2005-06-09 21:54:58 +02:00
|
|
|
Some codecs, like MPEG-1/2, only allow a small number of fixed framerates.
|
2004-10-01 04:35:21 +02:00
|
|
|
Choose a different codec with the -vcodec command line option.
|
2004-09-12 18:46:15 +02:00
|
|
|
|
2004-10-01 04:35:21 +02:00
|
|
|
@section ffmpeg does not work; What is wrong?
|
2004-09-16 16:33:33 +02:00
|
|
|
|
2004-10-01 04:35:21 +02:00
|
|
|
Try a 'make distclean' in the ffmpeg source directory. If this does not help see
|
2006-01-14 00:52:35 +01:00
|
|
|
(@url{http://ffmpeg.org/bugreports.php}).
|
2004-09-16 16:33:33 +02:00
|
|
|
|
2005-06-09 19:54:48 +02:00
|
|
|
@section How do I encode XviD or DivX video with ffmpeg?
|
2004-10-16 18:47:42 +02:00
|
|
|
|
2005-06-09 19:54:48 +02:00
|
|
|
Both XviD and DivX (version 4+) are implementations of the ISO MPEG-4
|
2004-10-16 18:47:42 +02:00
|
|
|
standard (note that there are many other coding formats that use this
|
|
|
|
same standard). Thus, use '-vcodec mpeg4' to encode these formats. The
|
2005-06-09 19:55:36 +02:00
|
|
|
default fourcc stored in an MPEG-4-coded file will be 'FMP4'. If you want
|
2005-12-17 19:14:38 +01:00
|
|
|
a different fourcc, use the '-vtag' option. E.g., '-vtag xvid' will
|
|
|
|
force the fourcc 'xvid' to be stored as the video fourcc rather than the
|
2004-10-16 18:47:42 +02:00
|
|
|
default.
|
|
|
|
|
2006-05-19 10:46:47 +02:00
|
|
|
@section How do I encode videos which play on the iPod?
|
2006-05-19 10:09:21 +02:00
|
|
|
|
|
|
|
@table @option
|
2006-05-19 10:46:47 +02:00
|
|
|
@item needed stuff
|
2006-05-19 10:09:21 +02:00
|
|
|
-acodec aac -vcodec mpeg4 width<=320 height<=240
|
2006-05-19 10:46:47 +02:00
|
|
|
@item working stuff
|
2006-05-19 10:09:21 +02:00
|
|
|
4mv, title
|
2006-05-19 10:46:47 +02:00
|
|
|
@item non-working stuff
|
|
|
|
B-frames
|
2006-05-19 10:09:21 +02:00
|
|
|
@item example command line
|
2006-11-20 22:48:08 +01:00
|
|
|
ffmpeg -i input -acodec aac -ab 128 -vcodec mpeg4 -b 1200kb -mbd 2 -flags +4mv+trell -aic 2 -cmp 2 -subcmp 2 -s 320x180 -title X output.mp4
|
2006-05-19 10:09:21 +02:00
|
|
|
@end table
|
|
|
|
|
2006-05-19 10:46:47 +02:00
|
|
|
@section How do I encode videos which play on the PSP?
|
2006-05-19 10:09:21 +02:00
|
|
|
|
|
|
|
@table @option
|
2006-05-19 10:46:47 +02:00
|
|
|
@item needed stuff
|
2006-05-19 10:09:21 +02:00
|
|
|
-acodec aac -vcodec mpeg4 width*height<=76800 width%16=0 height%16=0 -ar 24000 -r 30000/1001 or 15000/1001 -f psp
|
2006-05-19 10:46:47 +02:00
|
|
|
@item working stuff
|
2006-05-19 10:09:21 +02:00
|
|
|
4mv, title
|
2006-05-19 10:46:47 +02:00
|
|
|
@item non-working stuff
|
|
|
|
B-frames
|
2006-05-19 10:09:21 +02:00
|
|
|
@item example command line
|
2006-11-20 22:48:08 +01:00
|
|
|
ffmpeg -i input -acodec aac -ab 128 -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
|
2006-05-27 11:44:33 +02:00
|
|
|
@item needed stuff for H.264
|
|
|
|
-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
|
|
|
|
@item working stuff for H.264
|
|
|
|
title, loop filter
|
|
|
|
@item non-working stuff for H.264
|
|
|
|
CAVLC
|
|
|
|
@item example command line
|
2006-11-20 22:48:08 +01:00
|
|
|
ffmpeg -i input -acodec aac -ab 128 -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
|
2006-05-19 10:09:21 +02:00
|
|
|
@end table
|
|
|
|
|
2006-09-17 09:34:54 +02:00
|
|
|
@section How can I read DirectShow files?
|
2006-09-16 14:40:18 +02:00
|
|
|
|
2006-09-17 09:34:54 +02:00
|
|
|
If you have built FFmpeg with @code{./configure --enable-avisynth}
|
|
|
|
(only possible on MinGW/Cygwin platforms),
|
|
|
|
then you may use any file that DirectShow can read as input.
|
|
|
|
(Be aware that this feature has been recently added,
|
|
|
|
so you will need to help yourself in case of problems.)
|
2006-09-16 14:40:18 +02:00
|
|
|
|
|
|
|
Just create an "input.avs" text file with this single line ...
|
|
|
|
@example
|
|
|
|
DirectShowSource("C:\path to your file\yourfile.asf")
|
|
|
|
@end example
|
2006-09-17 09:34:54 +02:00
|
|
|
... and then feed that text file to FFmpeg:
|
2006-09-16 14:40:18 +02:00
|
|
|
@example
|
|
|
|
ffmpeg -i input.avs
|
|
|
|
@end example
|
|
|
|
|
|
|
|
For ANY other help on Avisynth, please visit @url{http://www.avisynth.org/}.
|
|
|
|
|
2002-11-04 19:50:04 +01:00
|
|
|
@chapter Development
|
|
|
|
|
2006-01-02 11:24:06 +01:00
|
|
|
@section When will the next FFmpeg version be released? / Why are FFmpeg releases so few and far between?
|
|
|
|
|
|
|
|
Like most open source projects FFmpeg suffers from a certain lack of
|
|
|
|
manpower. For this reason the developers have to prioritize the work
|
|
|
|
they do and putting out releases is not at the top of the list, fixing
|
|
|
|
bugs and reviewing patches takes precedence. Please don't complain or
|
|
|
|
request more timely and/or frequent releases unless you are willing to
|
|
|
|
help out creating them.
|
|
|
|
|
2005-11-10 03:25:47 +01:00
|
|
|
@section Why doesn't FFmpeg support feature [xyz]?
|
|
|
|
|
|
|
|
Because no one has taken on that task yet. FFmpeg development is
|
|
|
|
driven by the tasks that are important to the individual developers.
|
|
|
|
If there is a feature that is important to you, the best way to get
|
|
|
|
it implemented is to undertake the task yourself.
|
|
|
|
|
|
|
|
|
2004-10-01 04:35:21 +02:00
|
|
|
@section Are there examples illustrating how to use the FFmpeg libraries, particularly libavcodec and libavformat ?
|
2003-07-22 15:08:52 +02:00
|
|
|
|
2004-10-01 04:35:21 +02:00
|
|
|
Yes. Read the Developers Guide of the FFmpeg documentation. Alternatively,
|
2005-12-17 19:14:38 +01:00
|
|
|
examine the source code for one of the many open source projects that
|
2004-10-01 04:35:21 +02:00
|
|
|
already incorporate ffmpeg at (@url{projects.php}).
|
2003-07-22 15:08:52 +02:00
|
|
|
|
2002-11-04 19:50:04 +01:00
|
|
|
@section Can you support my C compiler XXX ?
|
|
|
|
|
2004-10-01 04:35:21 +02:00
|
|
|
No. Only GCC is supported. GCC is ported to most systems available and there
|
|
|
|
is no need to pollute the source code with @code{#ifdef}s
|
2002-11-04 19:50:04 +01:00
|
|
|
related to the compiler.
|
|
|
|
|
2003-09-16 22:28:18 +02:00
|
|
|
@section Can I use FFmpeg or libavcodec under Windows ?
|
2002-11-04 19:50:04 +01:00
|
|
|
|
2003-09-16 22:28:18 +02:00
|
|
|
Yes, but the MinGW tools @emph{must} be used to compile FFmpeg. You
|
|
|
|
can link the resulting DLLs with any other Windows program. Read the
|
2005-09-28 23:18:11 +02:00
|
|
|
@emph{Native Windows Compilation} and @emph{Visual C++ compatibility}
|
|
|
|
sections in the FFmpeg documentation to find more information.
|
2002-11-04 19:50:04 +01:00
|
|
|
|
|
|
|
@section Can you add automake, libtool or autoconf support ?
|
|
|
|
|
2004-10-01 04:35:21 +02:00
|
|
|
No. These tools are too bloated and they complicate the build. Moreover,
|
2002-11-04 19:50:04 +01:00
|
|
|
since only @samp{gcc} is supported they would add little advantages in
|
|
|
|
terms of portability.
|
|
|
|
|
2004-10-01 04:35:21 +02:00
|
|
|
@section Why not rewrite ffmpeg in object-oriented C++ ?
|
2004-07-15 23:28:18 +02:00
|
|
|
|
2005-06-09 19:54:48 +02:00
|
|
|
ffmpeg is already organized in a highly modular manner and does not need to
|
2005-12-17 19:14:38 +01:00
|
|
|
be rewritten in a formal object language. Further, many of the developers
|
2004-10-01 04:35:21 +02:00
|
|
|
favor straight C; it works for them. For more arguments on this matter,
|
|
|
|
read "Programming Religion" at (@url{http://lkml.org/faq/lkmlfaq-15.html}).
|
|
|
|
|
|
|
|
@section Why are the ffmpeg programs devoid of debugging symbols ?
|
|
|
|
|
|
|
|
The build process creates ffmpeg_g, ffplay_g, etc. which contain full debug
|
|
|
|
information. Those binaries are strip'd to create ffmpeg, ffplay, etc. If
|
|
|
|
you need the debug information, used the *_g versions.
|
2004-07-15 23:28:18 +02:00
|
|
|
|
2005-09-12 17:51:29 +02:00
|
|
|
@section I do not like the LGPL, can I contribute code under the GPL instead ?
|
2005-09-11 18:39:47 +02:00
|
|
|
|
2005-09-12 17:51:29 +02:00
|
|
|
Yes, as long as the code is optional and can easily and cleanly be placed
|
|
|
|
under #ifdef CONFIG_GPL without breaking anything. So for example a new codec
|
|
|
|
or filter would be OK under GPL while a bugfix to LGPL code would not.
|
2005-09-11 18:39:47 +02:00
|
|
|
|
2005-09-12 17:51:29 +02:00
|
|
|
@section I want to compile xyz.c alone but my compiler produced many errors.
|
2005-09-11 18:39:47 +02:00
|
|
|
|
2005-09-12 17:51:29 +02:00
|
|
|
Common code is in its own files in libav* and is used by the individual
|
|
|
|
codecs. They will not work without the common parts, you have to compile
|
|
|
|
the whole libav*. If you wish, disable some parts with configure switches.
|
|
|
|
You can also try to hack it and remove more, but if you had problems fixing
|
|
|
|
the compilation failure then you are probably not qualified for this.
|
2005-09-11 18:39:47 +02:00
|
|
|
|
2005-09-14 01:33:53 +02:00
|
|
|
@section Visual C++ produces many errors.
|
2005-09-11 18:39:47 +02:00
|
|
|
|
2005-12-02 16:25:10 +01:00
|
|
|
Visual C++ is not compliant to the C standard and does not support
|
|
|
|
the inline assembly used in FFmpeg.
|
2005-09-14 01:33:53 +02:00
|
|
|
If you wish - for whatever weird reason - to use Visual C++ for your
|
|
|
|
project then you can link the Visual C++ code with libav* as long as
|
2005-09-28 23:18:11 +02:00
|
|
|
you compile the latter with a working C compiler. For more information, see
|
|
|
|
the @emph{Visual C++ compatibility} section in the FFmpeg documentation.
|
2005-09-11 18:39:47 +02:00
|
|
|
|
2005-12-02 16:25:10 +01:00
|
|
|
There have been efforts to make FFmpeg compatible with Visual C++ in the
|
|
|
|
past. However, they have all been rejected as too intrusive, especially
|
|
|
|
since MinGW does the job perfectly adequately. None of the core developers
|
|
|
|
work with Visual C++ and thus this item is low priority. Should you find
|
|
|
|
the silver bullet that solves this problem, feel free to shoot it at us.
|
|
|
|
|
2006-05-18 10:01:47 +02:00
|
|
|
@section I have a file in memory / a API different from *open/*read/ libc how do i use it with libavformat ?
|
|
|
|
|
2006-06-09 11:55:04 +02:00
|
|
|
You have to implement a URLProtocol, see libavformat/file.c in FFmpeg
|
|
|
|
and libmpdemux/demux_lavf.c in MPlayer sources.
|
2006-05-18 10:01:47 +02:00
|
|
|
|
2006-10-04 18:05:00 +02:00
|
|
|
@section I get "No compatible shell script interpreter found." in MSys.
|
|
|
|
|
|
|
|
The standard MSys bash (2.04) is broken. You need to install 2.05 or later.
|
|
|
|
|
2002-11-04 19:50:04 +01:00
|
|
|
@bye
|