Building
Questions on building Deluge from source
Deluge Specific
Questions about the day to day use of Deluge
- Is Deluge Free? Can I get the source?
- I upgraded from 0.5 and plugin x is missing
- I can't connect to the daemon from another machine?
- The files tab shows a different percentage-completed than the torrent??
- Deluge sometimes creates files that I didn't ask it to download. Why?
- Deluge deleted my non-official plugin! Why? What's the proper way to install a plugin?
- Deluge won't start with a “gobject.GError: Unrecognised image file format” error.
- Can Deluge use blocklists such as SafePeer or PeerGuardian?
- Does Deluge have an embedded tracker?
- Does Deluge support “Super-Seed” or “Initial-Seed”?
- How do I set Deluge as my default BitTorrent program?
- Parts of the WebUI don't work. Why?
- Seeding torrents have no queue position! Why?
- Does Deluge support daemon mode, with no GUI?
- Does Deluge have a Web UI?
- Does Deluge support multi-tracker torrents?
- Does Deluge support DHT or Peer Exchange?
- Does Deluge support Protocol Encryption (PE)?
- What is the difference between full allocation and compact allocation?
Generic BitTorrent
Questions about BitTorrent in general
Building
You must remove all copies of Deluge before installing from SVN. Installing a SVN copy on a box which already has Deluge installed by some other means will cause things to break.
First you need to install the necessary dependencies. In Ubuntu and Debian, do this:
$ sudo apt-get install g++ make python-all-dev python-all python-dbus python-gtk2 python-notify python-setuptools librsvg2-common python-xdg python-support subversion libboost-dev libboost-python-dev libboost-iostreams-dev libboost-thread-dev libboost-date-time-dev libboost-filesystem-dev libboost-serialization-dev libssl-dev zlib1g-dev
Next you need to get the latest revision from SVN and build/install it:
$ svn co http://svn.deluge-torrent.org/trunk deluge
$ cd deluge
$ python setup.py build
$ sudo python setup.py install
If you have already checked the source out and simply want to update your current tree, then do the following in the deluge directory:
$ svn up
Deluge Specific
Yes, Deluge is Free Software, as defined by the Free Software Foundation, and is released under the GPL, giving our users complete freedom. The source code is available on the download section of our site. Our GPL nature allows you to be 100% sure that our program will never “spy” on your activities. Closed-source BitTorrent clients cannot make that same claim.
1.0 is a rewrite, all old 0.5 plugins have to be rewritten.
- Configure the daemon to allow remote connections
- Restart the daemon.
The files tab will only show percentages based on completed pieces while the main view will show total completed including incomplete pieces.
Unofficial plugins (those not included with Deluge), should be installed in the configuration folder. On Linux/Unix, to do this, simply copy the plugin folder to ~/.config/deluge/plugins/ ...on Windows, this is the C:\Documents and Settings\[User Name]\Deluge\plugins folder.
You need to install SVG support. On Debian/Ubuntu, the package is librsvg2-common
Deluge handles files as pieces, not as individual files. This gets tricky, as sometimes the same piece is shared between multiple files. So if you tell Deluge to download a file, it'll download all of the pieces within that file, and if one of those pieces is shared with another file, that file will also be created, although not necessarilly entirely downloaded.
Yes. Enable the “Blocklist” plugin. Currently this plugin can handle PeerGuardian (binary and text), SafePeer and Emule lists. PeerGuardian *7zip format files are not supported*. Generally PeerGuardian files come in 7zip format, so you'll need to extract them first and then feed Deluge the plain text file. Files may be specified as URLs or locations on the local filesystem. Here are some suggested blocklists:
1. http://www.bluetack.co.uk/config/nipfilter.dat.gz (Emule)
2. http://peerguardian.sourceforge.net/lists (PeerGuardian text)
3. http://www.bluetack.co.uk/config/splist.zip (SafePeer)
No and it probably never will. We want to be the best BitTorrent client around, and to do that we need to focus on just being a client.
No.
On Windows, the installer will ask you if you want Deluge to be your default BitTorrent program. On Linux/Unix (GNOME), right-click on a torrent file, click on properties, click on the "open with" tab. Is deluge listed there? If so, select it to be your default, if not, click on "add", then click on "use custom command". Insert /usr/bin/deluge and click add.
You need to use Mozilla Firefox or another Gecko browser for the WebUI.
Seeds use something called "seed rank" to determine which should be active and which should be queued. The seed rank is determined by the number of seed cycles a torrent has completed. Torrents with fewer completed seed cycles are prioritized for seeding. A seed cycle is completed when a torrent meets either the share ratio limit (uploaded bytes / downloaded bytes), the share time ratio (time seeding / time downloading) or seed time limit (time seeded).
Yes. You start the daemon with `deluged`. Deluge has multiple user interfaces.
To start the GTK interface: `deluge --ui gtk`
To start the null (console) interface: `deluge --ui null`
To start the Web interface: `deluge --ui web`
Yes. See above.
Yes it does. Also, you can edit the trackers associated with a torrent by right-clicking on a torrent within Deluge, and clicking on “Edit Trackers.”
Yes, we support both. Go into Preferences and in the Network tab, enable “Peer Exchange” and “DHT”
Yes. Go into Preferences and set the proper settings in the Network tab.
* Forced - Only encrypted connections are allowed. Incoming connections that are not encrypted are closed and if the encrypted outgoing connection fails, a non-encrypted retry will not be made.
* Enabled - encrypted connections are enabled, but non-encrypted connections are allowed. An incoming non-encrypted connection will be accepted, and if an outgoing encrypted connection fails, a non- encrypted connection will be tried.
* Disabled - only non-encrypted connections are allowed.
* Handshake - only the handshake is encrypted, the bulk of the traffic remains unchanged.
* Full stream - the entire stream is encrypted with RC4
* Either - both RC4 and plaintext connections are allowed.
* Prefer to encrypt the entire stream means you want to prefer the RC4 encrypted stream.
Right-click on the tray icon and select “Pause All.”
Compact allocation only allocates as much storage as it needs to keep the pieces downloaded so far. This means that pieces will be moved around to be placed at their final position in the files while downloading (to make sure the completed download has all its pieces in the correct place). In full allocation, the entire space that a file needs is allocated as soon as one piece of that file is downloaded, thus decreasing fragmentation. We suggest that our users use full allocation.
Generic BitTorrent
The official ports for BitTorrent are 6881-6889, but most ISPs block or at least throttle those ports, so users are encouraged to use a port range of something between 49152 and 65535.