[Docs] Update install guide

Rewrite install instructions to include more details on Deluge 2.0
install.

* Added other Linux distros
* Added stable PPA details
* Added link to forum for Windows and macOS community packages

Co-authored-by: Sergio M <sergio@example.com>
Co-authored-by: Ofry Linkovsky <15746116+OfryL@users.noreply.github.com>
Closes: deluge-torrent/deluge#296
Closes: deluge-torrent/deluge#310
This commit is contained in:
Calum Lind 2021-12-12 18:25:32 +00:00
parent 24aa48187e
commit 62ae0f5ef6
2 changed files with 106 additions and 26 deletions

1
docs/source/depends.md Symbolic link
View File

@ -0,0 +1 @@
../../DEPENDS.md

View File

@ -1,59 +1,138 @@
# Installing Deluge # Installing Deluge
These are the instructions for installing Deluge. Consider them a work-in-progress and Instructions for installing Deluge.
feel free to make suggestions for improvement.
## <i class="icon-ubuntu"></i> Ubuntu ## <i class="fa fa-linux"></i> Linux
### PPA ### <i class="icon-ubuntu"></i> Ubuntu
Until the stable PPA is updated, the development version of Deluge can be used: One-click [**APT Install**](https://tinyurl.com/installdeluge)
sudo add-apt-repository -u ppa:deluge-team/stable ```
sudo apt install deluge sudo apt install deluge
```
### <i class="icon-python"></i> PyPi [Package Details](https://packages.ubuntu.com/deluge)
To install from Python PyPi, Deluge requires the following system installed packages: ### <i class="icon-fedora"></i> Fedora
sudo apt install python3-pip python3-libtorrent python3-gi python3-gi-cairo gir1.2-gtk-3.0 gir1.2-appindicator3 ```
sudo dnf install deluge
```
[Package Details](https://src.fedoraproject.org/rpms/deluge)
### <i class="icon-archlinux"></i> Arch
```
pacman -S deluge-gtk
```
[Arch Wiki](https://wiki.archlinux.org/title/Deluge)
### <i class="icon-suse"></i> OpenSUSE
[**1 Click Install**](http://packman.links2linux.org/install/deluge)
[Package Details](https://software.opensuse.org/package/deluge)
### <i class="icon-gentoo"></i> Gentoo
[Package Details](https://packages.gentoo.org/packages/net-p2p/deluge)
## <i class="fa fa-windows"></i> Windows
Unfortunately no official installer package currently available.
See [Alternative Installs](#alternative-installs)
## <i class="fa fa-apple"></i> macOS
Unfortunately no official installer package currently available.
See [Alternative Installs](#alternative-installs)
## <i class="icon-freebsd"></i> FreeBSD
```
pkg add deluge
```
[Package details](https://www.freshports.org/net-p2p/deluge/)
## <i class="icon-python"></i> PyPi
Install with pip: Install with pip:
pip install deluge pip install deluge
Install with all optional dependencies: Install with all [optional dependencies][depends]:
pip install deluge[all] pip install deluge[all]
## <i class="fa fa-windows"></i> Windows Will require system installed packages such as libtorent and GTK3. See [DEPENDS]
Unfortunately due to move to GTK3 and Python 3 there is no installer package currently e.g. on Ubuntu/Debian install these packages:
available for Windows.
Intrepid users can install Deluge from separate packages as detailed in [issue #3201]. sudo apt install python3-pip python3-libtorrent python3-gi python3-gi-cairo gir1.2-gtk-3.0 gir1.2-appindicator3
## <i class="fa fa-apple"></i> macOS ## Alternative Installs
There is no `.app` package currently for macOS, but can try Deluge with [Homebrew]. ### Ubuntu PPA
The [stable PPA] contains the latest releases.
sudo add-apt-repository -u ppa:deluge-team/stable
sudo apt install deluge
The [development PPA] contains daily builds from the `develop` branch.
sudo add-apt-repository -u ppa:deluge-team/develop
sudo apt install deluge
### Windows Community
Due to move to GTK3 and Python 3 and problems with pyinstaller there are only community
created installers available.
Check sticky topics in [Windows Forum] for latest updates.
For reference [issue #3201] is tracking progress on an official installer.
### macOS Community
#### Unofficial `.app` packages
Check sticky topics in [MacOS Forum]
#### Macports
```
sudo port install deluge
```
[Package Details](https://ports.macports.org/port/deluge/)
#### Homebrew
1. Install [Homebrew] 1. Install [Homebrew]
2. Open a terminal. 1. Open a terminal to install required packages:
3. Run the following to install required packages:
brew install pygobject3 gtk+3 adwaita-icon-theme brew install pygobject3 gtk+3 adwaita-icon-theme
brew install libtorrent-rasterbar brew install libtorrent-rasterbar
4. To fix translations: 1. To fix translations:
brew link gettext --force brew link gettext --force
5. Install Deluge: 1. Install Deluge:
pip3 install deluge pip install deluge
[develop ppa]: https://launchpad.net/~deluge-team/+archive/ubuntu/develop/ [development ppa]: https://launchpad.net/~deluge-team/+archive/ubuntu/develop/
[stable ppa]: https://launchpad.net/~deluge-team/+archive/ubuntu/stable/
[homebrew]: https://brew.sh/ [homebrew]: https://brew.sh/
[python 3.6]: https://www.python.org/downloads/release/python-368/ [issue #3201]: https://dev.deluge-torrent.org/ticket/3201
[gvsbuild]: https://ci.appveyor.com/api/buildjobs/b0y2sttcq3t1071q/artifacts/gvsbuild-vs14-x64.tar.gz [windows forum]: https://forum.deluge-torrent.org/viewforum.php?f=12
[issue #3201]: https://dev.deluge-torrent.org/ticket/3201#comment:9 [macos forum]: https://forum.deluge-torrent.org/viewforum.php?f=13
[depends]: ../depends.md