Getting Started with Spinnaker SDK on MacOS
All FLIR machine vision USB3 and GigE cameras
Application note description
This application note describes how to install and use the Spinnaker® SDK in MacOS from High Sierra (10.13.0) to Catalina (10.15.0).
Spinnaker is not supported on M1 or M2 processors, meaning newer Mac OS Versions which only run on M1 or M2 processors will not work with Spinnaker.
Install the required libraries
You must install some dependencies before installing Spinnaker for MacOS. These dependencies are available through a package manager called Homebrew. Homebrew is not available by default in MacOS so you may have to install it first.
To install the dependencies:
- If Homebrew is not already installed, in terminal run the following:
user$: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
If prompted, enter your password.
- Wait until you see "Next Steps". Homebrew is now installed.
- In terminal run the following:
user$: brew install pkg-config email@example.com libomp libusb
This installs all the required dependencies.
If you already have a different version of Spinnaker installed on your macOS, you need to uninstall this prior to installing the new version. See Uninstall Spinnaker below.
- Download the Spinnaker SDK from our website at:
- In the download folder for Spinnaker-1.xx.x.xx, double-click the Spinnaker.pkg file to launch the installer.
- Follow the install wizard.
The installation generates the following directory structures:
In addition, Spinnaker libraries are copied to /usr/local/lib and Spinnaker headers are copies to /usr/include for system-wide reference.
The Spinnaker SDK comes with several precompiled C++ examples. These are found in /Applications/Spinnaker/bin. You can run an example by double-clicking on the file in the bin folder or through a command line as sudo.
The source for the examples is found in /Applications/Spinnaker/src/.
To modify an example:
- Copy the /Spinnaker/ folder (and subfolders) from the /Applications/ folder to a location where you have write permissions.
- With a text editor, edit the source file in the /src/ folder.
- Compile the updated file.
- Run the updated example from the /bin/ folder.
SpinView is a GUI application that you can use to stream, save, or record images. You can also access or modify Spinnaker nodes to control the camera settings.
For a detailed explanation of Spinnaker nodes, see Spinnaker Nodes.
To run SpinView, from the /Applications/Spinnaker/apps folder double-click SpinView_QT.
SpinView_QT is packaged as an .app file. It is self-contained and can be moved anywhere on the system and still function normally.
PySpin is a wrapper for the Spinnaker library to allow you to code your application in python. Detailed installation instructions are in the README file. You can find this file after you double click on one of the PySpin installation files located at /Applications/Spinnaker/PySpin.
Choose the package that corresponds to your python version and Spinnaker version. For example, spinnaker_python-18.104.22.168-cp37-cp37m-macosx_10_9_x86_64.tar.gz represents PySpin version 22.214.171.124 and it is for python version 3.7.
Ensure that Python and the corresponding version of the Spinnaker SDK is installed before installing PySpin.
To uninstall Spinnaker, run the supplied “uninstall_spinnaker.sh” included in the Spinnaker-1.xx.x.xx.dmg file. This script removes all installed Spinnaker files and removes Spinnaker from your Mac’s list of installed applications.