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] |
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.
-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.
List all torrents:
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:
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
http_proxy- Sets the proxy to use for http tracker announces.
Jordan Lee, Josh
Elsasser, Eric Petit, and
Mitchell Livingston.