Skip to main content

A CLI utility for torrent creation and manipulation.

Project description


GitHub CI
Docs - Stable Docs - Latest

thorod is a CLI utility for torrent creation and manipulation.

What's a thorod?

Thorod means torrent (of water) in the Tolkien Elvish language of Sindarin.

Why use thorod?

There are many CLI torrent utilities out there, so here are some unique or notable features of thorod:

  • All torrents are unique; a random salt is added to all created/xseeded torrents.
  • Supports trackers on the same tier.
  • Type less with tracker abbreviations.
    • Includes a number of open public trackers by default.
    • Includes auto generated open and random abbreviations to help balance load between open public trackers.
    • Users can list/add/remove their own tracker abbreviations directly from CLI as well as manually editing config file.
  • Generate magnet links on creation or on command.
  • Has an xseed command to generate a cross-seedable torrent without re-hashing files.
  • View information about a torrent file in the terminal, rather than adding it to a torrent client.
  • Simple automatic piece size calculation from 16 KiB to 32 MiB on by default. Users can set manually by option.
  • Supports source key in info dict used by private trackers.


pip install -U thorod


For the release version, see the stable docs.
For the development version, see the latest docs.


Showing appreciation is always welcome.


Say Thanks

Get your own thanks inbox at


Contribute by submitting bug reports, feature requests, or code.

Help Others/Stay Informed

Discourse forum


Digital Ocean Namecheap PayPal

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

thorod-2.1.0.tar.gz (14.3 kB view hashes)

Uploaded Source

Built Distribution

thorod-2.1.0-py3-none-any.whl (15.2 kB view hashes)

Uploaded Python 3

Supported by

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