FFmpeg is a free software project, the product of which is a vast software suite of libraries and programs for handling video, audio, and other multimedia files and streams. At its core is the FFmpeg program itself, designed for command-line-based processing of video and audio files, widely used for format transcoding, basic editing (trimming and concatenation), video scaling, video post-production effects, and standards compliance (SMPTE, ITU). FFmpeg includes libavcodec, an audio/video codec library used by many commercial and free software products, libavformat (Lavf), an audio/video container mux and demux library, and the core ffmpeg command line program for transcoding multimedia files. FFmpeg is published under the GNU Lesser General Public License 2.1+ or GNU General Public License 2+ (depending on which options are enabled).
FFmpeg running on Microsoft Windows
|Original author(s)||Fabrice Bellard|
|Initial release||December 20, 2000|
|Stable release||4.0.2 (July 18, 2018) [±]|
|Preview release||Git [±]|
|Written in||C and Assembly|
|Operating system||Windows, macOS, and Linux; may be compiled for other OSes.|
|Platform||x86, ARM, PowerPC, MIPS, DEC Alpha, Blackfin, AVR32, SH-4, and SPARC; may be compiled for other desktop computers|
LGPL 2.1+, GPL 2+ |
Unredistributable if compiled with NVIDIA Performance Primitives
The name of the project is inspired by the MPEG video standards group, together with "FF" for "fast forward". The logo uses a zigzag pattern that shows how MPEG video codecs handle entropy encoding.
FFmpeg is part of the workflow of hundreds of other software projects, and its libraries are a core part of software media players such as VLC, and has been included in core processing for YouTube and the iTunes inventory of files. Codecs for the encoding and/or decoding of most of all known audio and video file formats is included, making it highly useful for the transcoding of common and uncommon media files into a single common format.
The project was started by Fabrice Bellard (using the pseudonym "Gérard Lantau") in 2000, and was led by Michael Niedermayer from 2004 until 2015. Some FFmpeg developers were also part of the MPlayer project.
In January 2018, the ffserver command-line program – a long-time component of FFmpeg – was removed. The developers had previously deprecated the program citing high maintenance efforts due to its use of internal application programming interfaces (API).
The project publishes a new release every three months on average. While release versions are available from the website for download, FFmpeg developers recommend that users compile the software from source using the latest build from their source code Git version control system.
Two video coding formats with corresponding codecs and one container format have been created within the FFmpeg project so far. The two video codecs are the lossless FFV1, and the lossless and lossy Snow codec. Development of Snow has stalled, while its bit-stream format has not been finalized yet, making it experimental since 2011. The multimedia container format called NUT is no longer being actively developed, but still maintained.
In summer 2010, Fiona Glaser, Ronald Bultje, and David Conrad of the FFmpeg Team announced the ffvp8 decoder. Through testing, they determined that ffvp8 was faster than Google's own libvpx decoder. Starting with version 0.6, FFmpeg also supported WebM and VP8.
In October 2013, a native VP9 and the OpenHEVC decoder, an open source High Efficiency Video Coding (HEVC) decoder, were added to FFmpeg. In 2016 the native AAC encoder was considered stable, removing support for the two external AAC encoders from VisualOn and FAAC. FFmpeg 3.0 (nicknamed "Einstein" ) retained build support for the Fraunhofer FDK AAC encoder.
Command line toolsEdit
- ffmpeg is a command-line tool that converts audio or video formats. It can also capture and encode in real-time from various hardware and software sources such as a TV capture card.
- ffplay is a simple media player utilizing SDL and the FFmpeg libraries.
- ffprobe is a command-line tool to display media information (text, CSV, XML, JSON), see also Mediainfo.
- libswresample is a library containing audio resampling routines.
- libavresample is a library containing audio resampling routines from the Libav project, similar to libswresample from ffmpeg.
- libavcodec is a library containing all of the native FFmpeg audio/video encoders and decoders. Most codecs were developed from scratch to ensure best performance and high code reusability.
- libavformat (Lavf) is a library containing demuxers and muxers for audio/video container formats.
- libavutil is a helper library containing routines common to different parts of FFmpeg. This library includes hash functions (Adler-32, CRC, MD5, RIPEMD, SHA-1. SHA-2, MurmurHash3, HMAC MD-5, HMAC SHA-1 and HMAC SHA-2), ciphers (DES, RC4, AES, AES-CTR, TEA, XTEA, Blowfish, CAST-128, Twofish and Camellia), LZO decompressor and Base64 encoder/decoder.
- libpostproc is a library containing older h263 based video postprocessing routines.
- libswscale is a library containing video image scaling and colorspace/pixelformat conversion routines.
- libavfilter is the substitute for vhook which allows the video/audio to be modified or examined between the decoder and the encoder. Filters have been ported from many projects including MPlayer and avisynth
FFmpeg encompasses software implementations of video and audio compressing and decompressing algorithms. These can be compiled and run on diverse instruction sets.
Special purpose hardwareEdit
Various application-specific integrated circuits (ASIC) related to video and audio compression and decompression do exist. Such ASIC can perform the computation for audio/video decompression or compression partly or fully to offload these from the host CPU. To make use of such ASIC, instead of a complete implementation of some algorithm, only the API is required. There are numerous ASICs and APIs available, of which several are supported by FFmpeg.
|Firm||ASIC||purpose||supported by FFmpeg||Details|
|AMD||UVD||decoding||✓||via VDPAU API and VAAPI|
|VCE||encoding||✓||via VAAPI, considered experimental|
|Amlogic||Amlogic Video Engine||decoding||?|
|BlackMagic||DeckLink||encoding/decoding||✓||real-time ingest and playout|
|Intel||Intel Clear Video||decoding||✓|
|Intel Quick Sync Video||encoding/decoding||✓|
|Nvidia||PureVideo / NVDEC||decoding||✓||via the VDPAU API as of FFmpeg v1.2 (deprecated)|
via CUVID API as of FFmpeg v3.1
|NVENC||encoding||✓||as of FFmpeg v2.6|
Use with the FFmpeg UtilityEdit
Internal hardware acceleration decoding is enabled through the
-hwaccel option. It starts decoding normally, but if a decodable stream is detected in hardware, then the decoder designates all significant processing to that hardware, thus accelerating the decoding process. Whereas if no decodable streams are detected (as happens on an unsupported codec or profile), hardware acceleration will be skipped and it will still be decoded in software.
-hwaccel_device option is applied when the hardware requires a particular device to function especially there are several graphic cards are available.
Supported codecs and formatsEdit
FFmpeg supports many common and some uncommon image formats.
The PGMYUV image format is a homebrewn variant of the binary (P5) PGM Netpbm format. FFmpeg also supports 16-bit depths of the PGM and PPM formats, and the binary (P7) PAM format with or without alpha channel, depth 8 bit or 16 bit for
pix_fmts monob, gray, gray16be, rgb24, rgb48be, ya8, rgba, rgb64be.
In addition to FFV1 and Snow formats, which were created and developed from within FFmpeg, the project also supports the following formats:
|Group||Format type||Format name|
|ISO/IEC/ITU-T||Video||MPEG-1 Part 2, H.261 (Px64), H.262/MPEG-2 Part 2, H.263, MPEG-4 Part 2, H.264/MPEG-4 AVC, HEVC/H.265 (MPEG-H Part 2), Motion JPEG, IEC DV video and CD+G|
|Audio||MP1, MP2, MP3, AAC, HE-AAC, MPEG-4 ALS, G.711 µ-law, G.711 A-law, G.721 (a.k.a. G.726 32k), G.722, G.722.2 (a.k.a. AMR-WB), G.723 (a.k.a. G.726 24k and 40k), G.723.1, G.726, G.729, G.729D, IEC DV audio and Direct Stream Transfer|
|Subtitle||MPEG-4 Timed Text (a.k.a. 3GPP Timed Text)|
|Image||JPEG, JPEG-LS, JPEG 2000, PNG, CCITT G3 and CCITT G4|
|Alliance for Open Media||Video||AV1|
|SMPTE||Video||SMPTE 314M (a.k.a. DVCAM and DVCPRO), SMPTE 370M (a.k.a. DVCPRO HD), VC-1 (a.k.a. WMV3), VC-2 (a.k.a. Dirac Pro), VC-3 (a.k.a. AVID DNxHD)|
|ATSC/ETSI/DVB||Audio||Full Rate (GSM 06.10), AC-3 (Dolby Digital), Enhanced AC-3 (Dolby Digital Plus) and DTS Coherent Acoustics (a.k.a. DTS or DCA)|
|Subtitle||DVB Subtitling (ETSI 300 743)|
|DVD Forum/Dolby||Audio||MLP / Dolby TrueHD|
|DTS, Inc/QDesign||Audio||DTS Coherent Acoustics (a.k.a. DTS or DCA), DTS Extended Surround (a.k.a. DTS-ES), DTS 96/24, DTS-HD High Resolution Audio, DTS Express (a.k.a. DTS-HD LBR), DTS-HD Master Audio, QDesign Music Codec 1 and 2|
|Blu-ray Disc Association||Subtitle||PGS (Presentation Graphics Stream)|
|3GPP||Audio||AMR-NB, AMR-WB (a.k.a. G.722.2)|
|3GPP2||Audio||QCELP-8 (a.k.a. SmartRate or IS-96C), QCELP-13 (a.k.a. PureVoice or IS-733) and Enhanced Variable Rate Codec (EVRC. a.k.a. IS-127)|
|World Wide Web Consortium||Video||Animated GIF|
|IETF||Audio||iLBC (via libilbc), Opus and Comfort noise|
|International Voice Association||Audio||DSS-SP|
|Microsoft||Video||Microsoft RLE, Microsoft Video 1, Cinepak, Indeo (v2, v3 and v5), Microsoft MPEG-4 v1, v2 and v3, Windows Media Video (WMV1, WMV2, WMV3/VC-1), WMV Screen and Mimic codec|
|Audio||Windows Media Audio (WMA1, WMA2, WMA Pro and WMA Lossless), XMA (XMA1 and XMA2), MS-GSM and MS-ADPCM|
|Image||Windows Bitmap, WMV Image (WMV9 Image and WMV9 Image v2) and DirectDraw Surface|
|Interactive Multimedia Association||Audio||IMA ADPCM|
|Digital Video Interactive||Video||RTV 2.1 (Intel Indeo 2)|
|Audio||DVI4 audio codec|
|RealNetworks||Video||RealVideo Fractal Codec (a.k.a. Iterated Systems ClearVideo), 1, 2, 3 and 4|
|Audio||RealAudio v1 – v10|
|Apple||Video||Cinepak (Apple Compact Video), ProRes, Sorenson 3 Codec, QuickTime Animation (Apple Animation), QuickTime Graphics (Apple Graphics), Apple Video, Apple Intermediate Codec and Pixlet|
|Adobe Flash Player (SWF)||Video||Screen video, Screen video 2, Sorenson Spark and VP6|
|Audio||Adobe SWF ADPCM and Nellymoser Asao|
|Aldus / Adobe||Image||TIFF and PSD|
|Audio||Speex (via libspeex), Vorbis, Opus and FLAC|
|Sony||Audio||Adaptive Transform Acoustic Coding (ATRAC1, ATRAC3 and ATRAC3Plus) and PSX ADPCM|
|On2 / GIPS / Google||Video||Duck TrueMotion 1, Duck TrueMotion 2, Duck TrueMotion 2.0 Real Time, VP3, VP5, VP6, VP7, VP8, VP9 and animated WebP|
|Audio||DK ADPCM Audio 3/4, On2 AVC and iLBC (via libilbc)|
|RAD Game Tools||Video||Smacker video and Bink video|
|Netpbm||Image||PBM, PGM, PPM, PNM and PAM|
|MIT/X Consortium/The Open Group||Image||XBM, XPM and xwd|
|Silicon Graphics||Video||Silicon Graphics RLE 8-bit video, Silicon Graphics MVC1/2|
|Image||Silicon Graphics Image|
|Oracle/Sun Microsystems||Image||Sun Raster|
|Avid Technology / Truevision||Video||Avid 1:1x, Avid Meridien, Avid DNxHD and DNxHR|
|Autodesk / Alias||Video||Autodesk Animator Studio Codec and FLIC|
|Grass Valley / Canopus||Video||HQ, HQA, HQX and Lossless|
|Industrial Light & Magic / Lucasfilm||Image||OpenEXR|
|Matrox||Video||Matrox Uncompressed SD (M101) / HD (M102)|
|Asus||Video||ASUS V1/V2 codec|
|Spruce Technologies||Subtitle||Spruce subtitle (STL)|
Output formats (container formats and other ways of creating output streams) in FFmpeg are called "muxers". FFmpeg supports, among others, the following:
- AVI and also input from AviSynth
- GXF, General eXchange Format, SMPTE 360M
- HLS, HTTP Live Streaming
- ISO base media file format (including QuickTime, 3GP and MP4)
- Matroska (including WebM)
- Maxis XA
- MPEG program stream
- MPEG transport stream (including AVCHD)
- MXF, Material eXchange Format, SMPTE 377M
- MSN Webcam stream
- Segment, for creating segmented video streams
- Smooth Streaming
FFmpeg supports many pixel formats. Some of these formats are only supported as input formats. The command
ffmpeg -pix_fmts provides a list of supported pixel formats.
|Without alpha||With alpha||Without alpha||With alpha||Chroma-interleaved||With alpha|
|Monochrome||Binary (1-bit monochrome)||monoblack, monowhite||-||-||-||-||-|
|Grayscale||8 / 9 / 10 / 12 / 14 / 16bpp||-||-||16 / 32bpp||-||-|
|RGB||RGB 1:2:1 (4-bit color)||4bpp||-||-||-||-||-|
|RGB 3:3:2 (8-bit color)||8bpp||-||-||-||-||-|
|RGB 5:5:5 (High color)||16bpp||-||-||-||-||-|
|RGB 5:6:5 (High color)||16bpp||-||-||-||-||-|
|RGB/BGR||24 / 48bpp||32[p 1] / 64bpp||-||-||-||8bit->32bpp|
|GBR[p 2]||-||-||8 / 9 / 10 / 12 / 14 / 16bpc||8 / 10 / 12 / 16bpc||-||-|
|YUV||YVU 4:1:0||-||-||(9bpp (YVU9))[p 3]||-||-||-|
|YUV 4:1:1||8bpc (UYYVYY)||-||8bpc||-||(8bpc (NV11))||-|
|YVU 4:2:0||-||-||(8bpc (YV12))[p 3]||-||8 (NV21)||-|
|YUV 4:2:0||-||-||8[p 4] / 9 / 10 / 12 / 14 / 16bpc||8 / 9 / 10 / 16bpc||8 (NV12) / 10 (P010) / 16bpc (P016)||-|
|YVU 4:2:2||-||-||(8bpc (YV16))[p 3]||-||(8bpc (NV61))||-|
|YUV 4:2:2||8bpc (YUYV[p 5] and UYVY)[p 6]||-||8[p 7] / 9 / 10 / 12 / 14 / 16bpc||8 / 9 / 10 / 16bpc||8 (NV16) / 10bpc (NV20 a.k.a. P210)[p 8]||-|
|YUV 4:4:0||-||-||8 / 10 / 12bpc||-||-||-|
|YVU 4:4:4||-||-||(8bpc (YV24))[p 3]||-||(8bpc (NV42))||-|
|YUV 4:4:4||(10 (Y410) and 16bpc (Y416))||16bpc[p 9]||8[p 10] / 9 / 10 / 12 / 14 / 16bpc||8 / 9 / 10 / 16bpc||(8bpc (NV24))||-|
|XYZ||XYZ 4:4:4[p 11]||12bpc||-||-||-||-||-|
|Bayer||BGGR/RGGB/GBRG/GRBG||8 / 16bpp||-||-||-||-||-|
- RGBx (rgb0) and xBGR (0bgr) are also supported
- used in YUV-centric codecs such like H.264
- YVU9, YV12, YV16, and YV24 are supported as rawvideo codec in FFmpeg.
- I420 a.k.a. YUV420P
- aka YUY2 in Windows
- Y210 (YUYV 10bpc) is not supported. UYVY 10bpc without a padding is supported as bitpacked codec in FFmpeg. UYVY 10bpc with 2-bits padding is supported as v210 codec in FFmpeg. 16bpc (Y216) is supported as targa_y216 codec in FFmpeg.
- I422 a.k.a. YUV422P
- 16bpc (P216) is not supported
- 8bpc (AYUV) is not supported
- I444 a.k.a. YUV444P
- used in JPEG2000
- IETF RFCs
- IETF I-Ds:
- Microsoft OSP
- Pro-MPEG Forum: Pro-MPEG CoP #3 r2
- Icecast protocol
FFmpeg supports, among others, the following filters.
FFmpeg contains more than 100 codecs, most of which use compression techniques of one kind or another. Many such compression techniques may be subject to legal claims relating to software patents. Such claims may be enforceable in countries like the United States which have implemented software patents, but are considered unenforceable or void in member countries of the European Union, for example.
In June 2011 an election was organized to establish the board of FFmtech foundation, a non-profit organization dedicated for managing donation funds. It was designed to offer reimbursement for expenses and work done to FFmpeg and Libav. However, according to FFmpeg developer Ronald Bultje, the results have been doubtful.
Projects using FFmpegEdit
FFmpeg is used by software such as VLC media player, xine, Plex, Kodi, Blender, YouTube, and MPC-HC; it handles video and audio playback in Google Chrome, and Linux version of Firefox. Graphical user interface front-ends for FFmpeg have been developed, including Avanti, XMedia Recode and Multimedia Xpert. JavaCV, a Java wrapper for OpenCV, includes a supplementary Java wrapper for FFmpeg.
On March 13, 2011, a group of FFmpeg developers decided to fork the project under the name "Libav". The event was related to an issue in project management, in which developers disagreed with the leadership of FFmpeg.
- "Initial revision - git.videolan.org/ffmpeg.git/commit". git.videolan.org. 2000-12-20. Archived from the original on 2013-12-25. Retrieved 2013-05-11.
- "FFmpeg 4.0 "Wu"". FFmpeg Git. 2018-07-18. Retrieved 2018-07-18.
- "Developer Documentation". ffmpeg.org. 2011-12-08. Retrieved 2012-01-04.
- "Download". ffmpeg.org. FFmpeg. Retrieved 2012-01-04.
- FFmpeg can be configured to make it proprietary and unredistributable software, because NVIDIA Performance Primitives, an optional external library, is proprietary software and cannot be distributed under the terms of the GPL.
- "FFmpeg: Lavf: I/O and Muxing/Demuxing Library". ffmpeg.org. Retrieved 21 October 2016.
- "FFmpeg License and Legal Considerations". ffmpeg.org. Retrieved 2012-01-04.
- Bellard, Fabrice (18 February 2006). "FFmpeg naming and logo". FFmpeg developer mailing list. FFmpeg website. Retrieved 24 December 2011.
- Carlsen, Steve (1992-06-03). "TIFF 6.0 specification" (PS). Aldus. p. 98. Archived (PDF) from the original on 2004. Retrieved 2016-08-14.
- Niedermayer, Michael. "[FFmpeg-devel] FFmpegs future and resigning as leader". Retrieved 2015-09-22.
- "FFmpeg and a thousand fixes". googleblog.com. January 10, 2014. Retrieved 21 October 2016.
- "ffserver – FFmpeg". trac.ffmpeg.org. Retrieved 2018-02-03.
- "ffserver program being dropped". ffmpeg.org. 2016-07-10. Retrieved 2018-02-03.
- "ffmpeg.org/download.html#releases". ffmpeg.org. Retrieved 2015-04-27.
- "NUT". Multimedia Wiki. 2012. Retrieved 2014-01-03.
- Glaser, Fiona (2010-07-23), Diary Of An x264 Developer: Announcing the world’s fastest VP8 decoder, archived from the original on 2010-09-30, retrieved 2012-01-04
- FFmpeg Announces High-Performance VP8 Decoder, Slashdot, 2010-07-24, retrieved 2012-01-04
- "FFmpeg Goes WebM, Enabling VP8 for Boxee & Co". newteevee.com. 2010-06-17. Retrieved 2012-01-04.
- "Native VP9 decoder is now in the Git master branch". Launchpad. 2013-10-03. Retrieved 2013-10-21.
- "FFmpeg Now Features Native HEVC/H.265 Decoder Support". Softpedia. 2013-10-16. Retrieved 2013-10-16.
- FFmpeg (2016-02-15). "February 15th, 2016, FFmpeg 3.0 "Einstein"". Retrieved 2016-04-02.
- "FFmpeg Automated Testing Environment". Fate.multimedia.cx. Retrieved 2012-01-04.
- "FFmpeg Hardware Acceleration". ffmpeg.org Wiki. Retrieved 2016-11-12.
- "Hardware/VAAPI – FFmpeg". trac.ffmpeg.org. Retrieved 2017-10-16.
- "FFmpeg Changelog".
- "Changelog". FFmpeg trunk SVN. FFmpeg. 17 April 2007. Retrieved 26 April 2007.[permanent dead link]
- "git.ffmpeg.org Git - ffmpeg.git/commit". git.ffmpeg.org. Retrieved 2018-04-23.
- "ATRAC3plus decoder - git.videolan.org Git - ffmpeg.git/commit". git.videolan.org. 2013-12-28. Archived from the original on 2013-12-30. Retrieved 2013-12-28.
- "FFmpeg development mailing list". FFmpeg development. FFmpeg. 7 May 2007. Archived from the original on 11 August 2007. Retrieved 24 December 2010.
- vitor (13 April 2008). "FFmpeg development mailing list". FFmpeg development. FFmpeg website. Retrieved 14 April 2008.[permanent dead link]
- vitor (30 March 2008). "FFmpeg development mailing list". FFmpeg development. FFmpeg website. Retrieved 30 March 2008.[permanent dead link]
- benoit (14 April 2008). "FFmpeg development mailing list". FFmpeg development. FFmpeg website. Retrieved 14 April 2008.[permanent dead link]
- Michael Niedermayer, Timothy Gu (2014-12-05). "RELEASE NOTES for FFmpeg 2.5 "Bohr"". VideoLAN. Archived from the original on 2014-12-08. Retrieved 2014-12-05.
- ramiro (18 March 2008). "FFmpeg development mailing list". FFmpeg development. FFmpeg website. Archived from the original on 17 August 2008. Retrieved 18 March 2008.
- banan (8 June 2008). "FFmpeg development mailing list". FFmpeg development. FFmpeg website. Archived from the original on 14 January 2009. Retrieved 8 June 2008.
- faust3 (21 March 2008). "FFmpeg development mailing list". FFmpeg development. FFmpeg website. Archived from the original on 25 April 2008. Retrieved 21 March 2008.
- "FFmpeg: libavutil/pixfmt.h File Reference - enum AVPixelFormat". FFmpeg Project. 2015-11-17. Retrieved 2015-11-18.
- van Kesteren, Anne (2010-09-01). "Internet Drafts are not Open Standards". annevankesteren.nl. Self-published. Retrieved 2015-03-22.
- Real Time Streaming Protocol 2.0 (RTSP) draft-ietf-mmusic-rfc2326bis-40 P.231
- "rtsp: Support tls-encapsulated RTSP - git.videolan.org Git - ffmpeg.git/commit". videolan.org. Retrieved 21 October 2016.
- "FFmpeg Filters". ffmpeg.org. Retrieved 2017-03-27.
- How it works earwax.ca
- "Codecs list". ffmpeg.org. Retrieved 2012-01-01.
- "Legal information on FFmpeg's website". ffmpeg.org. Retrieved 2012-01-04.
- "[Ffmtech-board-election] FFmtech board elections". June 8, 2011. Retrieved 14 August 2015.
- "[Ffmpeg-devel-irc] ffmpeg-devel.log.20150814". August 14, 2015. Retrieved 15 August 2014.
- "Google's YouTube Uses FFmpeg | Breaking Eggs And Making Omelettes". Multimedia.cx. 2011-02-08. Retrieved 2012-08-06.
- "FFmpeg-based Projects". Ffmpeg.org. Retrieved 2012-01-04.
- "Firefox Enables FFmpeg Support By Default". Phoronix. 2015-11-15. Retrieved 2015-11-18.
- "Avanti: FFmpeg/Avisynth GUI". Retrieved 2011-08-17.
- "JavaCV". GitHub. 2015.
- Libav project site, retrieved 2012-01-04
- Ronald S. Bultje (2011-03-14), Project renamed to Libav, retrieved 2012-01-04
- A group of FFmpeg developers just forked as Libav, Phoronix, 2011-03-14, retrieved 2012-01-04
- What happened to FFmpeg, 2011-03-30, retrieved 2012-05-19
- FFMpeg turmoil, 2011-01-19, retrieved 2012-01-04
- "The FFmpeg/Libav situation". blog.pkh.me. Retrieved 2015-09-22.