Scroll to navigation

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

NAME

transmission-remotea remote control utility for transmission-daemon(1) and transmission(1)

SYNOPSIS

transmission-remote [host:porthost | 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] [-F filter] [-g files] [-G files] [-gsr ratio] [-GSR] [-h] [-i] [-ic] [-ids] [-if] [-ip] [-it] [-j] [-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

--add filenames-or-URLs
Add torrents to transmission.
--debug
Enable debugging mode.
--alt-speed
Use the alternate Limits.
--no-alt-speed
Don't use the alternate Limits.
--alt-speed-downlimit limit
Limit the alternate download speed to limit kilobytes per second.
--alt-speed-uplimit limit
Limit the alternate upload speed to limit kilobytes per second.
--alt-speed-scheduler
Use the scheduled on/off times.
--no-alt-speed-scheduler
Don't use the scheduled on/off days and times.
time
Time to start using the alt speed limits (in hhmm).
time
Time to stop using the alt speed limits (in hhmm).
days
Set the number of days on which to enable the speed scheduler, using a list such as "2,4-6".
filename
Specify a file to run each time a torrent finishes
Don't run any script when a torrent finishes
--incomplete-dir dir
When adding new torrents, store their contents in directory until the torrent is done.
--no-incomplete-dir
Don't store incomplete torrents in a different directory.
--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.
--no-downlimit
Disable download speed limits. If current torrent(s) are selected this operates on them. Otherwise, it changes the global setting.
--cache size
Set the session's maximum memory cache size in MiB. This cache is used to reduce disk IO.
--encryption-required
Encrypt all peer connections.
--encryption-preferred
Prefer encrypted peer connections.
--encryption-tolerated
Prefer unencrypted peer connections.
Tell the Transmission to initiate a shutdown.
--files
Get a file list for the current torrent(s)
--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.
--filter filter
Filter selected torrents. Further commands will use only torrents that satisfy the filter condition.
i - currently idle
u - currently uploading
d - currently downloading
n:str - torrent name includes str
l:label - has label
r:ratio - Minimum upload ratio
w - Have some unwanted files
Prefixing the filter by "~" negates the filter. -F may be specified more than once, and may be preceded by -t. Only torrents that satisfy all the conditions are selected.
--no-get all | file-index | files
Mark file(s) for not downloading.
--global-seedratio ratio
All torrents, unless overridden by a per-torrent setting, should seed until a specific ratio
--no-global-seedratio
All torrents, unless overridden by a per-torrent setting, should seed regardless of ratio
--help
Print command-line option descriptions.
--info
Show details of the current torrent(s)
--info-files
List the specified torrent's files
--info-peers
List the specified torrent's peers
--info-pieces
List the specified torrent's pieces
--info-trackers
List the specified torrent's trackers
--json
Return the RPC response as JSON
--session-info
List session information from the server
--session-stats
List statistical information from the server
--list
List all torrents
--print-ids
Print a list of the specified torrent's ids in a format suitable as a parameter for -t
--labels label1[,label2[,...]]
Set the specified torrent's labels
--portmap
Enable portmapping via NAT-PMP or UPnP
--no-portmap
Disable portmapping
--auth username:password
Set the username and password for authentication
--authenv
Set the authentication information from the TR_AUTH environment variable which must be formatted as username:password.
--netrc filename
Set the authentication information from a netrc file. See netrc(5) for more information.
--dht
Enable distributed hash table (DHT).
--no-dht
Disable distributed hash table (DHT).
--port port
Set the port for use when listening for incoming peer connections
--bandwidth-high
Give this torrent first chance at available bandwidth
--bandwidth-normal
Give this torrent the bandwidth left over by high priority torrents
--bandwidth-low
Give this torrent the bandwidth left over by high and normal priority torrents
--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.
--priority-normal all | file-index | files
Try to download the specified files normally.
--priority-low all | file-index | files
Try to download the specified files last
--peers number
Set the maximum number of peers. If current torrent(s) are selected this operates on them. Otherwise, it changes the global setting.
--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 the current torrent(s). This is the same as the GUI's "ask tracker for more peers" button.
Move the current torrents' data from their current locations to the specified directory.
newname
Rename files or root folder of a torrent
oldname
Provide original path for the rename command
Connect using a Unix domain socket.
Tell Transmission where to look for the current torrents' data.
--seedratio ratio
Let the current torrent(s) seed until a specific ratio
--no-seedratio
Let the current torrent(s) seed regardless of ratio
--seedratio-default
Let the current torrent(s) use the global seedratio settings
--tracker-add tracker
Add a tracker to a torrent
--tracker-remove trackerId
Remove a tracker from a torrent
--start
Start the current torrent(s)
--stop
Stop the current torrent(s) from downloading or seeding
Start added torrents paused
Start added torrents unpaused
--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.
Delete torrents after adding
Do not delete torrents after adding
--honor-session
Make the current torrent(s) honor the session limits.
--no-honor-session
Make the current torrent(s) not honor the session limits.
--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.
--no-uplimit
Disable upload speed limits.
Enable uTP for peer connections.
Disable uTP for peer connections. If current torrent(s) are selected this operates on them. Otherwise, it changes the global setting.
--verify
Verify the current torrent(s)
--version
Show version number and exit
--download-dir directory
When used in conjunction with --add, set the new torrent's download folder. Otherwise, set the default download folder.
--pex
Enable peer exchange (PEX).
--no-pex
Disable peer exchange (PEX).
--lds
Enable local peer discovery (LPD).
--no-lds
Disable local peer discovery (LPD).
--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
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
List all torrents with label "abc":
$ transmission-remote -F l:abc -l
List all torrents with name containing "def" or with label "abc":
$ transmission-remote -t $( transmission-remote -F n:def -ids )$( transmission-remote -F l:abc -ids ) -l
Rename torrent root folder from "test1/examplefile.txt" to "test2/examplefile.txt"
$ transmission-remote -t1 --path test1 --rename test2
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

Sets the proxy to use for http tracker announces.

AUTHORS

Charles Kerr, Josh Elsasser, Eric Petit, Mitchell Livingston, and Mike Gelfand.

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/

July 21, 2008 Debian