Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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)

Release History

Release History

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 Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
drench-0.0.13-py2.7.egg (36.0 kB) Copy SHA256 Checksum SHA256 2.7 Egg Jan 26, 2014
drench-0.0.13.tar.gz (12.7 kB) Copy SHA256 Checksum SHA256 Source Jan 26, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting