Create Bittorent v1, v2 and hybrid meta files.
Project description
TorrentFile
🌐 Overview
A simple
and convenient
tool for creating, reviewing, editing, and/or
validating bittorrent meta files (aka torrent files). torrentfile
supports all versions of Bittorrent files, including hybrid meta files, and has
full unicode support.
A GUI frontend for this project can be found at https://github.com/alexpdev/TorrentfileQt
🔌 Requirements
- Python 3.7+
- Tested on Linux, Windows and Mac
💻 Install
via PyPi:
pip install torrentfile
via Git:
git clone https://github.com/alexpdev/torrentfile.git
cd torrentfile
pip 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 the codebase between releases.
🚀 Usage
Usage
=====
torrentfile [options] <command> [command-options] ...
Create, edit, show details, and check any version Bittorrent file from command line
Commands
--------
create (c, new) Create a torrent meta file.
edit (e) Edit existing torrent meta file.
magnet (m) Create magnet url from an existing Bittorrent meta file.
recheck (r, check) Calculate amount of torrent meta files content is found on disk.
info (i) Show detailed information about a torrent file.
Usage examples can be found in the project documentation on the examples page.
📝 License
Distributed under Apache v2 software license. See LICENSE
for more information.
💡 Issues & Requests
If you encounter any bugs or would like to request a new feature please open a new issue.
https://github.com/alexpdev/torrentfile/issues
Creating Torrents
- Basic torrent file createion
> torrentfile create /path/to/content
- The
-t
--tracker
-a
--announce
flags add one or more urls to list of trackers.
> torrentfile create /path/to/content --tracker http://tracker1.com
> torrentfile create -t http://tracker2 http://tracker3 --private /path/to/content
> torrentfile create --tracker http://tracker /path/to/content
> torrentfile create -t http://tracker1 http://tracker2 /path/to/content
- the
--private
flag indicates use by a private tracker - the
--source
flag can be used to help with cross-seeding
> torrentfile create --private --source EXAMPLE --tracker https://url1 https://url2
- to turn off the progress bar shown use
--noprogress
> torrentfile -t http://tracker.com --noprogress /path/to/content
- to specify the save location use the
-o
or--out
flags - if the path points to directory the name of torrent is autofilled.
> torrentfile create -o /specific/path/name.torrent ./content
- to create files using bittorrent v2 use
--meta-version 2
- likewise
--meta-version 3
creates a hybrid torrent file.
> torrentfile create --meta-version 2 /path/to/content
> torrentfile create --meta-version 3 /path/to/content
Check/Recheck Torrent
- recheck torrent file
/path/to/some.torrent
with/path/to/content
> torrentfile recheck /path/to/some.torrent /path/to/content
Edit Torrent
- edit a torrent file
> torrentfile edit [options] <path>
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 (expiremental)
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.
- to activate interactive mode use
-i
or--interactive
flag
> torrentfile -i
GUI
If you prefer a windowed gui please check out the official GUI frontend here
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for torrentfile-0.7.6-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b1d843fb74206ed8ce931686cd7f9a67ce69f2db9afd78f582c2f6878c8313fd |
|
MD5 | 03eae6e46bb46751a8f9e2d09c508f2d |
|
BLAKE2b-256 | 1dac4ed722e5cce6e7f7561ecec1e30f1d6495e1703c571921bac00db4cabc2e |