This is a simple BitTorrent client written in C++. The code and the general structure of the program are primarily based on the following blog posts:

• Building a BitTorrent client from the ground up in Go
• A BitTorrent client in Python 3.5

I have found both posts in this repository, which contains numerous tutorials. It is definitely worth looking into for anyone who wants to implement their own tools from ground up.

Note that this is my very first C++ project, which I mainly started to familiarize myself with the language. Hence, the code might not comply with the normal C++ styles, and there are undoubtedly places where the code can be optimized.

If you want to try this BitTorrent client yourself, follow the steps below:

• Clone this repository, and make sure that cmake (> 3.19.2) is installed.
• Type the following commands into the terminal (note that fetching the cpr library will take some time, so the compilation process might be time-consuming.):

$ cd torrent-client-cpp && mkdir build && cd build
$ cmake .. && make -j

• To download the ubuntu iso as an example, enter the following command:

$ ./BitTorrentClient -t ../res/ubuntu-12.04.5-alternate-amd64.iso.torrent -o ../res/  # logging disabled
$ ./BitTorrentClient -t ../res/ubuntu-12.04.5-alternate-amd64.iso.torrent -o ../res/  -l # logging enabled, log can be found in logs/client.log

• The output will be similar to this:

Parsing Torrent file ../res/ubuntu-12.04.5-alternate-amd64.iso.torrent...
Download initiated...
[Peers: 4/5, 0.52 MB/s, ETA: 25:18][>                                       ] 4/1522 [0.26%] in 00:13

• All files in the res directory can be used for testing. The files MoralPsychHandbooks.torrent and ComputerNetworks.torrent all come from Academic Torrents. They are small Torrent files which are suitable for testing all the basic functionalities of the BitTorrent client. Whereas the Torrent files for ubuntu and debian are great for stress tests.

The program supports the following commandline options:

The current implementation of this BitTorrent client only supports the following features:

• Retrieving a list of peers from the tracker periodically.
• Downloading single-file Torrents in a multi-threaded manner.

To make it an actual usable BitTorrent client, it will have to include:

• Seeding
• Resuming a download.
• Downloading multi-file Torrents
• Probably a more intuitive user interface.
• Pipelining when requesting blocks from peers.
• Connecting to as many peers as possible.

Since this is only a project that I started for fun and to learn C++, it is unlikely that any of the unsupported features will be implemented any time soon. If you wish to build on top of my current code, feel free to do so.