Welcome to the FFmpeg Bug Tracker and Wiki

This Wiki is intended for all kinds of FFmpeg and multimedia related information. Everyone is welcome to add to, edit and improve it!

Bug Reports

• List of Bug Reports

Please read the ​Bug Tracker Manual and ​Submitting a Bug Report before filing a new report. You must register before you can file a report or edit this wiki. For uploading samples, either use ​http://www.datafilehost.com/ or the ftp on ​Submitting a Bug Report (there is no hard filesize limit).

FFmpeg Official Documentation

• ​Documentation – FFmpeg's main documentation page
• Submit an FFmpeg Logo – Instructions on how to submit a themed logo or banner to FFmpeg

Developer Documentation

• ​Development Policies and Guides
• ​Guide for Using Git
• Notes on Maintaining FFmpeg Source Code and Being a Maintainer
• FATE – Our Continuous Integration Platform
• Debugging
  • Macroblocks and Motion Vectors

FFmpeg-related Programs

• Google Summer of Code
  • GSoC 2014
• GNOME Outreach Program for Women
  • OPW Dec. 2014 to Mar. 2015

FFmpeg Developer Meetings

• FFmeeting/2014-01
• FFmeeting/2014-10

Community Contributed Documentation

The guides below have been written by users and for users to supplement the official ​FFmpeg Documentation. If you're confused about something refer to the official documentation and if you're still having problems we can ​help.

Compiling FFmpeg

• Generic compilation guide
• FFmpeg Compilation Guides for Windows, OS X, Linux, and other platforms
• Compile Benchmarks
• Quick compilation guides:
  • How to quickly compile libx264 as a pre-requisite to using it within FFmpeg
  • How to quickly compile libaacplus as a pre-requisite to using it within FFmpeg
  • How to quickly compile libopus as a pre-requisite to using it within FFmpeg
  • How to quickly compile FFmpeg with libx264 (x264, H.264)?
  • How to quickly compile FFmpeg with libmp3lame, libaacplus and libx264?
  • How to quickly compile FFmpeg with libopus and libx264? for the real-time audio/video streaming

Encoding

• Video:
  • FFV1 Cheat Sheet
  • H.264 Encoding Guide
  • H.265 Encoding Guide
  • Xvid / DivX / MPEG-4 Encoding Guide
  • VFX Pipeline Encoding Guide
  • VP8 (WebM) Encoding Guide
  • Windows Media Player Encoding Tips?
• Audio:
  • AAC Encoding Guide
  • MP3 Encoding Guide
  • Guidelines for high quality audio encoding
• Other encoding guides:
  • Theora Video and Vorbis Audio Encoding Guide
  • How to encode videos for YouTube and other video sharing sites

Hardware acceleration

• Hardware acceleration introduction with FFmpeg

Grabbing / Capturing

• Capturing audio with FFmpeg and ALSA
• How to grab the desktop (screen) with FFmpeg
• How to capture a lightning (thunderbolt) with FFmpeg
• How to capture a webcam input

Streaming

• Encoding for Streaming Sites such as justin.tv, twitch.tv, ustream.tv, YouTube Live, and other RTMP(E) streaming providers.
• Streaming Guide
• Streaming media with ffserver

Filtering

• Filtering Guide
• Fancy Filtering Examples
• Scaling (resizing) with ffmpeg
• Postprocessing Postprocessing low-quality video with FFmpeg
• Stereoscopic 3D movies with ffmpeg

Images / Frames

• Create a video slideshow from images
• Create a thumbnail image every X seconds of the video
• How to take multiple screenshots to an image (tile, mosaic)
• Create a mosaic out of several input videos
• Create a Waveform Image from an Audio Stream

Subtitles

• How to burn subtitles into the video
• How to convert other FFmpeg-supported subtitles to ASS format

Developing Programs Using the FFmpeg Libraries

• How to setup Eclipse IDE for FFmpeg development
• Using libav* – Instructions for how to integrate FFmpeg's main libraries into your own custom programs
• Including FFmpeg headers in a C++ application
• ​List of FFmpeg API changes/compatibility test results

Other / FAQ

• General command line usage:
  • Creating multiple outputs from the same input
  • How to concatenate, join, or merge media files
  • How to use -map option to select exactly which streams to process
  • Seeking with FFmpeg if you need to split a file, or select just a part of one
  • framemd5 Intro and HowTo for using per-frame checksums
  • FFprobe Tips for getting frame rate, frame size, duration, etc.
• Effects:
  • How to speed up / slow down a video time lapse, etc.
• Video:
  • Debugging Macroblocks and Motion Vectors
  • Option '-sameq' does NOT mean 'same quality'
  • Viterbi Algorithm
• Audio:
  • Audio Channel Manipulation – Upmix, downmix, split, and manipulate audio channels
  • Audio Types – list of the different types of raw audio
  • How to change audio volume up-down with FFmpeg
  • High quality audio resampling with FFmpeg and the SoX Resampler
• Working with other tools:
  • How to encode with FFmpeg from Adobe Premiere Pro
  • Using FFmpeg from PHP scripts
• Other:
  • How to ask good questions on ffmpeg-user mailing list
  • Articles for Creation – A simple idea/reminder list for new community contributed wiki articles
  • Downstreams - A list of downstream software products that distribute FFmpeg, including versions and end-of-life dates
  • Projects - A list of free projects and programs known to incorporate work from FFmpeg.

The materials within the Community Contributed Documentation section of the FFmpeg Wiki are released under the ​Creative Commons Attribution-ShareAlike 3.0 License. This allows anyone to share, adapt, and build upon this work, even for commercial purposes, as long as the same or compatible license is used and that credit is properly attributed to the author(s). Credit should be attributed to "Contributors to the FFmpeg Community Documentation Wiki".

Wiki Page Index

For a complete list of all local wiki pages, see TitleIndex.

Trac Documentation

Trac is what FFmpeg uses for tracking bugs (and also hosts this wiki).

• TracGuide -- Built-in Documentation
• ​The Trac project -- Trac Open Source Project
• ​Trac FAQ -- Frequently Asked Questions
• TracSupport -- Trac Support