FAQ

From KTorrent

Jump to: navigation, search

Contents

[edit] It crashes / I want to report a bug / I want to request a feature, where do I go?

Go to http://bugs.kde.org/ and report/request it. If you report a bug involving problems with a torrent, include the torrent file, a link to it, or send it in an e-mail.

If you get an error message that the tracker is down, do not report it, this is beyond the developers' control. Most likely somebody else's server is down, or the tracker just isn't there anymore.

[edit] How do I get support?

Go to the KTorrent forums or go to the irc channel at #ktorrent on irc.freenode.org.

[edit] How can you contact the KTorrent developers?

Go to our forum. Alternatively you can send an e-mail to joris DOT guisson AT gmail DOT com or joris AT ktorrent DOT org.

[edit] How do I get the latest code, and how do I compile it?

First, make sure you have subversion (svn old home). (It's probably in your distro's package system, named "subversion" or "svn".) Then, execute the following commands (replace localdir with where you want it on your system):

svn co svn://anonsvn.kde.org/home/kde/trunk/extragear/network/ktorrent localdir

This will checkout the latest development code. This can be unstable, so only use it if you know what you are doing. The stable code can be retrieved here:

svn co svn://anonsvn.kde.org/home/kde/branches/stable/extragear-kde4/network/ktorrent/ localdir

From this branch the next stable release will be generated. Past releases can be found in:

svn co svn://anonsvn.kde.org/home/kde/tags/ktorrent/ 

Each release has its own subdirectory with its version number as name.

[edit] How do I compile KTorrent?

To compile KTorrent:

cd directory_where_ktorrent_source_code_is
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=$(kde4-config --prefix) ..
make
sudo make install

From the forum post: [1] And specific to KT 3.3.4 and ubuntu:

tar -xvjf ktorrent-3.3.4.tar.bz2
sudo apt-get build-dep ktorrent
cd ktorrent-3.3.4
cmake -DCMAKE_INSTALL_PREFIX=$(kde4-config --prefix)
make
sudo make install

[edit] I want to compile the latest trunk, on what packages does KTorrent depend?

build-essential kdesdk kdelibs5-dev libqca2-dev libgmp3-dev subversion cmake automoc kdebase-workspace-dev libboost-dev kdepimlibs5-dev libtag1-dev python-kde4 kdelibs5-dev libgeoip-dev


[edit] Ubuntu

This is how the packages are named under Ubuntu, so they could have another name under your distribution. For APT-based package systems, you can probably pull in what you need with just

apt-get build-dep ktorrent

Additional info from forum thread: [2] , relating to 3.3.4, package dependencies are :

cmake
Qt development packages
KDE development packages
taglib development packages
libgmp development packages
libqca2 development packages
boost development packages
KDE pim libraries development packages

[edit] Mandriva

The Mandriva equivalent commands (urpmi based systems) should be :

urpmi --buildrequires ktorrent

but isn't? See same forum thread above. Mandriva also supports regular RPM commands.

Update: For Mandriva you can install the meta packages "task-kde" and "task-kde4-devel" which should pull in everything needed.

[edit] How can I get the KDE3 version?

The KDE3 version is no longer being actively developed, it is recommended that you upgrade to the KDE4 version.

To get the code of the KDE3 version, do this:

svn co svn://anonsvn.kde.org/home/kde/branches/extragear/kde3/network/ktorrent
cd ktorrent
svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/kde-common/admin/
svn cat svn://anonsvn.kde.org/home/kde/branches/extragear/kde3/network/Makefile.cvs > Makefile.cvs

To compile it:

make -f Makefile.cvs
./configure
make

[edit] Does KTorrent support magnet links?

Magnet links are supported starting with KTorrent 4.0. This is not to be confused with the KDE versioning scheme, as KTorrent is released independently. See the News section to see if version 4.0 has been released yet.

[edit] My network starts out fine, but after running KTorrent for a while my network turn to sludge!

Your torrents are probably taking up all the connection slots in your router.

[edit] General solutions

On your router:

  • Enable Quality-of-Service (QoS), setting BitTorrent traffic to below-standard rates
  • Enable TCP Vegas (assuming your router & firmware support it)

In your router's Connections section set:

  • TCP Timeout
    • Time Wait: 45 sec
    • SYN Sent: 120 sec
  • UDP Timeout
    • Unreplied: 30 sec

In KTorrent: Settings > Configure KTorrent > Network:

  • Maximum connections per torrent: 10

In KTorrent: Settings > Configure KTorrent > BitTorrent:

  • Uncheck "Use DHT to get additional peers". (This will sacrifice some peers for more bandwidth.)
  • Check "Use protocol encryption"
  • Uncheck "Allow unencrypted connections"

[edit] Linksys (low-end router) solutions

In KTorrent:

  • Cap global connection limit to approx. 200
  • Set "maximum downloads" plus "maximum seeds" between 15 and 25
  • Set "maximum connections per torrent" to between 8 and 16

Example:

  • Maximum downloads: 16
  • Maximum seeds: 4
  • Maximum connections per torrent: 10 (20 x 10 = 200)

Specific router list for this section:

  • Linksys WRT54G/GS/GL
Personal tools