DragonFly On-Line Manual Pages
TRANSMISSION-REMOTE(1) DragonFly General Commands Manual
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] [-ic] [-if] [-ip] [-it]
[-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 | 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.
-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
-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.
-R --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 | 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
EXAMPLES
List all torrents:
$ transmission-remote -l
List all active torrents:
$ transmission-remote -tactive -l
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/
DragonFly 6.5-DEVELOPMENT July 21, 2008 DragonFly 6.5-DEVELOPMENT