Deluge

This article is part of the HOWTO series.

Installation • Kernel & Hardware • Networks • Portage • Software • System • X Server • Gaming • Non-x86 • Emulators • Misc

Deluge main screen

1 Introduction
2 Installation
3 Configuration
- 3.1 First Launch Configuration wizard
4 Automatic upgrades
5 See Also

Introduction

Deluge is a lightweight, free, cross-platform BitTorrent client. You can find out more at [| deluge-torrent.org].

Installation

The deluge package is net-p2p/deluge

Emerge with ask and verbose options to check out what dependencies are going to get pulled in and which use flags will be used.

emerge -av net-p2p/deluge

Currently the only use flag defined directly on the package is libnotify. If you're happy hit Y, if not hit N and go and make any changes you need to your use flags.

Once emerged you should be able to run deluge using the command Deluge. At the moment help appears limited - there's no man page and --help doesn't give much information.

Configuration

Deluge stores it's configuration in the ~/.config/deluge/ directory.

The first time you run deluge it *should* run the First Launch Configuration wizard

Note: If you get a D-Bus error message which includes the line "Failed to open "/var/lib/dbus/machine-id" " check that D-Bus is running. This should only be an issue if you are running on a remote machine that is not running X.

Note: If you get error messages such as

"The program 'deluge' received an X Window System error. This probably reflects a bug in the program. The error was 'BadAccess (attempt to access private resource denied)'."

just run deluge again - it should work the second time.

First Launch Configuration wizard

The First Launch Configuration wizard will run you through the basic configuration settings in 4 steps.

Step 1 - Intro

Step 2 - Listening Ports

Specify the port range for Deluge to listen on for incoming connections. You will need to ensure these ports are allowed through your firewall - TODO: find a good reference in the wiki of how to do this.

Step 3 - Where to save files

By default Deluge will set itself up to save files in the users home folder.

Step 4 - Bandwidth settings

Step 5 - Feedback

Automatic upgrades

Deluge includes an update checker. If a newer version of the application is detected you will see this message.

Note: I elected not to upgrade so I can't give any information on what happens if you say yes or how compatible the process is with Gentoo / Portage. When I've had more of a chance to play and am feeling brave I may give it a go. If you try it please add you experiences here.

Gentoo Wiki