this article is from mandrakeclub web site, maybe it will help you
Next to this article some people seem to have trouble with BitTorrent.
Maxim Heijndijk has written a document to help out with some common problems while trying to setup BitTorrent for downloading with Mandrake Linux.
He explains how to configure your browser to handle torrents and how to setup bandwidth rates with trickle and CBQ.
He also gives a link to a very detailed FAQ on BitTorrent :
http://www.dessent.net/btfaq/
Thank you Maxim for your work!
BASIC USAGE
The bittorrent download client is called btdownloadgui.py. It is used to download files from a webserver. You must first go to a website that contains files with a ".torrent" extension. These ".torrent" files are links to the actual files that will be downloaded.
When you click on a ".torrent" link from your browser, the bittorrent downloadclient should start and download the target of the torrent-link automatically. But most browsers by default are not configured to handle ".torrent" links.
To configure Mozilla, go to "Edit > Preferences > Navigator > Helper Applications". Click on "New Type" and specify a new MIME Type "application/x-bittorrent", with Extension ".torrent". Click on "Open it with" and enter "btdownloadgui.py" in the box. Click OK and close the preferences window.
To configure Opera, go to "File > Preferences > File Types" and click on "New". Specify a MIME Type "application/x-bittorrent", with File extension ".torrent". Click on "Open with other application" and enter "btdownloadgui.py" in the box. Click "OK > Apply > OK" to close the preferences window.
For most browsers the procedure is similar as with Mozilla/Opera.
If you install mailcap-2.0.4-9mdk or higher, the above steps won't be necessary for most browsers. Download it at:
http://www.mandrakeclub.com/download...mdk.noarch.rpm
ADVANCED USAGE
Often, the ".torrent" links can be downloaded to the harddisk, for later use, by right clicking on it. From most browsers you can then pick an option like "Save as" to save the link to the harddisk. If you have a saved ".torrent" link, like for instance "/home/oneeyedtrousersnake/torrents/MandrakeIso9.2.torrent", you can start the download from an xterm by typing
$ btdownloadgui.py /home/oneeyedtrousersnake/torrents/MandrakeIso9.2.torrent
Downloads can be cancelled at any time, by hitting the "Cancel" button of the downloadclient. You can resume the download at the point where it was cancelled if you specify the same directory that you used the first time you downloaded the file.
The downloadclient can be started with a number of options to tweak the download/upload behaviour. The most important option is:
--max_upload_rate [number]
If you have a maximum upload rate of, say, 16 Kilobytes (same as 128 Kilobits), you have to specify a --max_upload_rate that is less than 16KB. Usually 13 KB will be the best value. If you don't do this, there's a chance that the upload rate will 'choke' your download rate to a very low level. Your other network clients could also suffer, browsing can become very slow.
CONFIGURING BANDWIDTH RATES WITH TRICKLE
Currently, bittorent has no option to limit the overall upload rate for several clients at once. However, it is possible to accomplish this with "trickle". Install the trickle RPM from Club :
http://www.mandrakeclub.com/modules...._page&RID=1497
and edit the maximum upload rate in /etc/sysconfig/trickle.
Start the daemon with: 'service trickle start'.
You can now start your download clients with 'trickle btdownloadgui.py [file.torrent]', or put 'trickle btdownloadgui' in the MIME-setting of your browser, as detailed above. The overall bandwidth of all clients will be limited by the trickled daemon.
CONFIGURING BANDWIDTH RATES WITH CBQ
There is also a possibility to configure your bandwidth at kernel level in much more detail with Fair Queueing with 'CBQ'. You can download an init script at
http://sourceforge.net/projects/cbqinit.
Put the initscript in /etc/rc.d/init.d/ and put the below example configuration in the file /etc/sysconfig/cbq/cbq-104.bittorrent-client0 :
DEVICE=eth0,10Mbit,1Mbit
RATE=104Kbit
WEIGHT=10Kbit
PRIO=5
RULE=,:6881
RULE=,:6882
RULE=,:6883
RULE=,:6884
RULE=,:6885
RULE=,:6886
RULE=,:6887
RULE=,:6888
RULE=,:6889
RULE=:6881,
RULE=:6882,
RULE=:6883,
RULE=:6884,
RULE=:6885,
RULE=:6886,
RULE=:6887,
RULE=:6888,
RULE=:6889,
Read the information in the initscript to configure cbq for your system.
The main drawback of using CBQ is that it's so much more difficult to configure than trickle. The advantage is that, if you know how to configure it, it is much more flexible.
That's all...
Maxim Heijndijk (c) 2003