Skip to main content

A simple BitTorrent client

Project description

#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)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

drench-0.0.13.tar.gz (12.7 kB view hashes)

Uploaded Source

Built Distribution

drench-0.0.13-py2.7.egg (36.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page