= Installing Deluge on Mac OSX = == Deluge.app == A [http://forum.deluge-torrent.org/viewtopic.php?f=13&t=39737 Deluge.app] package is now available for [https://github.com/vguerci/Deluge.app/downloads download] ---- == !MacPorts == This works on OSX Lion 10.7 with Deluge 1.3.3 and also works on previous versions (Snow Leopard 10.6.x / Deluge 1.3.x) These instructions assume a clean install of OSX (no XQuartz, Darwine, Winebottler, or !MacPorts / Fink installed). This methodology is time consuming, but is less error-prone for the uninitiated. It is going to take a few hours normally to download and compile and also several gigabytes of storage will be used. === Prerequisites === Download and install: * Xcode from App Store * [http://www.macports.org MacPorts] ''(v2.0.3 as of writing)'' === Installation === There are two interface options when installing Deluge, one is to use '''X11''', the other '''Quartz-GTK'''. `X11` is the ''classic'' Linux interface, while `Quartz-GTK` uses the native OSX interface. The `Quartz-GTK` is faster and looks better but is a bit more error prone, so it is up to you. Open Terminal (under Utilities) and all the following steps will be done from here. ==== X11 Interface ==== {{{ #!sh sudo port install boost +python27 deluge }}} ''(boost library must be installed with +python27 or macports will complain later when building deluge)'' ==== Quartz-GTK Interface ==== {{{ #!sh sudo port install boost +python27 +no_x11 +quartz gtk2 deluge }}} or if that doesn't work: {{{ #!sh sudo port install boost +python27 +no_x11 +quartz gtk2 pango cairo deluge }}} === Start Deluge === 1. Open Terminal, assuming port is in your path (/opt/local/bin) 1. Start deluged daemon: {{{ #!sh deluged-2.7 & }}} 1. Start deluge interface: {{{ #!sh deluge-2.7 & }}} === Optional Steps === ==== GTK Engines ==== To get a better looking interface, you can install gtk-engines2 (or others [http://www.macports.org/ports.php?by=name&substr=engine GTK engines]) : {{{ #!sh sudo port install gtk-engines2 }}} Then set you preferred engine (clearlooks in this case, which is nice) {{{ #!sh echo 'gtk-theme-name = "Clearlooks"' | sudo tee /opt/local/etc/gtk-2.0/gtkrc }}} ==== Language ==== If you prefer english version (or any other language) you can launch deluge using the following: {{{ #!sh export LANG=en_US && deluge-gtk-2.7 & }}} Or alternatively, you can use an alias (in your bash profile, zshrc...) {{{ #!sh alias deluge='export LANG=en_US && deluge-gtk-2.7 &' }}} === More === More details / help available on forums! in [http://forum.deluge-torrent.org/viewforum.php?f=13 OSX Section] and also in [http://forum.deluge-torrent.org/viewtopic.php?f=13&t=34649 this thread] which initiated that wiki page.