Skip to main content

A Python CLI tool for creating torrent files

Project description

Torrent Creator Version 1.1.7

Torrent Creator is a Python-based CLI tool that allows users to easily create torrent files. It supports both single-file and multi-file torrents, customizable torrent piece sizes, and platform detection (Windows/Linux). This tool also generates magnet URIs based on user preferences and allows users to customize the tracker type for private or public trackers.

Features

  • Create Single-File or Multi-File Torrents: Supports creating torrents from individual files or entire directories.
  • Platform Detection: Automatically detects the operating system (Windows or Linux) and saves configuration (.env) in the appropriate location.
    • Windows: .env is saved in C:/torrent-creator/.env
    • Linux: .env is saved in /home/<username>/torrent-creator/.env
  • Customizable Piece Size: Allows selecting a piece size from 256 KB to 16 MB.
  • Magnet URL Generation: Optionally generates and displays a magnet URL after the torrent is created.
  • Override Configuration via CLI: Allows overriding the default .env values (such as output path, announce URL, piece size, etc.) directly from the command line.
  • Private or Public Tracker Types: Customizable tracker type with an option to enable/disable DHT, PeX, and LSD based on the tracker type.
  • Reconfigure .env File: Supports resetting and reconfiguring the .env file with the --reset-env option.

Installation

To install the tool, run the following command:

pip install torrent-creator

Alternatively, you can clone the repository and install it locally:

git clone https://github.com/yourusername/torrent-creator.git
cd torrent-creator
python setup.py install

Setup / Configuration

Upon the first run, torrent-creator will prompt you to configure the following settings:

  • TORRENT_OUTPUT_PATH: Path where the .torrent files will be saved.

  • ANNOUNCE_URL: The announce URL for the torrent tracker.

  • PRINT_MAGNET_URL: Whether to print the magnet URI after creation (true or false).

  • PLATFORM: The platform (1 for Windows, 2 for Linux).

  • PIECE_SIZE: The size of each piece in bytes (must be one of the predefined sizes).

  • TRACKER_TYPE: The type of tracker (1 for public, 2 for private).

Usage

                           [--platform PLATFORM] [--magnet] [--reset-env]
                           [-set] [-t] [-l] [--tracker-type {1,2}]
                           [-current-conf] [filename]


positional arguments:
  <filename>/directory              The file or directory to create a torrent from.

optional arguments:
  -h, --help            Show this help message and exit.
  -p                    Show current path for .torrent file output.
  -a ANNOUNCE, --announce ANNOUNCE
                        Override announce URL.
  -o OUTPUT, --output OUTPUT
                        Override output directory.
  --ps PS, --piece-size PS
                        Override piece size (bytes).
  --platform PLATFORM   Override platform (1=Windows, 2=Linux).
  --magnet              Print magnet URI after creation.
  --reset-env           Reconfigure the .env file.
  -set                  Set environment variables interactively.
  -t, --trackers        Show trackers from an existing torrent file.
  -l, --list            List files in the torrent directory.
  --tracker-type {1,2}  Set tracker type: 1=Public, 2=Private.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

torrent_creator-1.1.9.tar.gz (9.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

torrent_creator-1.1.9-py3-none-any.whl (12.0 kB view details)

Uploaded Python 3

File details

Details for the file torrent_creator-1.1.9.tar.gz.

File metadata

  • Download URL: torrent_creator-1.1.9.tar.gz
  • Upload date:
  • Size: 9.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.13

File hashes

Hashes for torrent_creator-1.1.9.tar.gz
Algorithm Hash digest
SHA256 6c2480d456f9a60d7c258ffa956ad3e9f9d3ef73640240310778ac9be1311320
MD5 948f48fbd1a6aab83ddbe2eeb4b88345
BLAKE2b-256 572d44cc37fa764571b17ba349f550e4224f8bd86e2544d7ac1002872b6d7157

See more details on using hashes here.

File details

Details for the file torrent_creator-1.1.9-py3-none-any.whl.

File metadata

File hashes

Hashes for torrent_creator-1.1.9-py3-none-any.whl
Algorithm Hash digest
SHA256 d94eb90c8c1bb12668c5fba783508f9ea8cd3db67c96532c0c6f7cc0f5f975ae
MD5 2f2d67159d30f257bc83e1017baab3c8
BLAKE2b-256 46e4d01a5c0bf8e371ca212c014cfe82ce3f668cd447f55033ea474dc1240adf

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page