1TRANSMISSION-REMOTE(1) BSD General Commands Manual TRANSMISSION-REMOTE(1)
2
4 transmission-remote — a remote control utility for transmission-daemon(1)
5 and transmission(1)
6
8 transmission-remote [host:port | host | port] [-a filenames-or-URLs]
9 [-as] [-AS] [-asd number] [-asu number] [-asc] [-ASC]
10 [-b] [-c path | -C] [-d number | -D] [-e size]
11 [-er | -ep | -et] [--exit] [-f] [-g files] [-G files]
12 [-gsr ratio] [-GSR] [-h] [-i] [-ic] [-if] [-ip] [-it]
13 [-l] [-m | -M] [-n user:pass] [-ne] [-N netrc]
14 [-o | -O] [-p port] [-Bh] [-Bn] [-Bl] [-ph files]
15 [-pl files] [-pn files] [-pr peers] [-r] [-rad]
16 [-s | -S] [-sr ratio] [-SR] [-srd] [-si] [-st]
17 [-t all | active | id | hash] [-hl] [-HL]
18 [-u number | -U] [-utp | -no-utp] [-v] [-V]
19 [-w download-dir] [-x | -X] [-y | -Y] [-pi]
20
22 transmission-remote is a remote control utility for transmission(1) and
23 transmission-daemon(1).
24 By default, transmission-remote connects to the transmission session at
26 localhost:9091. Other sessions can be controlled by specifying a differ‐
27 ent host and/or port.
28
30 -a --add filenames-or-URLs
31 Add torrents to transmission.
32 -b --debug
34 Enable debugging mode.
35 -as --alt-speed
37 Use the alternate Limits.
38 -AS --no-alt-speed
40 Don't use the alternate Limits.
41 -asd --alt-speed-downlimit limit
43 Limit the alternate download speed to limit kilobytes per second.
44 -asu --alt-speed-uplimit limit
46 Limit the alternate upload speed to limit kilobytes per second.
47 -asc --alt-speed-scheduler
49 Use the scheduled on/off times.
50 -ASC --no-alt-speed-scheduler
52 Don't use the scheduled on/off days and times.
53 --alt-speed-time-begin time
55 Time to start using the alt speed limits (in hhmm).
56 --alt-speed-time-end time
58 Time to stop using the alt speed limits (in hhmm).
59 --alt-speed-days days
61 Set the number of days on which to enable the speed scheduler,
62 using a list such as "2,4-6".
63 --torrent-done-script filename
65 Specify a file to run each time a torrent finishes
66 --no-torrent-done-script
68 Don't run any script when a torrent finishes
69 -c --incomplete-dir dir
71 When adding new torrents, store their contents in directory until
72 the torrent is done.
73 -C --no-incomplete-dir
75 Don't store incomplete torrents in a different directory.
76 -d --downlimit limit
78 Limit the maximum download speed to limit kB/s. If current tor‐
79 rent(s) are selected this operates on them. Otherwise, it changes
80 the global setting.
81 -D --no-downlimit
83 Disable download speed limits. If current torrent(s) are
84 selected this operates on them. Otherwise, it changes the global
85 setting.
86 -e --cache size
88 Set the session's maximum memory cache size in MiB. This cache is
89 used to reduce disk IO.
90 -er --encryption-required
92 Encrypt all peer connections.
93 -ep --encryption-preferred
95 Prefer encrypted peer connections.
96 -et --encryption-tolerated
98 Prefer unencrypted peer connections.
99 --exit Tell the Transmission to initiate a shutdown.
101 -f --files
103 Get a file list for the current torrent(s)
104 -g --get all | file-index | files
106 Mark file(s) for download. all marks all all of the torrent's
107 files for downloading, file-index adds a single file to the down‐
108 load list, and files adds multiple files to the download list,
109 such as "-g1,3-5" to add files #1, #3, #4, and #5 to the download
110 list.
111 -G --no-get all | file-index | files
113 Mark file(s) for not downloading.
114 -gsr --global-seedratio ratio
116 All torrents, unless overridden by a per-torrent setting, should
117 seed until a specific ratio
118 -GSR --no-global-seedratio
120 All torrents, unless overridden by a per-torrent setting, should
121 seed regardless of ratio
122 -h --help
124 Print command-line option descriptions.
125 -i --info
127 Show details of the current torrent(s)
128 -if --info-files
130 List the specified torrent's files
131 -ip --info-peers
133 List the specified torrent's peers
134 -ic --info-pieces
136 List the specified torrent's pieces
137 -it --info-trackers
139 List the specified torrent's trackers
140 -si --session-info
142 List session information from the server
143 -st --session-stats
145 List statistical information from the server
146 -l --list
148 List all torrents
149 -L --labels
151 Set the specified torrent's labels
152 -m --portmap
154 Enable portmapping via NAT-PMP or UPnP
155 -M --no-portmap
157 Disable portmapping
158 -n --auth username:password
160 Set the username and password for authentication
161 -ne --authenv
163 Set the authentication information from the TR_AUTH environment
164 variable which must be formatted as username:password.
165 -N --netrc filename
167 Set the authentication information from a netrc file. See
168 netrc(5) for more information.
169 -o --dht
171 Enable distributed hash table (DHT).
172 -O --no-dht
174 Disable distribued hash table (DHT).
175 -p --port port
177 Set the port for use when listening for incoming peer connections
178 -Bh --bandwidth-high
180 Give this torrent first chance at available bandwidth
181 -Bn --bandwidth-normal
183 Give this torrent the bandwidth left over by high priority tor‐
184 rents
185 -Bl --bandwidth-low
187 Give this torrent the bandwidth left over by high and normal pri‐
188 ority torrents
189 -ph --priority-high all | file-index | files
191 Try to download the specified file(s) first. all marks all of
192 the torrent's files as normal priority, file-index sets a single
193 file's priority as normal, and files sets multiple files' priori‐
194 ties as normal, such as "-pn1,3-5" to normalize files #1, #3, #4,
195 and #5.
196 -pn --priority-normal all | file-index | files
198 Try to download the specified files normally.
199 -pl --priority-low all | file-index | files
201 Try to download the specified files last
202 -pr --peers number
204 Set the maximum number of peers. If current torrent(s) are
205 selected this operates on them. Otherwise, it changes the global
206 setting.
207 -r --remove
209 Remove the current torrent(s). This does not delete the down‐
210 loaded data.
211 -rad --remove-and-delete
213 Remove the current torrent(s) and delete their downloaded data.
214 --reannounce
216 Reannounce the current torrent(s). This is the same as the GUI's
217 "ask tracker for more peers" button.
218 --move Move the current torrents' data from their current locations to
220 the specified directory.
221 --find Tell Transmission where to look for the current torrents' data.
223 -sr --seedratio ratio
225 Let the current torrent(s) seed until a specific ratio
226 -SR --no-seedratio
228 Let the current torrent(s) seed regardless of ratio
229 -srd --seedratio-default
231 Let the current torrent(s) use the global seedratio settings
232 -td --tracker-add tracker
234 Add a tracker to a torrent
235 -tr --tracker-remove trackerId
237 Remove a tracker from a torrent
238 -s --start
240 Start the current torrent(s)
241 -S --stop
243 Stop the current torrent(s) from downloading or seeding
244 --start-paused
246 Start added torrents paused
247 --no-start-paused
249 Start added torrents unpaused
250 -t --torrent all | active | id | torrent-hash
252 Set the current torrent(s) for use by subsequent options. The
253 literal all will apply following requests to all torrents; the
254 literal active will apply following requests to recently-active
255 torrents; and specific torrents can be chosen by id or hash. To
256 set more than one current torrent, join their ids together in a
257 list, such as "-t2,4,6-8" to operate on the torrents whose IDs
258 are 2, 4, 6, 7, and 8.
259 --trash-torrent
261 Delete torrents after adding
262 --no-trash-torrent
264 Do not delete torrents after adding
265 -hl --honor-session
267 Make the current torrent(s) honor the session limits.
268 -HL --no-honor-session
270 Make the current torrent(s) not honor the session limits.
271 -u --uplimit limit
273 Limit the maximum upload speed to limit kB/s. If current tor‐
274 rent(s) are selected this operates on them. Otherwise, it changes
275 the global setting.
276 -U --no-uplimit
278 Disable upload speed limits.
279 --utp Enable uTP for peer connections.
281 --no-utp
283 Disable uTP for peer connections. If current torrent(s) are
284 selected this operates on them. Otherwise, it changes the global
285 setting.
286 -v --verify
288 Verify the current torrent(s)
289 -V --version
291 Show version number and exit
292 -w --download-dir directory
294 When used in conjunction with --add, set the new torrent's down‐
295 load folder. Otherwise, set the default download folder.
296 -x --pex
298 Enable peer exchange (PEX).
299 -X --no-pex
301 Disable peer exchange (PEX).
302 -y --lds
304 Enable local peer discovery (LPD).
305 -Y --no-lds
307 Disable local peer discovery (LPD).
308 -pi --peer-info
310 List the current torrent's connected peers. In the `status' sec‐
311 tion of the list, the following shorthand is used:
312 D: Downloading from this peer
313 d: We would download from this peer if they would let us
314 E: Encrypted connection
315 H: Peer was found through DHT
316 I: Peer is an incoming connection
317 K: Peer has unchoked us, but we're not interested
318 O: Optimistic unchoked
319 T: Peer is connected over uTP
320 U: Uploading to peer
321 u: We would upload to this peer if they asked
322 X: Peer was discovered through Peer Exchange (PEX)
323 ?: We unchoked this peer, but they're not interested
324 --blocklist-update
326 Update blocklist from URL specified in remote client's settings
327 with blocklist-url key.
328
330 List all torrents:
331 $ transmission-remote -l
333 List all active torrents:
334 $ transmission-remote -tactive -l
336 Set download and upload limits to 400 kB/sec and 60 kB/sec:
337 $ transmission-remote -d400 -u60
339 $ transmission-remote --downlimit=400 --uplimit=60
340 Set alternate download and upload limits to 100 kB/sec and 20 kB/sec:
341 $ transmission-remote -asd100 -asu20
343 $ transmission-remote --alt-speed-downlimit=100 --alt-speed-uplimit=20
344 Set the scheduler to use the alternate speed limits on weekdays between
345 10AM and 11PM
346 $ transmission-remote --alt-speed-time-begin=1000
348 $ transmission-remote --alt-speed-time-end=2300
349 $ transmission-remote --alt-speed-days=1-5
350 $ transmission-remote --alt-speed-scheduler
351 List all torrents' IDs and states:
352 $ transmission-remote -l
354 List all torrents from a remote session that requires authentication:
355 $ transmission-remote host:9091 --auth=username:password -l
357 Start all torrents:
358 $ transmission-remote -tall --start
360 Add two torrents:
361 $ transmission-remote -a one.torrent two.torrent
363 Add all torrents in ~/Desktop:
364 $ transmission-remote -a ~/Desktop/*torrent
366 Get detailed information on the torrent whose ID is '1':
367 $ transmission-remote -t1 -i
369 Get a list of a torrent's files:
370 $ transmission-remote -t1 -f
372 Download only its second and fourth files:
373 $ transmission-remote -t1 -Gall -g2,4
375 Set all torrents' first two files' priorities to high:
376 $ transmission-remote -tall -ph1,2
378 Set all torrents' files' priorities to normal:
379 $ transmission-remote -tall -pnall
381
383 http_proxy Sets the proxy to use for http tracker announces.
384
386 Charles Kerr, Josh Elsasser, Eric Petit, Mitchell Livingston, and Mike
387 Gelfand.
388
390 transmission-create(1), transmission-daemon(1), transmission-edit(1),
391 transmission-gtk(1), transmission-qt(1), transmission-remote(1),
392 transmission-show(1)
393 https://transmissionbt.com/
395BSD July 21, 2008 BSD