Skip to content

Installing Deluge From Source

This is build manual for Deluge 1.3.x. Build manual for 2.0.x version is here: https://deluge.readthedocs.io/en/latest/devguide/tutorials/01-setup.html

Dependencies

Deluge has a number of dependencies that are required for it to run properly. Most of them are runtime only deps, but a few are required for successfully building Deluge.

The 1.3.x dependencies are listed below. You will also need to install the appropriate build tools provided by your OS.

Debian & Ubuntu Dependencies

Apt-get line to install all above dependencies:

sudo apt-get install python python-twisted python-openssl python-setuptools intltool python-xdg python-chardet geoip-database python-libtorrent python-notify python-pygame python-glade2 librsvg2-common xdg-utils python-mako

Windows Dependencies

Python dependencies should be py2.7 and win32 (32-bit)''

After Python is installed, use pip to install the following from console:

pip install twisted[tls] chardet mako pyxdg pillow slimit pypiwin32 pygame certifi

libtorrent (rasterbar)

For those advanced cases where you need to build and install libtorrent from source, follow this guide: [Building/libtorrent]/development/building/libtorrent.md)

Download Source

You can either get the source from a tarball on our ftp or from our [GitRepo]/development/git/gitrepo.md).

Building and Installing

Extract the source tarball and in the extracted folder run the build command:

python setup.py build

Install the package to your system:

sudo python setup.py install
  • Debian & Ubuntu: Append --install-layout=deb to use /usr/bin/ prefix instead of Debian default /usr/bin/local/.
  • Microsoft Windows: Omit sudo prefix.

For Linux Desktop systems an extra step is required due to an installer bug not copying data files, such as deluge.desktop:

sudo python setup.py install_data

If you have run the build before, ensure you have a clean build environment:

python setup.py clean -a

Developer Install

Installing Deluge with develop mode creates binaries that link back to source code. Therefore changes will be reflected immediately with no need to repeatedly install.

python setup.py develop

If you wish to use a specific development directory, the following will create a Deluge install in ~/delugeDev:

export PYTHONPATH=${HOME}/delugeDev
python setup.py develop --install-dir ~/delugeDev

Do have the included plugins available, build them with

python setup.py build_plugins develop

Another alternative for a separate Deluge development environment is to use Python Virtualenv

Removing From System

In the unlikely event you want to remove Deluge installed by the previous method, you will have to manually delete the Deluge related files on your system. The main files are normally installed in one of the following places:

/usr/lib/python2.x/site-packages
/usr/local/lib/python2.x/site-packages
/usr/lib/python2.x/dist-packages
/usr/local/lib/python2.x/dist-packages

Example:

sudo rm -r /usr/lib/python2.7/dist-packages/deluge*

To find and remove the remaining files use the locate command and to ensure up-to date information also run updatedb:

sudo updatedb
locate deluge