Version 127 (modified by devians, 14 years ago) (diff)

--

Deluge 1.2 FAQ

  1. General
    1. Is Deluge Free? Can I get the source?
    2. How to start the various user-interfaces
    3. Where does Deluge store its settings?
    4. 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. Selective downloading isn't working. How come?
    12. Which ports should I use?
    13. Deluge uses random ports instead of selected one, why?
    14. What does "Auto Managed" do?
    15. Does Deluge have an equivalent to "Force Start"?
    16. What is a magnet uri, and how do I get Deluge to handle them?
    17. What is Peer TOS Byte
  3. Plugins
    1. I upgraded from 0.5 and plugin x is missing
    2. Can Deluge use blocklists such as SafePeer or PeerGuardian?
  4. Console
    1. How do I connect the console UI to a daemon on a non-default port ?
  5. Daemon
    1. Why is deluge still listed in my task manager even after I close it ?
    2. How do I only 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?
  6. Web UI
    1. What is the default password
    2. How do I use https?
    3. Can I bind the webui to port :80 in Linux?
    4. How do I change the password?
  7. Installing
    1. How do I install Deluge ?
    2. Does Deluge have its own repository?
    3. How do I set Deluge as my default BitTorrent program?
  8. Windows
    1. Deluge doesn't start!
    2. Error: 14001 side-by-side configuration
    3. Samba Network Shares
  9. Troubleshooting
    1. Deluge won't start! What should I do?
    2. Deluge won't start with a "ImportError: No module named pkg_resources" error.
    3. Deluge won't start with a "ImportError: No module named libtorrent" error.
    4. Deluge won't start with a “gobject.GError: Unrecognised image file format” error.
    5. Deluge's GTK UI won't connect to a remote daemon
    6. Deluge isn't working! What should I do?

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

or

deluge-gtk

Console:

deluge-console

Web:

deluge-web

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

Where does Deluge store its settings?

Linux

~/.config/deluge/

Windows

%APPDATA%\deluge\

How do I restore all settings to default?

If you don't care about losing your current torrents then delete everything in Deluge's settings folder (see above for location).

If you do want to keep your current torrents then delete everything except for the state folder.

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 Connections20
Maximum Connection Attempts per Second20

If you're using Windows XP*:

Maximum Half-Open Connections8

If you're using pre-SP2 Windows Vista*:

Maximum Half-Open Connections4

You can then tweak those settings to suit your connection. See BandwidthTweaking.

Note: if you do not know your upload speed, go to http://speedtest.net and run a test. You can view the results in KB/s by choosing "kilobytes" for "Speed Measurement" which can be accessed under "Settings" in the top left corner of the page.

  • If you have Deluge setup as a ThinClient then this setting is determined by the OS the daemon is running on, not the thin client.

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?

Not yet, but it will be added in the future when libtorrent 0.15 is released.

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.

Selective downloading isn't working. How come?

Selective downloading requires full allocation.
Make sure that you are not using compact allocation.
See above for an explanation between the two.

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.

Deluge uses random ports instead of selected one, why?

Click Apply after changing the port.

Deluge will pick a random port if the chosen port is not available.

Run "netstat" to check if the port is free.

What does "Auto Managed" do?

An "auto managed" torrent, is a torrent managed by deluge. This means that it obeys deluge's queue settings. By disabling "auto managed", a torrent will become active (i.e. start downloading/uploading). It will still be be bound by the stop ratio though.

Note: All active torrents (including those not "auto managed") are counted in the total active queue settings. This means that if the total number of active torrents ("auto managed" and not) exceed the limit for total active torrents in the queue settings, deluge will automatically queue any "auto managed" torrents until the limit is no longer exceeded.

Does Deluge have an equivalent to "Force Start"?

Deluge has "auto managed" torrents which are similar, see above for details.

To make a torrent no longer "auto managed":

  1. Select the torrent in question.
  2. Select the options tab.
  3. Unselect "Auto Managed".

What is a magnet uri, and how do I get Deluge to handle them?

Magnet URIs are an easy way to add torrents by their info-hash. You can learn more about them here: http://en.wikipedia.org/wiki/Magnet_URI_scheme

If you're using GNOME, then you can do these following commands to associate magnets with Deluge:

gconftool-2 -t string -s /desktop/gnome/url-handlers/magnet/command 'deluge "%s"'
gconftool-2 -t bool -s /desktop/gnome/url-handlers/magnet/needs_terminal false
gconftool-2 -t bool -s /desktop/gnome/url-handlers/magnet/enabled true

If you aren't using GNOME, but using Firefox, you can set it up this way:

  • Type about:config into the address bar and press Enter.
  • Add a key by Right-click -> New -> Boolean -> Name: network.protocol-handler.external.magnet with value -> true
  • Add another key, by Right-click -> New -> String -> Name: network.protocol-handler.app.magnet with Value -> deluge
  • Ensure that the key network.protocol-handler.expose-all is set to true.

