Skip to content

πŸ“ 🌎 BitTorrent client built with Python + asyncio

License

Notifications You must be signed in to change notification settings

borzunov/bit-torrent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

bit-torrent

Simple BitTorrent client built with Python's asyncio

Main window screenshot

Features

  • Downloading torrents and sharing received data
  • Graphical interface (supports Drag'n'Drop and can be assigned to *.torrent files in system "Open with..." dialog)
  • Console interface
  • Pausing torrents, watching progress, download and upload speed, ETA
  • Selecting which files in a torrent you want to download
  • Saving state between program restarts

Implemented specifications:

Architecture

In this project, I tried to avoid threads and use only asynchronous I/O. As a result, all algorithms and network interaction work in one thread running an asyncio event loop, but there are still a few additional threads:

  • Non-blocking disk I/O isn't supported by asyncio. To prevent freezes for up to a second during disk writing, blocking I/O runs in a ThreadPoolExecutor.
  • PyQt GUI runs in the main thread and invokes an asyncio event loop in a separate QThread. Another option is to use a Qt event loop in asyncio with quamash, but this increases UI reaction time, and the Qt event loop may be less efficient than asyncio's default one.

Program sources depend on Python 3.5+ features: they are annotated with type hints (PEP 0484) and use coroutines with async/await syntax (PEP 0492).

Installation

The program requires Python 3.5+ and works on Linux, macOS, and Windows. You also need PyQt 5 to run GUI.

On Ubuntu 16.04 or newer, run:

sudo apt-get install python3-pip python3-pyqt5
git clone https://github.com/borzunov/bit-torrent.git && cd bit-torrent
sudo python3 -m pip install -r requirements.txt

On macOS, run:

python3 -m pip install PyQt5
git clone https://github.com/borzunov/bit-torrent.git && cd bit-torrent
python3 -m pip install -r requirements.txt

Usage

Graphical interface

Run:

python3 torrent_gui.py

If torrent files are provided as command line arguments, corresponding adding dialogs will be opened.

Console interface

  1. Start a daemon:

     ./torrent_cli.py start &
    
  2. (optional) Look at a list of files in a torrent you want to download:

     ./torrent_cli.py show ./examples/debian-11.2.0-amd64-netinst.iso.torrent
    
  3. Specify a download directory and add the torrent to the daemon:

     ./torrent_cli.py add ./examples/debian-11.2.0-amd64-netinst.iso.torrent -d ./downloads
    

    If the torrent contains more than one file, you can select which files you want to download using --include and --exclude options. For more information run:

     ./torrent_cli.py add --help
    
  4. Watch torrent status:

     watch ./torrent_cli.py status
    

    Add -v to increase output verbosity.

    You also can add more torrents, pause, resume, and remove them. For more information run:

     ./torrent_cli.py --help
    
  5. To stop the daemon run:

     ./torrent_cli.py stop
    

    The daemon will restore its state after restart.

Debug mode

You can enable a verbose debug mode for GUI and CLI daemons by adding --debug flag after the script name.

You may also want to enable asyncio debug mode. This is done as follows:

PYTHONASYNCIODEBUG=1 python3 -Wdefault torrent_gui.py --debug

Author

Copyright Β© 2016-2017 Alexander Borzunov

About

πŸ“ 🌎 BitTorrent client built with Python + asyncio

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages