transmission-cli(1) a bittorrent client


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


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
Disble 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 for more information.
-h, --help
Prints a short usage summary.
-m, --portmap
Enable portmapping via NAT-PMP or UPnP
-M, --no-portmap
Disable portmapping
-n, --new sourcefile
Create torrent from the specified file or directory
-p, -port port
Set the port to listen for incoming peers. (Default: 51413)
-t, -tos tos
Set the peer socket TOS for local router-based traffic shaping. Valid values are

``default'' ``lowcost'' ``throughput'' ``reliability'' ``lowdelay''

a decimal value 0-255 or a hexidecimal value 0x00-0xff)

-u, -uplimit number
Set the maximum upload speed in KB/s
-U, -no-uplimit
Don't limit the upload speed
-v, --verify
Verify the torrent's downloaded data.
-w, --download-dir directory
Where to save downloaded data.


In addition to these options, sending transmission-cli a SIGHUP signal will contact the tracker for more peers.


Sets the default config-dir.
libcurl uses this environment variable when performing tracker announces.


Directory where transmission-cli keeps torrent information for future seeding and resume operations.


The transmission-cli program was written by An -nosplit An Eric Petit , An Josh Elsasser , An Jordan Lee , and An Mitchell Livingston .