Simple and functional BitTorrent client made in Python - Use for learning
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.gitignore Simplified the way torrents are downloaded ( but not really efficient ) Aug 15, 2015

PyTorrent - Python BitTorrent

PyTorrent is a CLI tool that downloads files from the BitTorrent network.

I wanted to make my own functional and straightforward program to learn how does BitTorrent protocol work and improve my python skills.

It is almost written from scratch, python 2.7 without twisted. Only the pubsub library was used to create events, when a new peer is connected, or when data is received from a peer.

This tool needs a lot of improvements, but it does its job, you can :

  • Read a torrent file
  • Scrape udp or http trackers
  • Connect to peers
  • Ask them for the blocks you want
  • Save a block in RAM, and when a piece is completed and checked, write the data into you hard drive
  • Deal with the one-file or multi-files torrents

But you can’t :

  • Download more than one torrent at a time
  • Upload data to the BitTorrent network
  • Benefit of a good algorithm to ask your peers for blocks (like the rarest piece algo)
  • Pause and resume download
  • Leech or Seed to other peers
  • And a lot of other things

Don't hesitate to ask me questions if you need help, or send me a pull request for new features or improvements.


You can run the following command to install the dependencies using pip

pip install -r requirements.txt

💥 Because it's using the "select" function, this code will not be able to run on Windows: python-select-on-windows

Running the program

If you want to specify a torrent file, you need to edit it manually in the file:

self.torrent = Torrent.Torrent("path_to_your_torrent") 

Then simply run: python

The files will be downloaded in the same path as your script.

Sources :

I wouldn't go that far without the help of Lita, Kristen Widman's & the Bittorrent Unofficial Spec, so thank you.