transmission-cli - Man Page

a bittorrent client

Examples (TL;DR)

Download a specific torrent: transmission-cli url|magnet|path/to/file
Download a torrent to a specific directory: transmission-cli --download-dir path/to/download_directory url|magnet|path/to/file
Create a torrent file from a specific file or directory: transmission-cli --new path/to/source_file_or_directory
Specify the download speed limit (in KB/s): transmission-cli --downlimit 50 url|magnet|path/to/file
Specify the upload speed limit (in KB/s): transmission-cli --uplimit 50 url|magnet|path/to/file
Use a specific port for connections: transmission-cli --port port_number url|magnet|path/to/file
Force encryption for peer connections: transmission-cli --encryption-required url|magnet|path/to/file
Use a Bluetack-formatted peer blocklist: transmission-cli --blocklist blocklist_url|path/to/blocklist url|magnet|path/to/file

Synopsis

transmission-cli

-h

transmission-cli

[-b | -B] [-d number | -D] [-er | -ep | -et] [-f script] [-g directory] [-h] [-m | -M] [-p port] [--tos tos] [-u number | -U] [-v] [-w directory] torrent-file

Description

The transmission-cli program is a lightweight, command-line BitTorrent client with scripting capabilities.

The options are as follows:

-b --blocklist

Enable peer blocklists. Transmission understands the bluetack blocklist file format. New blocklists can be added by copying them into the config-dir's "blocklists" subdirectory.

-B --no-blocklist

Disable blocklists.

-d --downlimit number

Set the maximum download speed in KB/s

-D --no-downlimit

Don't limit the download speed

-er --encryption-required

Encrypt all peer connections.

-ep --encryption-preferred

Prefer encrypted peer connections.

-et --encryption-tolerated

Prefer unencrypted peer connections.

-f --finish script

Set a script to run when the torrent finishes

-g --config-dir directory

Where to look for configuration files. This can be used to swap between using the cli, daemon, gtk, and qt clients. See https://github.com/transmission/transmission/blob/main/docs/Configuration-Files.md for more information.

-h --help

Prints a short usage summary.

-m --portmap

Enable portmapping via NAT-PMP or UPnP

-M --no-portmap

Disable portmapping

-p --port port

Set the port to listen for incoming peers. (Default: 51413)

--tos tos

Use a ToS or DSCP name to set the peer socket service type for
local router-based traffic shaping. Valid values are a decimal
value 0-255, or any of these DSCP strings:

“af11”, “af12”, “af13”, “af21”, “af22”, “af23”, “af31”, “af32”, “af33”, “af41”, “af42”, “af43”, “cs0”, “cs1”, “cs2”, “cs3”, “cs4”, “cs5”, “cs6”, “cs7”, “ef”, “le” These ToS keys are deprecated and will be removed in the future: “default”, “lowcost”, “lowdelay,” “reliability”, “throughput”

-u --uplimit number