[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:
parent
24aa48187e
commit
62ae0f5ef6
|
@ -0,0 +1 @@
|
||||||
|
../../DEPENDS.md
|
|
@ -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
|
||||||
|
|
Loading…
Reference in New Issue