tahoma2d/doc/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
```