logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

transmission-remote — a remote control utility for transmission-daemon(1) and transmission(1)

Authors

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

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.

Environment

       http_proxy  Sets the proxy to use for http tracker announces.

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

Name

       transmission-remote — a remote control utility for transmission-daemon(1) and transmission(1)

Options

-a--addfilenames-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-downlimitlimit
               Limit the alternate download speed to limit kilobytes per second.

       -asu--alt-speed-uplimitlimit
               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-begintimeTime to start using the alt speed limits (in hhmm).

       --alt-speed-time-endtimeTime to stop using the alt speed limits (in hhmm).

       --alt-speed-daysdays
               Set the number of days on which to enable the speed scheduler, using a list such as "2,4-6".

       --torrent-done-scriptfilename
               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-dirdir
               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--downlimitlimit
               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--cachesize
               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--getall | 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--filterfilter
               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-getall | file-index | files
               Mark file(s) for not downloading.

       -gsr--global-seedratioratio
               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--labelslabel1[,label2[,...]]
               Set the specified torrent's labels

       -m--portmap
               Enable portmapping via NAT-PMP or UPnP

       -M--no-portmap
               Disable portmapping

       -n--authusername: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--netrcfilename
               Set the authentication information from a netrcfile. See netrc(5) for more information.

       -o--dht
               Enable distributed hash table (DHT).

       -O--no-dht
               Disable distributed hash table (DHT).

       -p--portport
               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-highall | 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-normalall | file-index | files
               Try to download the specified files normally.

       -pl--priority-lowall | file-index | files
               Try to download the specified files last

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

       --renamenewname
               Rename files or root folder of a torrent

       --patholdname
               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--seedratioratio
               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-addtracker
               Add a tracker to a torrent

       -tr--tracker-removetrackerId
               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--torrentall | 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--uplimitlimit
               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-dirdirectory
               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.

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/

Debian                                            July 21, 2008                           TRANSMISSION-REMOTE(1)

Synopsis

transmission-remote  [host:port  |  host  |  port]  [-afilenames-or-URLs]  [-as]  [-AS]  [-asdnumber]
                           [-asunumber] [-asc] [-ASC]  [-b]  [-cpath  |  -C]  [-dnumber  |  -D]  [-esize]
                           [-er | -ep | -et] [--exit] [-f] [-Ffilter] [-gfiles] [-Gfiles] [-gsrratio] [-GSR]
                           [-h]  [-i]  [-ic]  [-ids]  [-if] [-ip] [-it] [-j] [-l] [-m | -M] [-nuser:pass] [-ne]
                           [-Nnetrc] [-o | -O] [-pport] [-Bh] [-Bn] [-Bl] [-phfiles] [-plfiles] [-pnfiles]
                           [-prpeers]   [-r]   [-rad]  [-s  |  -S]  [-srratio]  [-SR]  [-srd]  [-si]  [-st]
                           [-tall | active | id | hash] [-hl] [-HL] [-unumber | -U] [-utp | -no-utp] [-v] [-V]
                           [-wdownload-dir] [-x | -X] [-y | -Y] [-pi]

See Also