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]
[-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]
[-R]
[-s | -S]
[-sr ratio]
[-SR]
[-srd]
[-si]
[-st]
[-t all | 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 id |
torrent-hash
- Show details of the current torrent(s)
- -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.
- --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 |
id | torrent-hash
- Set the current torrent(s) for use by subsequent options.
all will apply following requests to all torrents,
while 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
- Use directory as the default location
for newly added torrents to download files to.
- -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
EXAMPLES¶
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
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)
http://www.transmissionbt.com/