Changes between Version 106 and Version 107 of Faq


Ignore:
Timestamp:
09/01/2009 01:23:39 PM (12 years ago)
Author:
nikos
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Faq

    v106 v107  
    1 [[PageOutline(1-2,Deluge 1.1 FAQ,inline)]] 
    2  
    3 = General = 
    4  
    5 == Is Deluge Free? Can I get the source? == 
    6  
    7 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 [wiki:Download 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. 
    8  
    9 == How to start the various user-interfaces  == 
    10  
    11 Gtk: 
    12  
    13 {{{ 
    14 deluge 
    15 }}} 
    16 Console: 
    17  
    18 {{{ 
    19 deluge --ui null 
    20 }}} 
    21  
    22 or 
    23  
    24 {{{ 
    25 deluge --ui console 
    26 }}} 
    27  
    28 Web: 
    29  
    30 {{{ 
    31 deluge --ui web 
    32 }}} 
    33  
    34 Go to http://localhost:8112/ 
    35 default-password = "deluge" 
    36  
    37 If you are using deluge only as a server or without gui on that machine you can change ~/.config/deluge/ui.conf to set your default. 
    38  
    39 == Where does Deluge store its settings? == 
    40  
    41 === Linux === 
    42  
    43 {{{ 
    44 ~/.config/deluge/ 
    45 }}} 
    46  
    47 === Windows === 
    48  
    49 {{{ 
    50 %APPDATA%\deluge\ 
    51 }}} 
    52  
    53 == How do I restore all settings to default? == 
    54  
    55 If you don't care about losing your current torrents then delete everything in Deluge's settings folder (see above for location). 
    56  
    57 If you do want to keep your current torrents then delete everything except for the state folder. 
    58  
    59 = Bittorrent = 
    60  
    61 == The files tab shows a different percentage-completed than the torrent == 
    62  
    63 The files tab will only show percentages based on completed pieces while the main view will show total completed including incomplete pieces. 
    64  
    65 == What do all those numbers in parentheses mean? == 
    66  
    67 || '''Field''' || '''#''' || '''(#)''' || 
    68 || Seeders || Number of connected seeders || Total number of seeders || 
    69 || Peers || Number of connected peers || Total number of peers || 
    70 || Downloaded || Total amount downloaded || Total amount downloaded this session || 
    71 || Uploaded || Total amount uploaded || Total amount uploaded this session || 
    72  
    73 == Seeding torrents have no queue position! Why? == 
    74  
    75 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). 
    76  
    77 == What bandwidth settings should I use? == 
    78  
    79 Start with the following: 
    80 ||Maximum Connections||200|| 
    81 ||Maximum Download Speed (Kib/s)||-1|| 
    82 ||Maximum Upload Speed (Kib/s)||80% of upload speed|| 
    83 ||Maximum Upload Slots||4|| 
    84 ||Maximum Half-Open Connections||-1|| 
    85 ||Maximum Connection Attempts per Second||20|| 
    86  
    87 If you're using Windows XP*: 
    88 ||Maximum Half-Open Connections||8|| 
    89  
    90 If you're using Windows Vista*: 
    91 ||Maximum Half-Open Connections||4|| 
    92  
    93 You can then tweak those settings to suit your connection. 
    94  
    95 Note: if you do not know your upload speed, you can go to http://speedtest.net and divide the number it says by 8. 
    96  
    97 * If you have Deluge setup as a [wiki:UserGuide/ThinClient ThinClient] then this is the OS that the daemon is running on. 
    98  
    99 == Deluge sometimes creates files that I didn't ask it to download. Why? == 
    100  
    101 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. 
    102  
    103 == I lost data on force recheck, Why? == 
    104  
    105 Force recheck discards all incomplete pieces. 
    106  
    107 == Does Deluge support Initial/Super Seed? == 
    108  
    109 Not yet, but it will be added in the future when libtorrent 0.15 is released. 
    110  
    111 == Does Deluge have an embedded tracker? == 
    112  
    113 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. 
    114  
    115 == Does Deluge support multi-tracker torrents? == 
    116  
    117 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.” 
    118  
    119 == What is the difference between full allocation and compact allocation? == 
    120  
    121 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.  
    122  
    123 We suggest that our users use full allocation. 
    124  
    125 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. 
    126  
    127 == Selective downloading isn't working. How come? == 
    128  
    129 Selective downloading requires full allocation. [[BR]] 
    130 Make sure that you are not using compact allocation. [[BR]] 
    131 See above for an explanation between the two. 
    132  
    133 == Which ports should I use? == 
    134  
    135 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. 
    136  
    137 == Deluge uses random ports instead of selected one, why? == 
    138  
    139 Click Apply after changing the port. 
    140  
    141 Deluge will pick a random port if the chosen port is not available.  
    142  
    143 Run "netstat" to check if the port is free. 
    144  
    145 == What does "Auto Managed" do? == 
    146  
    147 An "auto managed" torrent, is a torrent managed by deluge. 
    148 This means that it obeys deluge's queue settings. 
    149 By disabling "auto managed", a torrent will become active (i.e. start downloading/uploading). 
    150 It will still be be bound by the stop ratio though. 
    151  
    152 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. 
    153  
    154 == Does Deluge have an equivalent to "Force Start"? == 
    155  
    156 Deluge has "auto managed" torrents which are similar, see above for details. 
    157  
    158 To make a torrent no longer "auto managed": 
    159  1. Select the torrent in question. 
    160  1. Select the options tab. 
    161  1. Unselect "Auto Managed". 
    162  
    163 = Plugins = 
    164  
    165 == I upgraded from 0.5 and plugin x is missing == 
    166  
    167 1.0 was a rewrite, all old 0.5 plugins have to be rewritten. 
    168  
    169 The webui is not a plugin anymore, see : http://dev.deluge-torrent.org/wiki/Faq#Howtostartthevarioususer-interfaces 
    170  
    171 Torrent-Notification is builtin in the future 1.1 (will be moved to a plugin) 
    172  
    173 == Can Deluge use blocklists such as !SafePeer or !PeerGuardian? == 
    174  
    175 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: 
    176  
    177  1. http://www.deluge-torrent.org/blocklist/pipfilter.dat.gz (Emule)[[BR]] 
    178  1. http://www.deluge-torrent.org/blocklist/nipfilter.dat.gz (Emule) 
    179  
    180 == Where is the scheduler plugin? What are the alternatives for the missing scheduler plugin? == 
    181  
    182 There is no scheduler plugin for 1.0 yet. 
    183  
    184 1.0 : use cron + this script: http://dev.deluge-torrent.org/ticket/382#comment:4 [[BR]] 
    185 1.1 : ['UserGuide/Scheduling'] 
    186  
    187 = Console = 
    188  
    189 == How do I connect the console UI to a daemon on a non-default port ? == 
    190  
    191 {{{ 
    192 $ deluge -u console 
    193 >>> connect localhost 12345 
    194 }}} 
    195  
    196 = Daemon = 
    197  
    198 == Why is deluge still listed in my task manager even after I close it ? == 
    199  
    200 You closed the UI, but you did not close the daemon. 
    201 Choose "Quit & Shutdown Daemon" to close both Daemon and GtkUI. 
    202  
    203 == How do I only start the daemon ? == 
    204  
    205 {{{ 
    206 deluged 
    207 }}} 
    208  
    209 == How do I start the daemon with logging enabled ? == 
    210  
    211 === Logging to console === 
    212  
    213 {{{ 
    214 deluged -d 
    215 }}} 
    216  
    217 ==== With debug info ==== 
    218  
    219 {{{ 
    220 deluged -d -L debug 
    221 }}} 
    222  
    223 === Logging to file === 
    224  
    225 {{{ 
    226 deluged -l <logfile> 
    227 }}} 
    228  
    229 ==== With debug info ==== 
    230  
    231 {{{ 
    232 deluged -L debug -l <logfile> 
    233 }}} 
    234  
    235 == How do I stop the daemon ? == 
    236  
    237 {{{ 
    238 killall deluged 
    239 }}} 
    240  
    241 Deluge accepts the SIGTERM signal and cleanly shuts down. 
    242  
    243 == I can't connect to the daemon from another machine == 
    244  
    245  1. Configure the daemon to allow remote connections 
    246  1. Configure [wiki:UserGuide/Authentication Authentication] 
    247  1. Restart the daemon. 
    248  
    249 See [wiki:UserGuide/ThinClient ThinClient] for more information on remote GTK UI 
    250  
    251 == How do I make deluge connect to a different daemon? == 
    252  
    253 By default, deluge is in classic mode: the daemon and gtk ui are linked together. 
    254 To disable classic mode: 
    255  1. "Preferences" 
    256  1. "Interface" 
    257  1. Untick "Enable" under "Classic Mode". 
    258  1. Restart deluge. 
    259 See [wiki:UserGuide/ThinClient ThinClient] for more information on remote GTK UI 
    260  
    261 == How do I stop deluge from killing the daemon when I quit the GTK UI? == 
    262  
    263 See above. 
    264  
    265 = Web UI = 
    266  
    267 == How do I use https? == 
    268  
    269 === 1.1 and newer === 
    270  
    271  1. Create (self-signed) ssl certificates: http://httpd.apache.org/docs/2.0/ssl/ssl_faq.html#selfcert 
    272  
    273  ==== Windows ==== 
    274  
    275  1. Put deluge.cert.pem and deluge.key.pem in %APPDATA%\deluge\ssl\ 
    276  
    277  ==== Linux ==== 
    278  
    279  1. Put deluge.cert.pem and deluge.key.pem in ~/.config/deluge/ssl/ 
    280  
    281  ==== ALL ==== 
    282  
    283  1. Enable https in the webui config. 
    284  1. Restart the webui 
    285  
    286 = Installing = 
    287  
    288 == How do I install 1.1 ? == 
    289  
    290 ['Installing'] 
    291  
    292 == How do I install 1.1 SVN ? == 
    293  
    294 First you need to install the necessary dependencies. In Ubuntu and Debian, do this: 
    295  
    296 {{{ 
    297 #!sh 
    298 $ sudo apt-get install g++ make python-all-dev python-all python-dbus \ 
    299 python-gtk2 python-notify python-setuptools librsvg2-common python-xdg \ 
    300 python-support subversion libboost-dev libboost-python-dev \ 
    301 libboost-iostreams-dev libboost-thread-dev libboost-date-time-dev \ 
    302 libboost-filesystem-dev libboost-serialization-dev libssl-dev zlib1g-dev 
    303 }}} 
    304 Next you need to get the latest revision from SVN and build/install it: 
    305 {{{ 
    306 #!sh 
    307 $ svn co http://svn.deluge-torrent.org/trunk deluge # for development version 
    308 $ svn co http://svn.deluge-torrent.org/branches/1.1.0_RC deluge # for 1.1.x stable 
    309 $ cd deluge 
    310 $ sudo rm  -fr /usr/lib/python2.5/site-packages/deluge-1.1* 
    311 $ python setup.py build 
    312 $ sudo python setup.py install 
    313 }}} 
    314 If you have already checked the source out and simply want to update your current tree, then do the following in the deluge directory: 
    315 {{{ 
    316 #!sh 
    317 $ svn up 
    318 $ sudo rm  -fr ./build #only needed if libtorrent was changed. 
    319 $ python setup.py build 
    320 $ sudo python setup.py install 
    321 }}} 
    322  
    323 == Does Deluge have its own repository? == 
    324  
    325 There is an unofficial Ubuntu repository hosted at launchpad: 
    326 {{{ 
    327 deb http://ppa.launchpad.net/deluge-team/ubuntu <distribution> main universe 
    328 }}} 
    329 where <distribution> is one of the following: feisty, gutsy, hardy, intrepid or jaunty. 
    330 As this is unofficial, it could at times not have the latest version and the quality cannot be guaranteed. 
    331  
    332 == How do I set Deluge as my default !BitTorrent program? == 
    333  
    334 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. 
    335  
    336 = Troubleshooting = 
    337  
    338 == Deluge won't start! What should I do? == 
    339  
    340 Sometimes deluge's settings get corrupted and need to be reset. 
    341  
    342 See [wiki:Faq#HowdoIrestoreallsettingstodefault] 
    343  
    344 == Deluge won't start with a "!ImportError: No module named pkg_resources" error. == 
    345  
    346 You need to install setuptools. 
    347  
    348 == Deluge won't start with a "!ImportError: No module named libtorrent" error. == 
    349  
    350 You need to install libtorrent. 
    351  
    352 == Deluge won't start with a “gobject.GError: Unrecognised image file format” error. == 
    353  
    354 You need to install SVG support. On Debian/Ubuntu, the package is librsvg2-common. 
    355  
    356 == Deluge isn't working! What should I do? == 
    357  
    358 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). 
    359  
    360 If you are on Windows, the debug logs are located in your [wiki:Faq#WheredoesDelugestoreitssettings settings folder] under the names "deluged.log" and "deluge.log". 
    361  
    362 If you are in Linux, see [wiki:Faq#HowdoIstartthedaemonwithloggingenabled] 
    363  
    364 If you are pasting the log on the forums, please use the [code]![/code] tags. 
    365  
    366 If you are pasting the log on IRC, please use http://dpaste.com or http://pastebin.com or something similar. 
     1how i do deluge up to 1 mbs