| blob | f16d8655665f55cbbd04e87153483ee0ed7cffed |
1 .Dd July 21, 2008
2 .Dt TRANSMISSION-REMOTE 1
3 .Os
4 .Sh NAME
5 .Nm transmission-remote
6 .Nd a remote control utility for
7 .Xr transmission-daemon 1
8 and
9 .Xr transmission 1
10 .Sh SYNOPSIS
11 .Bk -words
12 .Nm
13 .Op Ar host:port | host | port
14 .Op Fl a Ar filenames-or-URLs
15 .Op Fl as
16 .Op Fl AS
17 .Op Fl asd Ar number
18 .Op Fl asu Ar number
19 .Op Fl asc
20 .Op Fl ASC
21 .Op Fl b
22 .Op Fl c Ar path | Fl C
23 .Op Fl d Ar number | Fl D
24 .Op Fl e Ar size
25 .Op Fl er | ep | et
26 .Op Fl -exit
27 .Op Fl f
28 .Op Fl g Ar files
29 .Op Fl G Ar files
30 .Op Fl gsr Ar ratio
31 .Op Fl GSR
32 .Op Fl h
33 .Op Fl i
34 .Op Fl l
35 .Op Fl m | M
36 .Op Fl n Ar user:pass
37 .Op Fl ne
38 .Op Fl N Ar netrc
39 .Op Fl o | O
40 .Op Fl p Ar port
41 .Op Fl Bh
42 .Op Fl Bn
43 .Op Fl \&Bl
44 .Op Fl ph Ar files
45 .Op Fl pl Ar files
46 .Op Fl pn Ar files
47 .Op Fl pr Ar peers
48 .Op Fl r
49 .Op Fl R
50 .Op Fl s | S
51 .Op Fl sr Ar ratio
52 .Op Fl SR
53 .Op Fl srd
54 .Op Fl si
55 .Op Fl st
56 .Op Fl t Ar all | Ar id | Ar hash
57 .Op Fl hl
58 .Op Fl HL
59 .Op Fl u Ar number | Fl U
60 .Op Fl v
61 .Op Fl V
62 .Op Fl w Ar download-dir
63 .Op Fl x | X
64 .Op Fl y | Y
65 .Op Fl pi
66 .Ek
67 .Sh DESCRIPTION
68 .Nm
69 is a remote control utility for
70 .Xr transmission 1
71 and
72 .Xr transmission-daemon 1 .
73 .Pp
74 By default,
75 .Nm
76 connects to the transmission session at localhost:9091.
77 Other sessions can be controlled by specifying a different host and/or port.
78 .Sh OPTIONS
79 .Bl -tag -width Ds
80 .It Fl a Fl -add Ar filenames-or-URLs
81 Add torrents to transmission.
82 .It Fl b Fl -debug
83 Enable debugging mode.
84 .It Fl as Fl -alt-speed
85 Use the alternate Limits.
86 .It Fl AS Fl -no-alt-speed
87 Don't use the alternate Limits.
88 .It Fl asd Fl -alt-speed-downlimit Ar limit
89 Limit the alternate download speed to
90 .Ar limit
91 kilobytes per second.
92 .It Fl asu Fl -alt-speed-uplimit Ar limit
93 Limit the alternate upload speed to
94 .Ar limit
95 kilobytes per second.
96 .It Fl asc Fl -alt-speed-scheduler
97 Use the scheduled on/off times.
98 .It Fl ASC Fl -no-alt-speed-scheduler
99 Don't use the scheduled on/off days and times.
100 .It Fl -alt-speed-time-begin Ar time
101 .Ar Time
102 to start using the alt speed limits (in hhmm).
103 .It Fl -alt-speed-time-end Ar time
104 .Ar Time
105 to stop using the alt speed limits (in hhmm).
106 .It Fl -alt-speed-days Ar days
107 Set the number of
108 .Ar days
109 on which to enable the speed scheduler, using a list such as "2,4-6".
110 .It Fl -torrent-done-script Ar filename
111 Specify a
112 .Ar file
113 to run each time a torrent finishes
114 .It Fl -no-torrent-done-script
115 Don't run any script when a torrent finishes
116 .It Fl c Fl -incomplete-dir Ar dir
117 When adding new torrents, store their contents in
118 .Ar directory
119 until the torrent is done.
120 .It Fl C Fl -no-incomplete-dir
121 Don't store incomplete torrents in a different directory.
122 .It Fl d Fl -downlimit Ar limit
123 Limit the maximum download speed to
124 .Ar limit
125 KiB/s.
126 If current torrent(s) are selected this operates on them. Otherwise, it changes the global setting.
127 .It Fl D Fl -no-downlimit
128 Disable download speed limits.
129 If current torrent(s) are selected this operates on them. Otherwise, it changes the global setting.
130 .It Fl e Fl -cache Ar size
131 Set the session's maximum memory cache size in MiB. This cache is used to reduce disk IO.
132 .It Fl er Fl -encryption-required
133 Encrypt all peer connections.
134 .It Fl ep Fl -encryption-preferred
135 Prefer encrypted peer connections.
136 .It Fl et Fl -encryption-tolerated
137 Prefer unencrypted peer connections.
138 .It Fl -exit
139 Tell the Transmission to initiate a shutdown.
140 .It Fl f Fl -files
141 Get a file list for the current torrent(s)
142 .It Fl g Fl -get Ar all | file-index | files
143 Mark file(s) for download.
144 .Ar all
145 marks all all of the torrent's files for downloading,
146 .Ar file-index
147 adds a single file to the download list, and
148 .Ar files
149 adds multiple files to the download list,
150 such as "\-g1,3-5" to add files #1, #3, #4, and #5 to the download list.
151 .It Fl G Fl -no-get Ar all | file-index | files
152 Mark file(s) for not downloading.
153 .It Fl gsr Fl -global-seedratio Ar ratio
154 All torrents, unless overridden by a per-torrent setting, should seed until a specific
155 .Ar ratio
156 .It Fl GSR Fl -no-global-seedratio
157 All torrents, unless overridden by a per-torrent setting, should seed regardless of ratio
158 .It Fl h Fl -help
159 Print command-line option descriptions.
160 .It Fl i Fl -info Ar id | torrent-hash
161 Show details of the current torrent(s)
162 .It Fl si Fl -session-info
163 List session information from the server
164 .It Fl st Fl -session-stats
165 List statistical information from the server
166 .It Fl l Fl -list
167 List all torrents
168 .It Fl m Fl -portmap
169 Enable portmapping via NAT-PMP or UPnP
170 .It Fl M Fl -no-portmap
171 Disable portmapping
172 .It Fl n Fl -auth Ar username:password
173 Set the
174 .Ar username
175 and
176 .Ar password
177 for authentication
178 .It Fl ne Fl -authenv
179 Set the authentication information from the
180 .Ar TR_AUTH
181 environment variable which must be formatted as
182 .Ar username:password.
183 .It Fl N Fl -netrc Ar filename
184 Set the authentication information from a
185 .Ar netrc file.
186 See netrc(5) for more information.
187 .It Fl o Fl -dht
188 Enable distributed hash table (DHT).
189 .It Fl O Fl -no-dht
190 Disable distribued hash table (DHT).
191 .It Fl p Fl -port Ar port
192 Set the
193 .Ar port
194 for use when listening for incoming peer connections
195 .It Fl Bh Fl -bandwidth-high
196 Give this torrent first chance at available bandwidth
197 .It Fl Bn Fl -bandwidth-normal
198 Give this torrent the bandwidth left over by high priority torrents
199 .It Fl \&Bl Fl -bandwidth-low
200 Give this torrent the bandwidth left over by high and normal priority torrents
201 .It Fl ph Fl -priority-high Ar all | file-index | files
202 Try to download the specified file(s) first.
203 .Ar all
204 marks all of the torrent's files as normal priority,
205 .Ar file-index
206 sets a single file's priority as normal, and
207 .Ar files
208 sets multiple files' priorities as normal,
209 such as "\-pn1,3-5" to normalize files #1, #3, #4, and #5.
210 .It Fl pn Fl -priority-normal Ar all | file-index | files
211 Try to download the specified files normally.
212 .It Fl pl Fl -priority-low Ar all | file-index | files
213 Try to download the specified files last
214 .It Fl pr Fl -peers Ar number
215 Set the maximum number of peers.
216 If current torrent(s) are selected this operates on them. Otherwise, it changes the global setting.
217 .It Fl r Fl -remove
218 Remove the current torrent(s). This does not delete the downloaded data.
219 .It Fl -remove-and-delete
220 Remove the current torrent(s) and delete their downloaded data.
221 .It Fl -reannounce
222 Reannounce the current torrent(s). This is the same as the GUI's "ask tracker for more peers" button.
223 .It Fl -move
224 Move the current torrents' data from their current locations to the specified directory.
225 .It Fl -find
226 Tell Transmission where to look for the current torrents' data.
227 .It Fl sr Fl -seedratio Ar ratio
228 Let the current torrent(s) seed until a specific
229 .Ar ratio
230 .It Fl SR Fl -no-seedratio
231 Let the current torrent(s) seed regardless of ratio
232 .It Fl srd Fl -seedratio-default
233 Let the current torrent(s) use the global seedratio settings
234 .It Fl td Fl -tracker-add Ar tracker
235 Add a tracker to a torrent
236 .It Fl tr Fl -tracker-remove Ar trackerId
237 Remove a tracker from a torrent
238 .It Fl s Fl -start
239 Start the current torrent(s)
240 .It Fl S Fl -stop
241 Stop the current torrent(s) from downloading or seeding
242 .It Fl -start-paused
243 Start added torrents paused
244 .It Fl -no-start-paused
245 Start added torrents unpaused
246 .It Fl t Fl -torrent Ar all | id | torrent-hash
247 Set the current torrent(s) for use by subsequent options.
248 .Ar all
249 will apply following requests to all torrents, while specific torrents can be chosen by
250 .Ar id
251 or
252 .Ar hash .
253 To set more than one current torrent, join their ids together in a list, such as
254 "\-t2,4,6-8" to operate on the torrents whose IDs are 2, 4, 6, 7, and 8.
255 .It Fl -trash-torrent
256 Delete torrents after adding
257 .It Fl -no-trash-torrent
258 Do not delete torrents after adding
259 .It Fl hl Fl -honor-session
260 Make the current torrent(s) honor the session limits.
261 .It Fl HL Fl -no-honor-session
262 Make the current torrent(s) not honor the session limits.
263 .It Fl u Fl -uplimit Ar limit
264 Limit the maximum upload speed to
265 .Ar limit
266 KiB/s.
267 If current torrent(s) are selected this operates on them. Otherwise, it changes the global setting.
268 .It Fl U Fl -no-uplimit
269 Disable upload speed limits.
270 If current torrent(s) are selected this operates on them. Otherwise, it changes the global setting.
271 .It Fl v Fl -verify
272 Verify the current torrent(s)
273 .It Fl V Fl -version
274 Show version number and exit
275 .It Fl w Fl -download-dir Ar directory
276 Use
277 .Ar directory
278 as the default location for newly added torrents to download files to.
279 .It Fl x Fl -pex
280 Enable peer exchange (PEX).
281 .It Fl X Fl -no-pex
282 Disable peer exchange (PEX).
283 .It Fl y Fl -lds
284 Enable local peer discovery (LPD).
285 .It Fl Y Fl -no-lds
286 Disable local peer discovery (LPD).
287 .It Fl pi Fl -peer-info
288 List the current torrent's connected peers.
289 In the `status' section of the list, the following shorthand is used:
290 .D1 D: Downloading from this peer
291 .D1 d: We would download from this peer if they would let us
292 .D1 E: Encrypted connection
293 .D1 I: Peer is an incoming connection
294 .D1 K: Peer has unchoked us, but we're not interested
295 .D1 O: Optimistic unchoked
296 .D1 U: Uploading to peer
297 .D1 u: We would upload to this peer if they asked
298 .D1 X: Peer was discovered through Peer Exchange (PEX)
299 .D1 ?: We unchoked this peer, but they're not interested
300 .El
301 .Sh EXAMPLES
302 Set download and upload limits to 400 KiB/sec and 60 KiB/sec:
303 .Bd -literal -offset indent
304 $ transmission-remote \-d400 \-u60
305 $ transmission-remote \-\-downlimit=400 \-\-uplimit=60
306 .Ed
307 Set alternate download and upload limits to 100 KiB/sec and 20 KiB/sec:
308 .Bd -literal -offset indent
309 $ transmission-remote \-asd100 \-asu20
310 $ transmission-remote \-\-alt-speed-downlimit=100 \-\-alt-speed-uplimit=20
311 .Ed
312 Set the scheduler to use the alternate speed limits on weekdays between 10AM and 11PM
313 .Bd -literal -offset indent
314 $ transmission-remote \-\-alt-speed-time-begin=1000
315 $ transmission-remote \-\-alt-speed-time-end=2300
316 $ transmission-remote \-\-alt-speed-days=1-5
317 $ transmission-remote \-\-alt-speed-scheduler
318 .Ed
319 List all torrents' IDs and states:
320 .Bd -literal -offset indent
321 $ transmission-remote \-l
322 .Ed
323 List all torrents from a remote session that requires authentication:
324 .Bd -literal -offset indent
325 $ transmission-remote host:9091 \-\-auth=username:password \-l
326 .Ed
327 Start all torrents:
328 .Bd -literal -offset indent
329 $ transmission-remote \-tall \-\-start
330 .Ed
331 Add two torrents:
332 .Bd -literal -offset indent
333 $ transmission-remote \-a one.torrent two.torrent
334 .Ed
335 Add all torrents in ~/Desktop:
336 .Bd -literal -offset indent
337 $ transmission-remote \-a ~/Desktop/*torrent
338 .Ed
339 Get detailed information on the torrent whose ID is '1':
340 .Bd -literal -offset indent
341 $ transmission-remote \-t1 \-i
342 .Ed
343 Get a list of a torrent's files:
344 .Bd -literal -offset indent
345 $ transmission-remote \-t1 \-f
346 .Ed
347 Download only its second and fourth files:
348 .Bd -literal -offset indent
349 $ transmission-remote \-t1 \-Gall \-g2,4
350 .Ed
351 Set all torrents' first two files' priorities to high:
352 .Bd -literal -offset indent
353 $ transmission-remote \-tall \-ph1,2
354 .Ed
355 Set all torrents' files' priorities to normal:
356 .Bd -literal -offset indent
357 $ transmission-remote \-tall \-pnall
358 .Ed
359 .Sh ENVIRONMENT
360 .Bl -tag -width Fl
361 .It Ev http_proxy
362 Sets the proxy to use for http tracker announces.
363 .El
364 .Sh AUTHORS
365 .An -nosplit
366 .An Jordan Lee ,
367 .An Josh Elsasser ,
368 .An Eric Petit ,
369 and
370 .An Mitchell Livingston .
371 .Sh SEE ALSO
372 .Xr transmission-create 1 ,
373 .Xr transmission-daemon 1 ,
374 .Xr transmission-edit 1 ,
375 .Xr transmission-gtk 1 ,
376 .Xr transmission-qt 1 ,
377 .Xr transmission-remote 1 ,
378 .Xr transmission-show 1
379 .Pp
380 http://www.transmissionbt.com/