Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

A simple BitTorrent client

Project description


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](, 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.


The preferred way to install Drench is with [pip](, 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 install


From the command line enter the following:

python -m drench ./mytorrent.torrent –port 8000 –visualizer –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 The address of your [vis]( server (optional)

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


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

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
drench-0.0.13-py2.7.egg (36.0 kB) Copy SHA256 hash SHA256 Egg 2.7 Jan 26, 2014
drench-0.0.13.tar.gz (12.7 kB) Copy SHA256 hash SHA256 Source None Jan 26, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page