📦 BitTorrent Client in Python

A lightweight, educational BitTorrent client built entirely in Python — designed to help you understand the internals of the BitTorrent protocol: torrent parsing, peer discovery, tracker communication, handshakes, and piece exchange.

---

🚀 Overview

This project implements core components of a BitTorrent client from scratch, focusing on understanding the low-level mechanics of P2P networking.

It explains:

• How .torrent files are structured
• How magnet links work
• How peers and trackers communicate
• How the BitTorrent handshake works
• How pieces are exchanged between peers

Perfect for anyone exploring networking, protocol reverse engineering, or distributed systems.

---

🔥 Features

Torrent Parsing

• Decode .torrent files (bencoded data)
• Extract info_hash, piece length, file metadata & trackers

Magnet Link Support

• Parse magnet URIs
• Extract info hash, display name, tracker list

Tracker Communication

• HTTP/UDP tracker support
• Announce to trackers & fetch peer lists

Peer Discovery + Handshake

• Establish peer connections
• Implement BitTorrent handshake
• Extended handshake support

Piece Management (WIP)

• Piece selection
• Request/response pipeline
• SHA-1 hash verification

---

🧠 Architecture (How It Works)

1. Torrent / Magnet Parsing

File: torrent/parser.py
Extracts metadata required for downloading.

2. Tracker Communication

File: network/tracker.py
Sends announce requests and receives peer lists.

3. Client Engine

File: client/engine.py
Handles peer connections, handshakes, and piece workflow.

4. Entry Point

File: app/main.py
The CLI entrypoint connecting all modules.

---

🛠️ Installation

1. Clone the repository

git clone https://github.com/dvanhu/bittorrent-python.git
cd bittorrent-python

2. Install dependencies
pip install -r requirements.txt