TorrentFile

torrentfile


Codacy Badge Codacy Badge GitHub repo size GitHub License PyPI - Downloads CI DeepSource

🌐 Overview

A simple and convenient tool for creating, reviewing, editing, and/or checking bittorrent meta files (aka torrent files). torrentfile supports all versions of Bittorrent files, including hybrid meta files.

A GUI frontend for this project can be found at https://github.com/alexpdev/TorrentfileQt

🔌 Requirements

💻 Install

via PyPi:

pip install torrentfile

via Git:

git clone https://github.com/alexpdev/torrentfile.git
python setup.py install

Download pre-compiled binaries from the release page.

📚 Documentation

Documentation can be found here or in the docs directory.

torrentfile is under active development, and is subject to significant changes in
it's codebase between releases.

🚀 Usage

torrentfile [-h] [-i] [-V] [-v]  ...

Sub-Commands:

    create           Create a new torrent file.
    check            Check if file/folder contents match a torrent file.
    edit             Edit a pre-existing torrent file.
    magnet           Create Magnet URI for an existing torrent meta file.

optional arguments:
  -h, --help         show this help message and exit
  -V, --version      show program version and exit
  -i, --interactive  select program options interactively
  -v, --verbose      output debug information

Usage examples can be found in the project documentation on the examples page.

📝 License

Distributed under the GNU LGPL v3. See LICENSE for more information.

💡 Issues

If you encounter any bugs or would like to request a new feature please open a new issue.

https://github.com/alexpdev/torrentfile/issues


⚙️ CLI Usage Examples

More examples can be found in the documentation.

Creating Torrents

Using the sub-command create or c TorrentFile can create a new torrent
from the contents of a file or directory path. The following examples illustrate
some of the options available for creating torrents (AKA meta files).

>torrentfile create /path/to/content

do this

>torrentfile create /path/to/content --tracker http://tracker1.com

or this

>torrentfile create -t http://tracker2 http://tracker3 --private /path/to/content

not this

>torrentfile create --tracker http://tracker /path/to/content   #ERROR
>torrentfile create -t http://tracker1 http://tracker2 /path/to/content #ERROR
>torrentfile create --private --source /path/to/content --tracker https://tracker/url
>torrentfile -t http://tracker.com --noprogress
>torrentfile create -o /specific/path/name.torrent ./content
>torrentfile create --meta-version 2 /path/to/content
>torrentfile create --meta-version 3 /path/to/content
>torrentfile create --t https://tracker1/annc https://tracker2/annc --magnet /path/to/content

Check/Recheck Torrent

Using the sub-command recheck or check or r you can check the percentage of a torrent
is saved to disk by comparing the the contents to a torrent metafile.

>torrentfile recheck /path/to/some.torrent /path/to/content

Edit Torrent

Using the sub-command edit or e enables editting a pre-existing torrent file. The edit sub-command works the same as the create sub-command and accepts many of the same arguments.

Create Magnet

To create a magnet URI for a pre-existing torrent meta file, use the sub-command
magnet or m with the path to the torrent file.

>torrentfile magnet /path/to/some.torrent

Interactive Mode

Alternatively to supplying a bunch of command line arguments, interactive mode allows users to specify program options one at a time from a series of prompts.

>torrentfile -i