Manpages

TRANSMISSION-REMOTE(1) BSD General Commands Manual TRANSMISSION-REMOTE(1)

NAME

transmission-remote — a remote control utility for transmission-daemon(1) and transmission(1)

SYNOPSIS

transmission-remote [host:port host port] [−a filenames-or-URLs] [−as] [−AS] [−asd number] [−asu number] [−asc] [−ASC] [−b] [−c path −C] [−d number −D] [−e size] [−er −ep −et] [−-exit] [−f] [−g files] [−G files] [−gsr ratio] [−GSR] [−h] [−i] [−ic] [−if] [−ip] [−it] [−l] [−m −M] [−n user:pass] [−ne] [−N netrc] [−o −O] [−p port] [−Bh] [−Bn] [−Bl] [−ph files] [−pl files] [−pn files] [−pr peers] [−r] [−rad] [−s −S] [−sr ratio] [−SR] [−srd] [−si] [−st] [−t all active id hash] [−hl] [−HL] [−u number −U] [−utp −no-utp] [−v] [−V] [−w download-dir] [−x −X] [−y −Y] [−pi]

DESCRIPTION

transmission-remote is a remote control utility for transmission(1) and transmission-daemon(1).

By default, transmission-remote connects to the transmission session at localhost:9091. Other sessions can be controlled by specifying a different host and/or port.

OPTIONS
−a −-add
filenames-or-URLs

Add torrents to transmission.

−b −-debug

Enable debugging mode.

−as −-alt-speed

Use the alternate Limits.

−AS −-no-alt-speed

Don’t use the alternate Limits.

−asd −-alt-speed-downlimit limit

Limit the alternate download speed to limit kilobytes per second.

−asu −-alt-speed-uplimit limit

Limit the alternate upload speed to limit kilobytes per second.

−asc −-alt-speed-scheduler

Use the scheduled on/off times.

−ASC −-no-alt-speed-scheduler

Don’t use the scheduled on/off days and times.

−-alt-speed-time-begin time

Time to start using the alt speed limits (in hhmm).

−-alt-speed-time-end time

Time to stop using the alt speed limits (in hhmm).

−-alt-speed-days days

Set the number of days on which to enable the speed scheduler, using a list such as "2,4-6".

−-torrent-done-script filename

Specify a file to run each time a torrent finishes

−-no-torrent-done-script

Don’t run any script when a torrent finishes

−c −-incomplete-dir dir

When adding new torrents, store their contents in directory until the torrent is done.

−C −-no-incomplete-dir

Don’t store incomplete torrents in a different directory.

−d −-downlimit limit

Limit the maximum download speed to limit kB/s. If current torrent(s) are selected this operates on them. Otherwise, it changes the global setting.

−D −-no-downlimit

Disable download speed limits. If current torrent(s) are selected this operates on them. Otherwise, it changes the global setting.

−e −-cache size

Set the session’s maximum memory cache size in MiB. This cache is used to reduce disk IO.

−er −-encryption-required

Encrypt all peer connections.

−ep −-encryption-preferred

Prefer encrypted peer connections.

−et −-encryption-tolerated

Prefer unencrypted peer connections.

−-exit

Tell the Transmission to initiate a shutdown.

−f −-files

Get a file list for the current torrent(s)

−g −-get all | file-index | files

Mark file(s) for download. all marks all all of the torrent’s files for downloading, file-index adds a single file to the download list, and files adds multiple files to the download list, such as "−g1,3-5" to add files #1, #3, #4, and #5 to the download list.

−G −-no-get all | file-index | files

Mark file(s) for not downloading.

−gsr −-global-seedratio ratio

All torrents, unless overridden by a per-torrent setting, should seed until a specific ratio

−GSR −-no-global-seedratio

All torrents, unless overridden by a per-torrent setting, should seed regardless of ratio

−h −-help

Print command-line option descriptions.

−i −-info

Show details of the current torrent(s)

−if −-info-files

List the specified torrent’s files

−ip −-info-peers

List the specified torrent’s peers

−ic −-info-pieces

List the specified torrent’s pieces

−it −-info-trackers

List the specified torrent’s trackers

−si −-session-info

List session information from the server

−st −-session-stats

List statistical information from the server

−l −-list

List all torrents

−m −-portmap

Enable portmapping via NAT-PMP or UPnP

−M −-no-portmap

Disable portmapping

−n −-auth username:password

Set the username and password for authentication

−ne −-authenv

Set the authentication information from the TR_AUTH environment variable which must be formatted as username:password.

−N −-netrc filename

Set the authentication information from a netrc file. See netrc(5) for more information.

−o −-dht

Enable distributed hash table (DHT).

−O −-no-dht

Disable distribued hash table (DHT).

−p −-port port

Set the port for use when listening for incoming peer connections

−Bh −-bandwidth-high

Give this torrent first chance at available bandwidth

−Bn −-bandwidth-normal

Give this torrent the bandwidth left over by high priority torrents

−Bl −-bandwidth-low

Give this torrent the bandwidth left over by high and normal priority torrents

−ph −-priority-high all | file-index | files

Try to download the specified file(s) first. all marks all of the torrent’s files as normal priority, file-index sets a single file’s priority as normal, and files sets multiple files’ priorities as normal, such as "−pn1,3-5" to normalize files #1, #3, #4, and #5.

−pn −-priority-normal all | file-index | files

Try to download the specified files normally.

