Skip to main content
Help improve PyPI by participating in a 5-minute user interface survey!

A BitTorrent client written entirely in Python so that you can get to the depths of the protocol

Project Description

This is a BitTorrent client written entirely in Python so that it can be easily used for experiments. It is a fully working BitTorrent client so you can use it below as an example. There is no intelligence in this such as getting rarest peice first. Everything is random.

It doesn’t use thread or multiprocessing as it’s designed to be used for experiments, and I don’t know how someone may want to use it, while also making it impractical for general use, but I’d like to eventually support the most common schemes such as DHT, Magnet URLs, PHE tDP, and UPnP so it is possible to accept incoming connections.

Installation

PIP

pip install pythorrent

From Source

pip install -r requirements.txt
python setup.py install

Usage

Depending on how you installed PYTHorrent you may need to go to the root of the source of the PYTHorrent directory.

cd python-pythorrent

Getting commands

python -m pythorrent -h

Downloading a Torrent using a torrent file

python -m pythorrent --file ubuntu-16.04-desktop-amd64.iso.torrent --path . --log=info

License

AGPLv3

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

To Do

Tidy up documentation

Memory efficiency

  • Only load piece data in to memory when it is needed.

DHT

Options? - https://github.com/drxzcl/lightdht/ - I like this one best - Seems to lock out when finding peers - https://github.com/gsko/mdht

UPnP

** Always download legal torrents **

Release history Release notifications

This version
History Node

0.1.0

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
PYTHorrent-0.1.0.tar.gz (15.0 kB) Copy SHA256 hash SHA256 Source None Apr 6, 2017

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