transmissioncli(1)

transmissioncli1

A bittorrent client

Usage

transmissioncli -h

transmissioncli -i torrent-file

transmissioncli -s torrent-file

transmissioncli -n sourcefile [-a url] [-c comment] [-r] new-torrent-file

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

Overview

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

The options are as follows:

-a, --announce announce-url

When creating a new torrent, set its announce URL

-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.

-c, --comment comment-text

When creating a new torrent, set its comment field

-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 http://trac.transmissionbt.com/wiki/ConfigFiles for more information.

-h, --help

Prints a short usage summary.

-i, --info

Shows torrent details and exit

-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)

-r, --private

When creating a new torrent, set its 'private' flag

-s, --scrape

Print the current number of seeders and leechers for the specified torrent

-t, --tos

Set the peer socket TOS for local router-based traffic shaping.

-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.

Signals

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

Files

~/.config/transmission

Directory where transmissioncli keeps torrent information for future seeding and resume operations.

Releases

3 releases since Debian 4.0 (Etch); the text changed 2 times.

  1. 4.0
  2. 5.0
  3. 6.0

--announce since Debian 5.0 (Lenny); --blocklist since Debian 6.0 (Squeeze); --comment since Debian 5.0 (Lenny); --config-dir since Debian 5.0 (Lenny); --downlimit since Debian 6.0 (Squeeze); --download-dir since Debian 6.0 (Squeeze); --encryption-preferred since Debian 6.0 (Squeeze); --encryption-required since Debian 6.0 (Squeeze); --encryption-tolerated since Debian 6.0 (Squeeze); --new since Debian 6.0 (Squeeze); --no-blocklist since Debian 6.0 (Squeeze); --no-downlimit since Debian 6.0 (Squeeze); --no-portmap since Debian 6.0 (Squeeze); --no-uplimit since Debian 6.0 (Squeeze); --portmap since Debian 6.0 (Squeeze); --private since Debian 5.0 (Lenny); --tos since Debian 6.0 (Squeeze); --uplimit since Debian 6.0 (Squeeze); --verify since Debian 6.0 (Squeeze); -B since Debian 6.0 (Squeeze); -D since Debian 6.0 (Squeeze); -M since Debian 6.0 (Squeeze); -U since Debian 6.0 (Squeeze); -a since Debian 5.0 (Lenny); -b since Debian 6.0 (Squeeze); -c since Debian 5.0 (Lenny); -ep since Debian 6.0 (Squeeze); -er since Debian 6.0 (Squeeze); -et since Debian 6.0 (Squeeze); -g since Debian 5.0 (Lenny); -m since Debian 5.0 (Lenny); -n since Debian 5.0 (Lenny); -r since Debian 5.0 (Lenny); -t since Debian 6.0 (Squeeze); -w since Debian 6.0 (Squeeze).

--create-from until Debian 5.0 (Lenny); --download until Debian 5.0 (Lenny); --nat-traversal until Debian 5.0 (Lenny); --output-dir until Debian 5.0 (Lenny); --recheck until Debian 5.0 (Lenny); --upload until Debian 5.0 (Lenny); --verbose until Debian 5.0 (Lenny); -o until Debian 5.0 (Lenny); -y until Debian 5.0 (Lenny).

Authors

The transmissioncli program was written by Eric Petit, Josh Elsasser, Charles Kerr, and Mitchell Livingston.

From transmission-cli 2.03-2 in Debian 6.0 (Squeeze). Parsed by carta from the page's mdoc source.