how_to_build_macosx.md

Setting Up the Development Environment on MacOSX

Necessary Software

• git
• brew
• Xcode
• cmake
  • Version 3.2.2 confirmed to work.
• Qt
  • http://download.qt.io/official_releases/qt/5.9/5.9.2/
    • qt-opensource-mac-x64-5.9.2.dmg
• boost
  • http://www.boost.org/users/history/version_1_55_0.html (or later, though only 1.55.0 is supported)

Building on MacOSX

0. Install Qt 5.9 (Most recent is 5.9.2)

1. Install Dependent Packages

With homebrew, you can install them with following command.

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

Or, you should build and install them manually.

2. Clone the Repository

$ git clone https://github.com/opentoonz/opentoonz
cd opentoonz
git lfs pull

(Optional) Create the stuff Directory

If the directory /Applications/OpenToonz/OpenToonz_stuff does not exist, enter the following command:

$ sudo cp -r stuff /Applications/OpenToonz/OpenToonz_stuff

3. Build tiff in thirdparty

$ cd thirdparty/tiff-4.0.3
$ ./configure && make

4. Put Boost library into thirdpaty directory

The following assumes boost_1_55_0.tar.bz2 was downloaded to ~/Downloads.

$ cd ../boost
$ mv ~/Downloads/boost_1_55_0.tar.bz2 .
$ tar xjvf boost_1_55_0.tar.bz2

5. Update the path to your Qt 5.9 install in opentoonz/toonz/sources/CMakeLists.txt line 160 or 172

If using Qt 5.9.2, this is unnecessary.

6. Copy the lzo header folder to the lzo driver directory

$ cd ../lzo
$ cp -r 2.03/include/lzo driver

6. Build Everything Together

$ cd ../../toonz
$ mkdir build
$ cd build
  CMAKE_PREFIX_PATH=~/Qt5.9.2/5.9.2/clang_64 cmake ../sources
$ make

Please be patient as the install will take a while.

After Building

$ open ./toonz/OpenToonz.app