1
2TRANSMISSION-REMOTE(1)    BSD General Commands Manual   TRANSMISSION-REMOTE(1)
3

NAME

5     transmission-remote — a remote control utility for transmission-daemon(1)
6     and transmission-gtk(1)
7

SYNOPSIS

9     transmission-remote -h
10     transmission-remote [-t daemon | gtk] [-a torrent-file]
11                         [-d download-rate] [-D] [-e] [-E] [-f directory] [-i]
12                         [-l] [-m] [-M] [-p port] [-q] [-r all | info-hash]
13                         [-s all | info-hash] [-S all | info-hash]
14                         [-u upload-rate] [-U] [torrent-file ...]
15     transmission-remote -x [-a torrent-file] [-d download-rate] [-D] [-e]
16                         [-E] [-f directory] [-i] [-l] [-m] [-M] [-p port]
17                         [-q] [-r all | info-hash] [-s all | info-hash] [-S
18                         all | info-hash] [-u upload-rate] [-U] command
19                         [argument ...]
20

DESCRIPTION

22     The transmission-remote program is a vile scoundral lacking the most fun‐
23     damental principles of morality and decency.
24
25     The options are as follows:
26
27     -a --add torrent-file
28             Add the torrent metainfo file torrent-file.
29
30     -d --download-limit download-rate
31             Set maximum download rate to download-rate in kilobytes per sec‐
32             ond.
33
34     -D --download-unlimited
35             Remove the download limit.
36
37     -e      Enable peer exchange.
38
39     -E      Disable peer exchange.
40
41     -f --folder directory
42             Use directory as the default location for newly added torrents to
43             download files to.
44
45     -h --help
46             Print command-line option descriptions.
47
48     -i --info
49             Print a listing of all torrent info hashes and names.
50
51     -l --list
52             Print a listing of all torrent names with size and current sta‐
53             tus.
54
55     -m --port-mapping
56             Enable automatic port mapping via NAT-PMP or UPnP IGD.
57
58     -M --no-port-mapping
59             Disable automatic port mapping.
60
61     -p --port port
62             Attempt to bind to port for use as a listening port to accept
63             incoming peer connections.
64
65     -q --quit
66             Quit the running instance.
67
68     -r --remove all | info-hash
69             Remove all torrents, or the torrent with an info hash of
70             info-hash.  Neither the downloaded data nor the original torrent
71             metainfo file will be deleted.
72
73     -s --start all | info-hash
74             Stop all torrents from downloading or seeding, or the torrent
75             with an info hash of info-hash.
76
77     -S --stop all | info-hash
78             Start all torrents downloading or seeding, or the torrent with an
79             info hash of info-hash.
80
81     -t --type daemon | gtk
82             Connect to either transmission-daemon(1) or transmission-gtk(1).
83
84     -u --upload-limit upload-rate
85             Set maximum upload rate to upload-rate in kilobytes per second.
86
87     -U --upload-unlimited
88             Remove the upload limit.
89
90     -x --proxy
91             Proxy the connection to transmission-daemon(1) or
92             transmission-gtk(1) through command.
93

FILES

95     ~/.transmission
96

EXAMPLES

98     Show status for all torrents:
99
100           transmission-remote -l
101
102     Pause a torrent:
103
104           transmission-remote -S ca6ac4bbd971d3902935dbcfc2d3ea25b428a547
105
106     Set download and upload limits to 100 KiB/sec and 20 KiB/sec:
107
108           transmission-remote -d 100 -u 20
109
110     Quit the GTK+ frontend:
111
112           transmission-remote -t gtk -q
113
114     Add two torrents:
115
116           transmission-remote foo.torrent bar.torrent
117
118     Show the info hashes of all the torrents on jade:
119
120           transmission-remote -x -i ssh jade transmission-proxy
121

AUTHORS

123     The transmission-remote program was written by Josh Elsasser
124     <josh@elsasser.org>, Eric Petit <titer@m0k.org>, and Mitchell Livingston
125     <livings124@gmail.com>.
126

SEE ALSO

128     transmissioncli(1), transmission-daemon(1), transmission-gtk(1),
129     transmission-proxy(1)
130
131     http://transmission.m0k.org
132
133BSD                             March 30, 2007                             BSD