Provided by: transmission-cli_4.0.2-1ubuntu3_amd64 bug

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] [-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

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

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

     -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

     -j --json
             Return the RPC response as JSON

     -si --session-info
             List session information from the server

     -st --session-stats
             List statistical information from the server

     -l --list
             List all torrents

     -ids --print-ids
             Print a list of the specified torrent's ids in a format suitable as a parameter for
             -t

     -L --labels label1[,label2[,...]]
             Set the specified torrent's labels

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

     --rename newname
             Rename files or root folder of a torrent

     --path oldname
             Provide original path for the rename command

     --unix-socket
             Connect using a Unix domain socket.

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

     http_proxy  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/