2 .Dt TRANSMISSION-REMOTE 1
5 .Nm transmission-remote
6 .Nd a remote control utility for
7 .Xr transmission-daemon 1
13 .Op Ar host:port | host | port
14 .Op Fl a Ar filenames-or-URLs
22 .Op Fl c Ar path | Fl C
23 .Op Fl d Ar number | Fl D
56 .Op Fl t Ar all | Ar id | Ar hash
59 .Op Fl u Ar number | Fl U
63 .Op Fl w Ar download-dir
70 is a remote control utility for
73 .Xr transmission-daemon 1 .
77 connects to the transmission session at localhost:9091.
78 Other sessions can be controlled by specifying a different host and/or port.
81 .It Fl a Fl -add Ar filenames-or-URLs
82 Add torrents to transmission.
84 Enable debugging mode.
85 .It Fl as Fl -alt-speed
86 Use the alternate Limits.
87 .It Fl AS Fl -no-alt-speed
88 Don't use the alternate Limits.
89 .It Fl asd Fl -alt-speed-downlimit Ar limit
90 Limit the alternate download speed to
93 .It Fl asu Fl -alt-speed-uplimit Ar limit
94 Limit the alternate upload speed to
97 .It Fl asc Fl -alt-speed-scheduler
98 Use the scheduled on/off times.
99 .It Fl ASC Fl -no-alt-speed-scheduler
100 Don't use the scheduled on/off days and times.
101 .It Fl -alt-speed-time-begin Ar time
103 to start using the alt speed limits (in hhmm).
104 .It Fl -alt-speed-time-end Ar time
106 to stop using the alt speed limits (in hhmm).
107 .It Fl -alt-speed-days Ar days
110 on which to enable the speed scheduler, using a list such as "2,4-6".
111 .It Fl -torrent-done-script Ar filename
114 to run each time a torrent finishes
115 .It Fl -no-torrent-done-script
116 Don't run any script when a torrent finishes
117 .It Fl c Fl -incomplete-dir Ar dir
118 When adding new torrents, store their contents in
120 until the torrent is done.
121 .It Fl C Fl -no-incomplete-dir
122 Don't store incomplete torrents in a different directory.
123 .It Fl d Fl -downlimit Ar limit
124 Limit the maximum download speed to
127 If current torrent(s) are selected this operates on them. Otherwise, it changes the global setting.
128 .It Fl D Fl -no-downlimit
129 Disable download speed limits.
130 If current torrent(s) are selected this operates on them. Otherwise, it changes the global setting.
131 .It Fl e Fl -cache Ar size
132 Set the session's maximum memory cache size in MiB. This cache is used to reduce disk IO.
133 .It Fl er Fl -encryption-required
134 Encrypt all peer connections.
135 .It Fl ep Fl -encryption-preferred
136 Prefer encrypted peer connections.
137 .It Fl et Fl -encryption-tolerated
138 Prefer unencrypted peer connections.
140 Tell the Transmission to initiate a shutdown.
142 Get a file list for the current torrent(s)
143 .It Fl g Fl -get Ar all | file-index | files
144 Mark file(s) for download.
146 marks all all of the torrent's files for downloading,
148 adds a single file to the download list, and
150 adds multiple files to the download list,
151 such as "\-g1,3-5" to add files #1, #3, #4, and #5 to the download list.
152 .It Fl G Fl -no-get Ar all | file-index | files
153 Mark file(s) for not downloading.
154 .It Fl gsr Fl -global-seedratio Ar ratio
155 All torrents, unless overridden by a per-torrent setting, should seed until a specific
157 .It Fl GSR Fl -no-global-seedratio
158 All torrents, unless overridden by a per-torrent setting, should seed regardless of ratio
160 Print command-line option descriptions.
161 .It Fl i Fl -info Ar id | torrent-hash
162 Show details of the current torrent(s)
163 .It Fl si Fl -session-info
164 List session information from the server
165 .It Fl st Fl -session-stats
166 List statistical information from the server
170 Enable portmapping via NAT-PMP or UPnP
171 .It Fl M Fl -no-portmap
173 .It Fl n Fl -auth Ar username:password
179 .It Fl ne Fl -authenv
180 Set the authentication information from the
182 environment variable which must be formatted as
183 .Ar username:password.
184 .It Fl N Fl -netrc Ar filename
185 Set the authentication information from a
187 See netrc(5) for more information.
189 Enable distributed hash table (DHT).
191 Disable distribued hash table (DHT).
192 .It Fl p Fl -port Ar port
195 for use when listening for incoming peer connections
196 .It Fl Bh Fl -bandwidth-high
197 Give this torrent first chance at available bandwidth
198 .It Fl Bn Fl -bandwidth-normal
199 Give this torrent the bandwidth left over by high priority torrents
200 .It Fl \&Bl Fl -bandwidth-low
201 Give this torrent the bandwidth left over by high and normal priority torrents
202 .It Fl ph Fl -priority-high Ar all | file-index | files
203 Try to download the specified file(s) first.
205 marks all of the torrent's files as normal priority,
207 sets a single file's priority as normal, and
209 sets multiple files' priorities as normal,
210 such as "\-pn1,3-5" to normalize files #1, #3, #4, and #5.
211 .It Fl pn Fl -priority-normal Ar all | file-index | files
212 Try to download the specified files normally.
213 .It Fl pl Fl -priority-low Ar all | file-index | files
214 Try to download the specified files last
215 .It Fl pr Fl -peers Ar number
216 Set the maximum number of peers.
217 If current torrent(s) are selected this operates on them. Otherwise, it changes the global setting.
219 Remove the current torrent(s). This does not delete the downloaded data.
220 .It Fl -remove-and-delete
221 Remove the current torrent(s) and delete their downloaded data.
223 Reannounce the current torrent(s). This is the same as the GUI's "ask tracker for more peers" button.
225 Move the current torrents' data from their current locations to the specified directory.
227 Tell Transmission where to look for the current torrents' data.
228 .It Fl sr Fl -seedratio Ar ratio
229 Let the current torrent(s) seed until a specific
231 .It Fl SR Fl -no-seedratio
232 Let the current torrent(s) seed regardless of ratio
233 .It Fl srd Fl -seedratio-default
234 Let the current torrent(s) use the global seedratio settings
235 .It Fl td Fl -tracker-add Ar tracker
236 Add a tracker to a torrent
237 .It Fl tr Fl -tracker-remove Ar trackerId
238 Remove a tracker from a torrent
240 Start the current torrent(s)
242 Stop the current torrent(s) from downloading or seeding
244 Start added torrents paused
245 .It Fl -no-start-paused
246 Start added torrents unpaused
247 .It Fl t Fl -torrent Ar all | id | torrent-hash
248 Set the current torrent(s) for use by subsequent options.
250 will apply following requests to all torrents, while specific torrents can be chosen by
254 To set more than one current torrent, join their ids together in a list, such as
255 "\-t2,4,6-8" to operate on the torrents whose IDs are 2, 4, 6, 7, and 8.
256 .It Fl -trash-torrent
257 Delete torrents after adding
258 .It Fl -no-trash-torrent
259 Do not delete torrents after adding
260 .It Fl hl Fl -honor-session
261 Make the current torrent(s) honor the session limits.
262 .It Fl HL Fl -no-honor-session
263 Make the current torrent(s) not honor the session limits.
264 .It Fl u Fl -uplimit Ar limit
265 Limit the maximum upload speed to
268 If current torrent(s) are selected this operates on them. Otherwise, it changes the global setting.
269 .It Fl U Fl -no-uplimit
270 Disable upload speed limits.
272 Enable uTP for peer connections.
274 Disable uTP for peer connections.
275 If current torrent(s) are selected this operates on them. Otherwise, it changes the global setting.
277 Verify the current torrent(s)
279 Show version number and exit
280 .It Fl w Fl -download-dir Ar directory
283 as the default location for newly added torrents to download files to.
285 Enable peer exchange (PEX).
287 Disable peer exchange (PEX).
289 Enable local peer discovery (LPD).
291 Disable local peer discovery (LPD).
292 .It Fl pi Fl -peer-info
293 List the current torrent's connected peers.
294 In the `status' section of the list, the following shorthand is used:
295 .D1 D: Downloading from this peer
296 .D1 d: We would download from this peer if they would let us
297 .D1 E: Encrypted connection
298 .D1 H: Peer was found through DHT
299 .D1 I: Peer is an incoming connection
300 .D1 K: Peer has unchoked us, but we're not interested
301 .D1 O: Optimistic unchoked
302 .D1 T: Peer is connected over uTP
303 .D1 U: Uploading to peer
304 .D1 u: We would upload to this peer if they asked
305 .D1 X: Peer was discovered through Peer Exchange (PEX)
306 .D1 ?: We unchoked this peer, but they're not interested
309 Set download and upload limits to 400 KiB/sec and 60 KiB/sec:
310 .Bd -literal -offset indent
311 $ transmission-remote \-d400 \-u60
312 $ transmission-remote \-\-downlimit=400 \-\-uplimit=60
314 Set alternate download and upload limits to 100 KiB/sec and 20 KiB/sec:
315 .Bd -literal -offset indent
316 $ transmission-remote \-asd100 \-asu20
317 $ transmission-remote \-\-alt-speed-downlimit=100 \-\-alt-speed-uplimit=20
319 Set the scheduler to use the alternate speed limits on weekdays between 10AM and 11PM
320 .Bd -literal -offset indent
321 $ transmission-remote \-\-alt-speed-time-begin=1000
322 $ transmission-remote \-\-alt-speed-time-end=2300
323 $ transmission-remote \-\-alt-speed-days=1-5
324 $ transmission-remote \-\-alt-speed-scheduler
326 List all torrents' IDs and states:
327 .Bd -literal -offset indent
328 $ transmission-remote \-l
330 List all torrents from a remote session that requires authentication:
331 .Bd -literal -offset indent
332 $ transmission-remote host:9091 \-\-auth=username:password \-l
335 .Bd -literal -offset indent
336 $ transmission-remote \-tall \-\-start
339 .Bd -literal -offset indent
340 $ transmission-remote \-a one.torrent two.torrent
342 Add all torrents in ~/Desktop:
343 .Bd -literal -offset indent
344 $ transmission-remote \-a ~/Desktop/*torrent
346 Get detailed information on the torrent whose ID is '1':
347 .Bd -literal -offset indent
348 $ transmission-remote \-t1 \-i
350 Get a list of a torrent's files:
351 .Bd -literal -offset indent
352 $ transmission-remote \-t1 \-f
354 Download only its second and fourth files:
355 .Bd -literal -offset indent
356 $ transmission-remote \-t1 \-Gall \-g2,4
358 Set all torrents' first two files' priorities to high:
359 .Bd -literal -offset indent
360 $ transmission-remote \-tall \-ph1,2
362 Set all torrents' files' priorities to normal:
363 .Bd -literal -offset indent
364 $ transmission-remote \-tall \-pnall
369 Sets the proxy to use for http tracker announces.
377 .An Mitchell Livingston .
379 .Xr transmission-create 1 ,
380 .Xr transmission-daemon 1 ,
381 .Xr transmission-edit 1 ,
382 .Xr transmission-gtk 1 ,
383 .Xr transmission-qt 1 ,
384 .Xr transmission-remote 1 ,
385 .Xr transmission-show 1
387 http://www.transmissionbt.com/