Skip to content
An FFmpeg based source library and Avisynth/VapourSynth plugin for easy frame accurate access
C++ C Makefile M4 Other
Branch: master
Clone or download
dwbuiten tests: Also tests frames against the FFMS_Frame keyframe info
Helps easier expose mismatches between info and frame.

Signed-off-by: Derek Buitenhuis <derek.buitenhuis@gmail.com>
Latest commit a9e8f73 Mar 19, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
build-msvc
doc Expose flip operations from the display matrix Mar 7, 2019
etc Part 2 May 22, 2015
include
m4 autotools: Add back our custom check_zlib.m4 Apr 4, 2017
src track: Don't use OriginalPos for KeyFrame info May 24, 2019
test tests: Also tests frames against the FFMS_Frame keyframe info May 24, 2019
.gitattributes Add gitattributes Feb 11, 2015
.gitignore Add Unit Testing Oct 10, 2018
.gitmodules Add Unit Testing Oct 10, 2018
.travis.yml travis: Run unit tests on the CI Mar 19, 2019
COPYING Mention the LGPL too Jul 14, 2011
INSTALL Added an autogen.sh script Feb 7, 2010
Makefile.am test: Propagate errors Mar 19, 2019
README.md Remove more junk and update docs using delete key only Apr 2, 2017
autogen.sh autogen: Create dir for config.h.in Apr 4, 2017
configure.ac configure: Treat swresample as a normal FFMPEG_LIB Oct 12, 2018
ffms2.pc.in configure: Make swr a hard dep Oct 18, 2016
version.sh Use printf rather than echo -n for OS X compatiblity, as XSI echo has… Dec 26, 2011

README.md

Build Status

FFmpegSource (usually known as FFMS or FFMS2) is a cross-platform wrapper library around FFmpeg. It gives you an easy, convenient way to say "open and decompress this media file for me, I don't care how you do it" and get frame- and sample-accurate access (usually), without having to bother with the sometimes less than straightforward and less than perfectly documented FFmpeg API.

The library is written in C++, but the public API is pure C, so if you can link to a C library, you can use FFMS2. The source is available under the MIT license, but the license of the binaries depends on how FFmpeg was compiled. There are optional components that require a GPL FFmpeg, and if those are compiled in FFMS2 itself becomes covered by the GPL as well. The official Windows builds are GPLv3 for this reason.

For more information on using the library, see the API documentation and the changelog.

Avisynth and VapourSynth plugin

For the end user, the most visible use of FFMS is the implementation of both an Avisynth and a VapourSynth source plugin that uses the FFMS library to open media files. This plugin is a part of the FFMS2 project and is available for download here; for documentation see the Avisynth user guide.

Features

In addition to being able to open almost any common audio or video format, the Avisynth plugin has a number of more or less unique properties that other Avisynth source filters lack:

  • It is the only source filter that has support for Unicode filenames that are not representable in the system codepage.
  • It is the only source filter that has proper variable framerate (VFR) support.
  • It is the only general-purpose (i.e. not restricted to one or a few formats) source filter that will work reliably when running Avisynth under Wine.
  • It is the only general-purpose source filter that does not rely on external decoders.
  • It is (probably) the only source filter that supports mid-stream video resolution switches.

Versions and variants

If you're confused by all the different variants, here's a small explanation:

  • Vanilla (no suffix): standard 32-bit version. If you don't know what you want, you want this.
  • -x64: 64-bit version; mostly for use with 64-bit Avisynth.
  • -avs-cplugin: Variant of the Avisynth plugin written in C. Primary purpose is to get access to the new colorspaces available in Avisynth 2.6.
  • SDK: software developer's kit, for people who want to develop Windows applications that use FFMS2, using Microsoft Visual Studio 2008 or later.

Packages marked rNUMBER are testing builds made in-between releases. Download them if you need some bleeding-edge feature or just want to test out the upcoming version. Do note that they may be less stable than the official release versions.

Why is it called FFmpegSource, that makes no sense at all!?!

FFMS originated as an Avisynth file reader plugin, and those are traditionally called FooSource, where Foo usually is the method used to open the file. For historical reasons the entire project is still called FFmpegSource, although these days the name is pretty misleading and makes people think it has something to do with FFmpeg's source code or somesuch. To avoid confusion, it's probably better to refer to the library as FFMS (2, since version 1 was only an Avisynth plugin...) and keep the FFmpegSource name for the Avisynth plugin.

You can’t perform that action at this time.