Version 55 (modified by mvoncken, 15 years ago) (diff)

--

Deluge 1.0 FAQ

  1. General
    1. Is Deluge Free? Can I get the source?
    2. How to start the various user-interfaces
    3. How do I restore all settings to default?
  2. Bittorrent
    1. The files tab shows a different percentage-completed than the torrent
    2. What do all those numbers in parentheses mean?
    3. Seeding torrents have no queue position! Why?
    4. What bandwidth settings should I use?
    5. Deluge sometimes creates files that I didn't ask it to download. Why?
    6. I lost data on force recheck, Why?
    7. Does deluge support Initial/Super? Seed?
    8. Does Deluge have an embedded tracker?
    9. Does Deluge support multi-tracker torrents?
    10. What is the difference between full allocation and compact allocation?
    11. Which ports should I use?
  3. Plugins
    1. I upgraded from 0.5 and plugin x is missing
    2. Can Deluge use blocklists such as SafePeer? or PeerGuardian??
    3. Where is the scheduler plugin? What are the alternatives for the missing scheduler plugin?
  4. Daemon
    1. Why is deluge still listed in my system tray even after I close it ?
    2. How do I start the daemon ?
    3. How do I start the daemon with logging enabled ?
    4. How do I stop the daemon ?
    5. I can't connect to the daemon from another machine
    6. How do I make deluge connect to a different daemon?
    7. How do I stop deluge from killing the daemon when I quit the GTK UI?
  5. Installing
    1. How do I install 1.0 ?
    2. How do I install 1.0 SVN ?
    3. Deluge won't start with a “gobject.GError: Unrecognised image file format” error.
    4. How do I set Deluge as my default Bittorrent program?

General

Is Deluge Free? Can I get the source?

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.

How to start the various user-interfaces

Gtk:

deluge

Console:

deluge --ui null

Web:

deluge --ui web

Go to http://localhost:8112/ default-password = "deluge"

How do I restore all settings to default?

If you don't care about losing the current torrents:

-Delete everything in "~/.config/deluge"

If you want to keep the current torrents:

-Delete everything in "~/.config/deluge" , EXCEPT the ~/.config/deluge/state directory.

Bittorrent

The files tab shows a different percentage-completed than the torrent

The files tab will only show percentages based on completed pieces while the main view will show total completed including incomplete pieces.

What do all those numbers in parentheses mean?

Field # (#)
Seeders Number of connected seeders Total number of seeders
Peers Number of connected peers Total number of peers
Downloaded Total amount downloaded Total amount downloaded this session
Uploaded Total amount uploaded Total amount uploaded this session

Seeding torrents have no queue position! Why?

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).

What bandwidth settings should I use?

Start with the following:

Maximum Connections200
Maximum Download Speed (Kib/s)-1
Maximum Upload Speed (Kib/s)80% of upload speed
Maximum Upload Slots4
Maximum Half-Open Connections-1
Maximum Connection Attempts per Second20

If you're using Windows XP:

Maximum Half-Open Connections8

If you're using Windows Vista:

Maximum Half-Open Connections4

You can then tweak those settings to suit your connection.

Note: if you do not know your upload speed, you can go to http://speedtest.net and divide the number it says by 8.

Deluge sometimes creates files that I didn't ask it to download. Why?

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 necessarily entirely downloaded.

I lost data on force recheck, Why?

Force recheck discards all incomplete pieces.

Does deluge support Initial/Super? Seed?

We have a fundamental objection to the methods of "super-seed" or "initial-seed", as does the main developer of libtorrent. it's use hurts bittorrent, is utterly ineffective, and will not be supported.

Does Deluge have an embedded tracker?

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.

Does Deluge support multi-tracker torrents?

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.”

What is the difference between full allocation and compact allocation?

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.

Deluge uses sparse-files(http://en.wikipedia.org/wiki/Sparse_file) for full allocation, the compact allocation option is only useful on windows-file systems.

Which ports should I use?

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.

Plugins

I upgraded from 0.5 and plugin x is missing

1.0 is a rewrite, all old 0.5 plugins have to be rewritten.

The webui is not a plugin anymore, see : http://dev.deluge-torrent.org/wiki/Faq#Howtostartthevarioususer-interfaces

Torrent-Notification is builtin in the future 1.1 (should be moved to a plugin)

Can Deluge use blocklists such as SafePeer? or PeerGuardian??

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)

Where is the scheduler plugin? What are the alternatives for the missing scheduler plugin?

There is no scheduler plugin for 1.0 yet.

1.0 : use cron + this script: http://dev.deluge-torrent.org/ticket/382#comment:4

1.1 : Scheduling?

Daemon

Why is deluge still listed in my system tray even after I close it ?

You closed the gtk user-interface but you did not close the daemon. Choose "Quit & Shutdown Daemon" to close both Daemon and gtk-ui.

How do I start the daemon ?

deluged

How do I start the daemon with logging enabled ?

Logging to console

deluged -d

Logging to file

deluged -l <logfile>

How do I stop the daemon ?

killall deluged

Deluge accepts the SIGTERM signal and cleanly shuts down.

I can't connect to the daemon from another machine

  • Configure the daemon to allow remote connections
  • Restart the daemon.

Note: do not do this on a public ip , use the webui for insecure networks.

How do I make deluge connect to a different daemon?

By default, deluge is in classic mode: the daemon and gtk ui are linked together. To disable classic mode:

  1. "Preferences"
  2. "Interface"
  3. Untick "Enable" under "Classic Mode".
  4. Restart deluge.

How do I stop deluge from killing the daemon when I quit the GTK UI?

See above.

Installing

How do I install 1.0 ?

InstallingDeluge?

How do I install 1.0 SVN ?

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 # for development version
$ svn co http://svn.deluge-torrent.org/branches/1.0.0_RC deluge # for 1.0.x stable
$ cd deluge
$ sudo rm  -fr /usr/lib/python2.5/site-packages/deluge-1.0*
$ 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
$ sudo rm  -fr ./build #only needed if libtorrent was changed.
$ python setup.py build
$ sudo python setup.py install

Deluge won't start with a “gobject.GError: Unrecognised image file format” error.

You need to install SVG support. On Debian/Ubuntu?, the package is librsvg2-common

How do I set Deluge as my default Bittorrent program?

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.