Skip to content

Latest commit

 

History

History
58 lines (34 loc) · 1.59 KB

README.org

File metadata and controls

58 lines (34 loc) · 1.59 KB

Fiume

https://badge.fury.io/py/Fiume.svg

docs/logo-small.png

A toy BitTorrent client written in python, based on the official specs.

Installation

Install it from pip:

pip install Fiume

This will install fiume, the actual torrent client, as well as other utilities.

Configuration directories/files

When installed, fiume creates a .fiume directory in your home.

It will contain a file, downloading.json, which stores the torrents currently in download. You can modify this file freely and in any moment with your own tools, but if you want no trouble fiume provides a CLI command fiume-add to safely add new torrents.

fiume usage

fiume is the actual program. Its CLI is as follows:

fiume-add usage

To add/remove .torrents files to download, use the fiume-add interface:

Functionalities

What it can do

  • Download of single-file torrents!
  • Can manage more than one .torrent download at a time
  • Save download state beetwen sessions, and start again at a later time
  • Reach acceptable speed downloads (achives maximum download speed on my home connections, ie. 6MBytes/s)
  • Offer a basic CLI

What it can NOT do

  • Download of multiple-file torrents
  • Support DHT, Message Stream Encryption or any other extension
  • While download functionalities has been tested, uploading functionalities are still under test (correctly)