2024-07-06 19:50:35 +01:00

95 lines
3.7 KiB
Markdown

# 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](https://wiki.gnome.org/Projects/GTK+/OSX/Building):
```
jhbuild build meta-gtk-osx-bootstrap
```
1. [PyGTK](https://wiki.gnome.org/Projects/GTK+/OSX/Python) (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/attachment/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