drench 0.0.13

A simple BitTorrent client

#Drench

Drench is a lightweight BitTorrent client written in Python. There are a couple of nice features, like the ability to download a subset of all the files in the torrent and exiting cleanly once the download is complete.

The client works with [vis](https://github.com/jefflovejapan/vis), a Twisted web server and D3.js visualization, to show what’s going on in the user’s file system while the download is taking place.

##Install

The preferred way to install Drench is with [pip](http://www.pip-installer.org/en/latest/installing.html), which will let you run the following command from the terminal:

pip install drench

Alternatively, you can clone the source and run the following:

python setup.py install

##Use

From the command line enter the following:

python -m drench ./mytorrent.torrent –port 8000 –visualizer 127.0.0.1:8002 –directory ~/Downloads/

./mytorrent.torrent: The path to your torrent file (required)

–port 8000: The port to use for BitTorrent traffic (optional)

–directory ~/Downloads: Where to save your download (optional)

–visualizer 127.0.0.1:8002: The address of your [vis](https://github.com/jefflovejapan/vis) server (optional)

Drench isn’t capable of downloading multiple torrents at once; just start up a second instance in another terminal instead.

##Status

You can use Drench to download torrent files from the small handful of sites I’ve tested on.

What doesn’t work: - Seeding - Magnet links - UDP-based handshake with tracker (which knocks out several of the biggest trackers)