Installation for the Apple users

Installing the software with Homebrew

Xcode

Install the command line tool for Xcode by pasting the following command at a Terminal prompt (the Terminal is usually found in the /Applications/Utilities folder):

 

xcode-select --install

Homebrew

Then install Homebrew, a package manger for macOS. You may think of it as an «app store» for open-source software. You can install Homebrew by pasting the following command:

 

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

 

After successful installation you should execute:

 

brew doctor

 

Detailed instructions for Homebrew are posted at:
https://github.com/Homebrew/brew/blob/master/docs/README.md

FFmpeg

Once Homebrew is installed, for our purpose, we recommend building FFmpeg with the command:1

 

brew install ffmpeg --with-freetype --with-openjpeg --with-rubberband --with-tesseract

Testing your installation

Once you followed the installation above, you should have ffmpeg, ffplay and ffprobe installed.

ffmpeg

Test ffmpeg by pasting into the Terminal the line:

 

ffmpeg -f lavfi -i mandelbrot -t 10 -pix_fmt yuv420p ~/Desktop/mandelbrot.mov

 

This should produce on your Desktop a file of the Mandelbrot pattern.

ffplay

Test ffplay by pasting into the Terminal the line:

 

ffplay ~/Desktop/mandelbrot.mov

 

This should play the Mandelbrot file.

ffprobe

Test ffprobe by pasting into the Terminal the line:

 

ffprobe -show_format -show_streams -print_format json ~/Desktop/mandelbrot.mov

 

This should display the Mandelbrot file’s technical metadata.

Installing the software from a build

Please follow the instructions given at: ffmpeg.org/download.html

For the macOS 10.6 to 10.10 users

You may possibly paste the following command at a Terminal prompt (the Terminal is usually found in the /Applications/Utilities folder):

 

sudo mv -iv ~/Downloads/ff* /usr/local/bin

 

This command works only if the downloaded and unzipped folder is in the ~/Downloads folder, otherwise you must modify the path (e.g. by drag-and-dropping the files into the Terminal window).

For the macOS 10.11 to 10.13 users

Sadly, Apple introduced an additional complication with the System Integrity Protection. Before you can move the build, you need to deactivate this:

  • boot into Recovery Mode: hold down command + R on reboot
  • paste the following command at a Terminal prompt (the Terminal is usually found in the /Applications/Utilities folder):
    csrutil disable
  • reboot

Now you can follow the instructions given above for the macOS 10.6 to 10.10 users. Once the installation is completed, we advise to set the System Integrity Protection back again to its original state:

  • boot into Recovery Mode: hold down command + R on reboot
  • paste the following command at a Terminal prompt:
    csrutil enable
  • reboot

Note

1
The recommended parameters are:
--with-freetype
Enables FreeType support, e.g. for adding titles.
--with-openjpeg
Enables JPEG 2000 encoding and decoding.
--with-rubberband
Enables the Rubberband audio filter, which allows time-stretching and pitch-shifting.
--with-tesseract
Enables the Tesseract filter for optical character recognition, e.g. for extracting inter-titles or subtitles.

2018–12–04