3.8 KiB
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)''
- Python 2.7 (Select
Add python.exe to path
when Installing) - python-libtorrent
- openssl-1.0.*-i386-win32 (
copy to system32
) - PyGTK All-in-one
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