This is a 3^rd party tap for Homebrew. It provides a formula for ffmpeg which includes options for enabling additional features and libraries.

Contents:

• Installation and usage
  • Installing with options
  • Installing latest Git version (HEAD)
• Updating
• Included libraries
• Troubleshooting
• Issues
• Maintainers

In order to use this tap, you need to install Homebrew.

Then, to run a default installation, run:

brew tap homebrew-ffmpeg/ffmpeg
brew install homebrew-ffmpeg/ffmpeg/ffmpeg

Note: If you already have ffmpeg installed from Homebrew core, you will receive an error. You need to first run brew uninstall ffmpeg before you can use this tap.

To see the list of supported options for this formula, run:

brew options homebrew-ffmpeg/ffmpeg/ffmpeg

Then, you can run:

brew install homebrew-ffmpeg/ffmpeg/ffmpeg --with-<option1> --with-<option2> ...

If you really wish to install all the available options, you can run:

brew install homebrew-ffmpeg/ffmpeg/ffmpeg $(brew options homebrew-ffmpeg/ffmpeg/ffmpeg --compact)

Note that this may install libraries for which you need extra SDKs installed, such as --with-decklink, or libraries which have to be installed before running the formula, such as --with-chromaprint.

FFmpeg recommends installing the latest Git master version over a release. This formula builds the latest release by default, but you can install the latest Git version by adding the --HEAD option:

brew install homebrew-ffmpeg/ffmpeg/ffmpeg --HEAD

Please note that we don't generally provide support HEAD builds, since they may cause issues with other Homebrew-supplied formulae.

To update Homebrew and upgrade the formula to the most recent stable release:

brew update && brew upgrade homebrew-ffmpeg/ffmpeg/ffmpeg

Or, if you are using the HEAD version and want to update to the latest commit:

brew update && brew upgrade homebrew-ffmpeg/ffmpeg/ffmpeg --fetch-HEAD

This formula installs the following libraries by default:

This formula features the following libraries optionally:

In general, please note that we only provide support for current macOS versions that still receive security updates. Beta or pre-release versions as well as legacy versions are not supported.

When installing a piece of SOFTWARE which is using this FFmpeg distribution, then you may get the following error:

==> Installing dependencies for SOFTWARE: ffmpeg
Error: ffmpeg is already installed from homebrew-ffmpeg/ffmpeg!
Please `brew uninstall ffmpeg` first."

Here is a workaround:

brew uninstall ffmpeg
brew install SOFTWARE
brew uninstall --ignore-dependencies ffmpeg
brew install homebrew-ffmpeg/ffmpeg/ffmpeg --with-YOUR-OPTIONS

To report issues, please file an issue on GitHub. Please include the full command line you have tested and the full terminal output you got with. Please note that we will only be able to help with issues that are exclusive to this tap and for OS which are officially supported.

If the problem is reproducible with the homebrew-core version of ffmpeg, please file it on their tracker.

• Reto Kromer (@retokromer)
• Werner Robitza (@slhck)