Preparing on macOS¶

Software requirements¶

The demo application uses the open-source GStreamer software. One way to install this on MacOS is using HomeBrew, which has to be installed first if it is not yet installed. For installation instruction for HomeBrew, see their own website or alternatively run this one-liner directly in a terminal:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Once HomeBrew is installed, from the terminal, run the following command to install the base GStreamer software as well as all the plugin sets: good, bad, and ugly:

brew install gstreamer gst-plugins-base gst-plugins-good \
  gst-plugins-bad gst-plugins-ugly

In some cases GStreamer won't be able to find the plugins. In that case you'll have to specify GST_PLUGIN_SYSTEM_PATH manually such that GStreamer can find them. This is dependent on where HomeBrew has installed them. In a typical set-up the following would be sufficient:

export GST_PLUGIN_SYSTEM_PATH="/usr/local/opt/gst-plugins-good/lib/gstreamer-1.0/:/usr/local/opt/gst-plugins-bad/lib/gstreamer-1.0/:/usr/local/opt/gst-plugins-ugly/lib/gstreamer-1.0/:/usr/local/opt/gst-plugins-base/lib/gstreamer-1.0/:/usr/local/opt/gstreamer/lib/"