−pl −-priority-low all | file-index | files

Try to download the specified files last

−pr −-peers number

Set the maximum number of peers. If current torrent(s) are selected this operates on them. Otherwise, it changes the global setting.

−r −-remove

Remove the current torrent(s). This does not delete the downloaded data.

−rad −-remove-and-delete

Remove the current torrent(s) and delete their downloaded data.

−-reannounce

Reannounce the current torrent(s). This is the same as the GUI’s "ask tracker for more peers" button.

−-move

Move the current torrents’ data from their current locations to the specified directory.

−-find

Tell Transmission where to look for the current torrents’ data.

−sr −-seedratio ratio

Let the current torrent(s) seed until a specific ratio

−SR −-no-seedratio

Let the current torrent(s) seed regardless of ratio

−srd −-seedratio-default

Let the current torrent(s) use the global seedratio settings

−td −-tracker-add tracker

Add a tracker to a torrent

−tr −-tracker-remove trackerId

Remove a tracker from a torrent

−s −-start

Start the current torrent(s)

−S −-stop

Stop the current torrent(s) from downloading or seeding

−-start-paused

Start added torrents paused

−-no-start-paused

Start added torrents unpaused

−t −-torrent all | active | id | torrent-hash

Set the current torrent(s) for use by subsequent options. The literal all will apply following requests to all torrents; the literal active will apply following requests to recently-active torrents; and specific torrents can be chosen by id or hash. To set more than one current torrent, join their ids together in a list, such as "−t2,4,6-8" to operate on the torrents whose IDs are 2, 4, 6, 7, and 8.

−-trash-torrent

Delete torrents after adding

−-no-trash-torrent

Do not delete torrents after adding

−hl −-honor-session

Make the current torrent(s) honor the session limits.

−HL −-no-honor-session

Make the current torrent(s) not honor the session limits.

−u −-uplimit limit

Limit the maximum upload speed to limit kB/s. If current torrent(s) are selected this operates on them. Otherwise, it changes the global setting.

−U −-no-uplimit

Disable upload speed limits.

−-utp

Enable uTP for peer connections.

−-no-utp

Disable uTP for peer connections. If current torrent(s) are selected this operates on them. Otherwise, it changes the global setting.

−v −-verify

Verify the current torrent(s)

−V −-version

Show version number and exit

−w −-download-dir directory

When used in conjunction with --add, set the new torrent’s download folder. Otherwise, set the default download folder.

−x −-pex

Enable peer exchange (PEX).

−X −-no-pex

Disable peer exchange (PEX).

−y −-lds

Enable local peer discovery (LPD).

−Y −-no-lds

Disable local peer discovery (LPD).

−pi −-peer-info

List the current torrent’s connected peers. In the ’status’ section of the list, the following shorthand is used:

D: Downloading from this peer
d: We would download from this peer if they would let us
E: Encrypted connection
H: Peer was found through DHT
I: Peer is an incoming connection
K: Peer has unchoked us, but we’re not interested
O: Optimistic unchoked
T: Peer is connected over uTP
U: Uploading to peer
u: We would upload to this peer if they asked
X: Peer was discovered through Peer Exchange (PEX)
?: We unchoked this peer, but they’re not interested

−-blocklist-update

Update blocklist from URL specified in remote client’s settings with blocklist-url key.

EXAMPLES

List all torrents:

$ transmission-remote −l

List all active torrents:

$ transmission-remote −tactive −l

Set download and upload limits to 400 kB/sec and 60 kB/sec:

$ transmission-remote −d400 −u60
$ transmission-remote −−downlimit=400 −−uplimit=60

Set alternate download and upload limits to 100 kB/sec and 20 kB/sec:

$ transmission-remote −asd100 −asu20
$ transmission-remote −−alt-speed-downlimit=100 −−alt-speed-uplimit=20

Set the scheduler to use the alternate speed limits on weekdays between 10AM and 11PM

$ transmission-remote −−alt-speed-time-begin=1000
$ transmission-remote −−alt-speed-time-end=2300
$ transmission-remote −−alt-speed-days=1-5
$ transmission-remote −−alt-speed-scheduler

List all torrents’ IDs and states:

$ transmission-remote −l

List all torrents from a remote session that requires authentication:

$ transmission-remote host:9091 −−auth=username:password −l

Start all torrents:

$ transmission-remote −tall −−start

Add two torrents:

$ transmission-remote −a one.torrent two.torrent

Add all torrents in ~/Desktop:

$ transmission-remote −a ~/Desktop/*torrent

Get detailed information on the torrent whose ID is ’1’:

$ transmission-remote −t1 −i

Get a list of a torrent’s files:

$ transmission-remote −t1 −f

Download only its second and fourth files:

$ transmission-remote −t1 −Gall −g2,4

Set all torrents’ first two files’ priorities to high:

$ transmission-remote −tall −ph1,2

Set all torrents’ files’ priorities to normal:

$ transmission-remote −tall −pnall

ENVIRONMENT
http_proxy

Sets the proxy to use for http tracker announces.

AUTHORS

Jordan Lee, Josh Elsasser, Eric Petit, and Mitchell Livingston.

SEE ALSO

transmission-create(1), transmission-daemon(1), transmission-edit(1), transmission-gtk(1), transmission-qt(1), transmission-remote(1), transmission-show(1)

https://transmissionbt.com/

BSD July 21, 2008 BSD

COMMENTS