Setting Up the Development Environment on MacOSX

Necessary Software

• git
• brew
• Xcode
• cmake (3.2.2 or later)
• Qt (5.9.2 or later)
• boost (1.55.0 or later)

Building on MacOSX

Download boost from https://boost.org

Download the .bz2 mac (unix if mac not specified) version 1_55_0 or later (last tested with 1_69_0)

Save for later step.

Download and install XCode from Apple

When downloading XCode, you should use the appropriate version for your OS version. You can refer to the Version Comparison Table on https://en.wikipedia.org/wiki/Xcode to find out which version you should use.

Apple store usually provides for the most recent macOS version. For older versions, you will need to go to the Apple Developer site.

Install Homebrew from https://brew.sh

Check site for any changes in installation instructions, but they will probably just be this:

1. Open a Terminal window
2. Execute the following statement:

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

Install required software using brew

In a Terminal window, execute the following statements:

$ brew install glew lz4 libjpeg libpng lzo pkg-config libusb cmake git-lfs libmypaint qt
$ git lfs install

NOTE: This will install the latest version of QT which may not be compatible with older OS versions.

If you cannot use the most recent version, download the online installer from https://www.qt.io/download and install the appropriate version (min 5.9.2). If installing via this method, be sure to install the depricated QT Script libraries.

Set up OpenToonz repository

These steps will put the OpenToonz repository under /Users/yourlogin/Documents.

$ cd ~/Documents   #or where you want to store the repository#
$ git clone https://github.com/opentoonz/opentoonz
$ cd opentoonz
$ git lfs pull
$ cd thirdparty/boost
$ mv ~/Downloads/boost_1_69_0.tar.bz2   #or whatever the boost filename you downloaded is#
$ tar xvjf boost_1_69_0.tar.bz2 .
$ cd ../lzo
$ cp -r 2.03/include/lzo driver
$ cd ../tiff-4.0.3
$ ./configure && make

Configure build for QT version

Edit the /Users/yourlogin/Documents/opentoonz/toonz/sources/CMakeLists.txt file at line 160 (64bit OS) or 172 (32bit OS) and modify the root path for the QT lib directory

If you installed QT using brew , you can get the version and path to use with: $ brew info qt. The entry will look something like this: /usr/local/Cellar/qt/5.12.2/lib

Configure environment and Build OpenToonz

1. Create the build directory with the following:

$ cd ~/Documents/opentoonz/toonz
$ mkdir build
$ cd build

1. Set up build environment

To build from command line, do the following:

$ CMAKE_PREFIX_PATH=/usr/local/Cellar/qt/5.12.2 cmake ../sources  #replace QT path with your installed QT version#
$ make

To build using XCode, do the following:

$ sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
$ CMAKE_PREFIX_PATH=/usr/local/Cellar/qt/5.12.2 cmake -G Xcode ../sources -B.  #replace QT path with your installed QT version#

• Open Xcode app and open project /Users/yourlogin/Documents/opentoonz/toonz/build/OpenToonz.xcodeproj
• Change ALL_BUILD to OpenToonz

• Start build with: Product -> Build

  • NOTE about rebuilding in Xcode: The initial build should succeed without any errors. There after, the build will succeed but the following 3 errors can be ignored:

/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/install_name_tool: for: /Users/yourlogin/Documents/opentoonz/toonz/build/toonz/Debug/OpenToonz.app/Contents/MacOS/OpenToonz (for architecture x86_64) option "-add_rpath @executable_path/." would duplicate path, file already has LC_RPATH for: @executable_path/.
/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/install_name_tool: for: /Users/yourlogin/Documents/opentoonz/toonz/build/toonz/Debug/OpenToonz.app/Contents/MacOS/OpenToonz (for architecture x86_64) option "-add_rpath /usr/local/Cellar/qt/5.12.2/lib/" would duplicate path, file already has LC_RPATH for: /usr/local/Cellar/qt/5.12.2/lib/
Command /bin/sh emitted errors but did not return a nonzero exit code to indicate failure

Create the stuff Directory

If you have installed OpenToonz on the machine already, you can skip this. Otherwise, you need to create the stuff folder with the following:

$ cd ~/Documents/opentoonz
$ sudo mkdir /Applications/OpenToonz
$ sudo cp -r stuff /Applications/OpenToonz/OpenToonz_stuff
$ sudo chmod -R 777 /Applications/OpenToonz

Running the build

• If built using via command line, run the following:

$ open ~/Documents/opentoonz/build/toonz/OpenToonz.app

• If built using Xcode, do the following:

  • Open Scheme editor for OpenToonz: Product -> Scheme -> Edit Scheme
  • Uncheck: Run -> Options -> Document Version

  • Run in Debug mode: Product -> Run

  • To open with command line or from Finder window, the application is found in /Users/yourlogin/Documents/opentoonz/toonz/build/Debug/OpenToonz.app