v1.0.0

torrentor is a CLI tool that wraps transmission-cli and turns downloading torrents into a smooth terminal experience. You give it a magnet link or a .torrent file, and it downloads the file, shows a live progress bar with speed and estimated time, stops seeding automatically when done, packs the result into a zip file with a clean URL-friendly filename, moves it to your chosen folder, and cleans up temporary files.

There are two ways to use it. You can run torrentor with no arguments to enter interactive mode, which shows a guided menu. Or you can run torrentor with a magnet link or .torrent file path as the first argument to download directly, optionally with flags like --save-to and --max-download. All flags are visible when you run torrentor -h, grouped into Options, Optional, and Advanced sections — no need to dig into subcommands.

If a download fails or you cancel it with Ctrl+C, your cached progress is preserved. You can retry from where you left off, start fresh, or cancel and keep the cache for later. Cached downloads can be cleaned up manually with the --flush-cache flag. Every flag has a short equivalent — for example, --save-to also works as -o and --help also works as -h.

Your settings are saved to a JSON file and remembered between sessions. You can change them interactively in the Settings menu or directly from the command line with torrentor config set. Settings include the output directory, download and upload speed limits, network port, connection privacy level, whether to keep sharing after download, whether to download in order, whether to check the file for errors, whether to block bad peers, and a time limit.

Torrentor works on macOS, Linux, and Windows. Configuration files are stored in the right place for each operating system. On macOS and Linux you will find the config at ~/.config/torrentor/config.json and on Windows at %APPDATA%\torrentor\config.json. The tool requires Python 3.10 or newer and transmission-cli to be installed on your system.

You can install torrentor with pipx by running pipx install torrentor, or from source by cloning the repository, creating a virtual environment, and running pip install -e ..

This release was built by Kolja Nolte and is available under the MIT license.