In Windows, you can simply re-run the installer and select the magnet association option.

What is Peer TOS Byte

IPv4 Header Type Of Service Byte http://www.shorewall.net/3.0/manpages/shorewall-tcclasses.html (More Info)

Example Settings:

tos-minimize-delay 0x10
tos-maximize-throughput 0x08
tos-maximize-reliability 0x04
tos-minimize-cost 0x02
tos-normal-service 0x00

Plugins

I upgraded from 0.5 and plugin x is missing

1.0 was 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 (will 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.deluge-torrent.org/blocklist/pipfilter.dat.gz (Emule)
  2. http://www.deluge-torrent.org/blocklist/nipfilter.dat.gz (Emule)

Console

How do I connect the console UI to a daemon on a non-default port ?

$ deluge -u console
>>> connect localhost 12345

Daemon

Why is deluge still listed in my task manager even after I close it ?

You closed the UI, but you did not close the daemon. Choose "Quit & Shutdown Daemon" to close both Daemon and GtkUI.

How do I only start the daemon ?

deluged

How do I start the daemon with logging enabled ?

Logging to console

deluged -d

With debug info

deluged -d -L debug

Logging to file

deluged -l <logfile>

With debug info

deluged -L debug -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

  1. Configure the daemon to allow remote connections
  2. Configure Authentication
  3. Restart the daemon.

See ThinClient for more information on remote GTK UI

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.

See ThinClient for more information on remote GTK UI

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

See above.

Web UI

What is the default password

The default password for the web interface is "deluge". You should change this upon first login for security reasons.

How do I use https?

1.1 and newer

  1. Create (self-signed) ssl certificates: http://httpd.apache.org/docs/2.0/ssl/ssl_faq.html#selfcert

Windows

  1. Put deluge.cert.pem and deluge.key.pem in %APPDATA%\deluge\ssl\

Linux

  1. Put deluge.cert.pem and deluge.key.pem in ~/.config/deluge/ssl/

ALL

  1. Enable https in the webui config.
  2. Restart the webui

Can I bind the webui to port :80 in Linux?

You cannot bind to anything under 1024 in linux, however if you have kernel 2.6.24 or higher, you can use capabilities to allow python to bind to port 80 securely. In debian/ubuntu:

  1. sudo apt-get install libcap2-bin
  2. sudo setcap 'cap_net_bind_service=+ep' /path/to/python
  3. Configure the WebUI to use port 80
  4. Restart deluged daemon.

How do I change the password?

In the Web UI:

  1. Click on "Preferences"
  2. Select the "Interface" category
  3. Fill out the fields under "Password"
  4. Click "Change"

Installing

How do I install Deluge ?

Installing

Does Deluge have its own repository?

There is an unofficial Ubuntu repository hosted at launchpad: https://launchpad.net/~deluge-team/+archive/ppa

It takes a few days for the latest version to be put up there.

How do I set Deluge as my default BitTorrent program?

On Windows, the installer should do this automatically. 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.

Windows

Deluge doesn't start!

This is usually caused by a crufty GTK installation.

The solution:

  • Uninstall the GTK2 Runtime
  • Delete the C:\Program Files\GTK2-Runtime directory (or where ever it was installed)
  • Reinstall GTK+

You can reinstall GTK by simply re-running the Deluge installer and selecting that option or download the latest from: http://download.deluge-torrent.org/windows/deps

Error: 14001 side-by-side configuration

This error is solved by installing the Microsoft Visual C++ 2008 SP1 Redistributable Package (x86)

Samba Network Shares

In order for Deluge to use a Samba share from within Windows, the share has to be mapped to a drive letter.

Troubleshooting

Deluge won't start! What should I do?

Sometimes deluge's settings get corrupted and need to be reset.

See Faq

Deluge won't start with a "ImportError: No module named pkg_resources" error.

You need to install setuptools.

Deluge won't start with a "ImportError: No module named libtorrent" error.

You need to install libtorrent.

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.

Deluge's GTK UI won't connect to a remote daemon

Make sure both the GTK UI and the daemon are the same (or similar) versions.

Deluge 1.2 was a complete rewrite and hence is unable to connect to 1.1.x

Otherwise make sure you've followed the thin client userguide.

Deluge isn't working! What should I do?

The best thing is to provide us with a debug log of deluged and/or deluge (depending if the error seems to be related to the daemon and/or to a UI).

If you are on Windows, the debug logs are located in your settings folder under the names "deluged.log" and "deluge.log".

If you are in Linux, see Faq

If you are pasting the log on the forums, please use the [code][/code] tags.

If you are pasting the log on IRC, please use http://dpaste.com or http://pastebin.com or something similar.