Transmission-remote (1) Linux Manual Page

NAME

transmission-remote – a remote control utility for transmission-daemon1 and transmission(1)

SYNOPSIS

-words [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 [-

DESCRIPTION

is a remote control utility for transmission(1) and transmission-daemon1.

By default, 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
–

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.

-rad –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:

–blocklist-update

Update blocklist from URL specified in remote client’s settings with blocklist-url key.

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

An -nosplit An Jordan Lee , An Josh Elsasser , An Eric Petit , and An Mitchell Livingston .

transmission-remote (1) Linux Manual Page