Building MyPaint on OS X
========================

**IN PROGRESS**: [Please help us improve this section](https://github.com/mypaint/mypaint/issues/49).
The wiki's OS X notes are somewhat outdated
and could do with improving too,
but have possibly interesting notes about Quartz vs X11 builds:
http://wiki.mypaint.info/Development/Packaging#OSX. Feedback welcome.

Most users will want to grab `MyPaint-devel`
[from macports](https://www.macports.org/ports.php?by=name&substr=mypaint)
or stick with the stable `MyPaint` portfile already there.

For the adventurous,the following is reported to work on OS X 10.9:

* **Environment setup**: to use Frameworks Python (currently 2.7.8)
  while satisfying the other dependencies from Macports, use

  ```sh
  export PKG_CONFIG_PATH=/opt/local/Library/Frameworks/Python.framework/Versions/2.7/lib/pkgconfig/
  export CFLAGS="-I/opt/local/include"
  ```

* **Install dependencies**:

  ```sh
  sudo port install gtk3
  sudo port install json-c
  sudo port install py27-numpy
  sudo port install py27-scipy
  sudo port install lcms2
  sudo port install py27-gobject3
  sudo port install hicolor-icon-theme
  ```

* **Fetch source** and **update submodules** just as for Linux:

  ```sh
  git clone https://github.com/mypaint/mypaint.git
  cd mypaint
  git submodule update --init --force
  ```

* **Build and test**.
  The `sudo -E` should not be necessary - let us know if it isn't,
  or if it's unhelpful when running the build in test mode.

  ```sh
  sudo -E scons
  ./mypaint -c /tmp/mypaint_cfgtmp_$$
  ```
