Provided by: transmission-cli_2.51-0ubuntu1_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] [-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:

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

     http://www.transmissionbt.com/