Reporting a Bug To The FFmpeg Project

Before reporting a bug, please consider the following items:

FFmpeg is in a state of perpetual development. As such, if you wish to query or report a bug, you must try with the latest development branch revision of FFmpeg to confirm the issue still exists.

When writing your bug report, please include (uncompressed):

You can use the -report option or define the FFREPORT environment variable (to any value) to get the exact command line and the full verbose console output in a file named ffmpeg-*.log in the current directory. Note that the -report option is recent, it will not help tracking regressions in old revisions.

If you encounter a crash bug, please provide the gdb output, backtrace and disassembly, and if possible the valgrind output, using the the ffmpeg_g debug binary.

For gdb, proceed as follows:

gdb ffmpeg_g

In gdb, type 'r' for run, along with the rest of the ffmpeg command line:

r <rest of command line>

(Alternatively, you can run gdb --args ffmpeg_g <rest of command line> and just type 'r' at the gdb prompt.)

When gdb encounters its problem, run the following commands and copy/paste the output into your bug report:

bt
disass $pc-32,$pc+32
info all-registers

With older gdb versions, use disass $pc-32 $pc+32.

For valgrind, run the following command and copy/paste the output into your bug report:

valgrind ffmpeg_g <rest of command line>

Bug Tracker

Once you have gathered this information, you can submit a report to the FFmpeg bug tracker. Note, you must register there first before you can submit a report. You should provide all information so that anyone can reproduce the bug. Please do not report your problem on the developer mailing list: Only send bug reports there if you also intend to provide a fix.

Submitting Sample Media

The developers may ask you to provide a sample media file illustrating your problem. In this case, please follow these steps:

Important: Movie files which have been compressed (rar,7z,gzip,...) will be deleted without being examined unless they are raw RGB/YUV/PCM. Furthermore movie files uploaded to services like megaupload, rapidshare or any other similar service will be ignored. We are not willing to spend our time fighting with this ridiculous, bloated and spam-filled crap.