deluge/docs/development/packaging/osx.md

Deluge.app for OSX

Manual Steps (Tested on Yosemite VM)

1. Install XCode
2. Jhbuild install and update Python:

wget https://git.gnome.org/browse/gtk-osx/plain/gtk-osx-build-setup.sh
sh gtk-osx-build-setup.sh
export PATH=~/.local/bin:~/gtk/inst/bin:$PATH
jhbuild build bootstrap
jhbuild build python

• Uncomment _gtk_osx_use_jhbuild_python = True in .jhbuildrc-custom.

1. GTK OSX Build:

jhbuild build meta-gtk-osx-bootstrap

1. PyGTK (Includes meta-gtk-osx-core)

   jhbuild build libglade
   jhbuild build meta-gtk-osx-python
   

* A [pygobject patch](https://git.gnome.org/browse/pygobject/commit/?h=pygobject-2-28&id=42d01f060c5d764baa881d13c103d68897163a49) to apply to fix annoying console warnings.
1. GTK OSX Themes:

jhbuild build meta-gtk-osx-themes jhbuild build gtk-quartz-engine

* *Note:* [Quartz patch](https://www.xpra.org/trac/attachmenthttps://dev.deluge-torrent.org/ticket/533/quartz-style-fix.patch) if build error: `'height' is uninitialized`.
1. [Bundler](https://wiki.gnome.org/Projects/GTK%2B/OSX/Bundling) for Packaging Deluge.

wget http://ftp.gnome.org/pub/gnome/sources/gtk-mac-bundler/0.7/gtk-mac-bundler-0.7.4.tar.xz tar xf gtk-mac-bundler-0.7.4.tar.xz cd gtk-mac-bundler-0.7.4 make install

1. Build libtorrent and deps using [libtorrent.modules](https://gist.github.com/cas--/d1df3758d6e794c0ca4e):

wget http://git.deluge-torrent.org/deluge/plain/osx/libtorrent.modules?h=1.3-stable jhbuild -m libtorrent.modules build meta_libtorrent

- OpenSSL requires "Skip Module (2)" when install stage fails as unable to use DESTDIR path. See [patch](https://github.com/elelay/gpodder-osx-bundle/blob/master/modulesets/patches/openssl-respect-destdir.patch).
- *Note on potential OpenSSL Error:* 'libcrypto is a fat file' is due to mixing arch types (i386, x64) in build process.
1. Install Deluge dependencies using [pip](https://pip.pypa.io/en/latest/installing/):

jhbuild shell wget https://bootstrap.pypa.io/get-pip.py python get-pip.py pip install twisted[tls] chardet mako pyxdg setproctitle pillow py2app cython pip install rencode pip install setuptools==19.2

- *Note1:* pygame for Notifications plugin need installed separately.
- *Note2:* rencode requires cython before attempting pip install. [(rencode issue)](https://github.com/aresch/rencode/issues/11)
- *Note3:* Due to bug in setuptools require version 19.2 [(setuptools issue)](https://github.com/pypa/setuptools/issues/517)
1. Install and package Deluge:
   a. If using release tarball download required `setup.cfg` and `osx` directory from git, run commands in deluge source directory:

wget --content-disposition http://git.deluge-torrent.org/deluge/plain/setup.cfg?h=1.3-stable wget -rnd -np -e robots=off --reject "index.html*" --content-disposition http://git.deluge-torrent.org/deluge/plain/osx/?h=1.3-stable -P osx

- *Note:* In setup.cfg need to remove 'dev' line and set arch to 'x86_64'.
a. Build and install Deluge using py2app:

jhbuild shell python setup.py py2app python setup.py install

* For error `dyld_find() got an unexpected keyword argument 'loader'` either uninstall `pillow` or [patch MachOGraph.py](https://bitbucket.org/ronaldoussoren/macholib/pull-requests/10/)
a. Package Deluge into app in `osx/app/` using gtk-mac-bundler script:

jhbuild shell cd osx ./make-app

* Fix for pango_module_version error [on github](https://github.com/jralls/gtk-mac-bundler/commit/5a348d5a9405c958ee0e85fb0af58a8dc0dd999c)
1. Optionally create dmg image:

hdiutil create -format UDBZ -srcfolder Deluge.app -volname deluge-1.3.13-osx-x64-0 deluge-1.3.13-osx-x64-0.dmg

## Old Semi-Automated Guide