transmission-remote

List all torrents

$ transmission-remote -l

$ transmission-remote -a [path/to/file.torrent]

$ transmission-remote -a "[magnet:?xt=urn:btih:...]"

$ transmission-remote -t [id] -s

$ transmission-remote -t [id] -S

$ transmission-remote -t [id] -r

$ transmission-remote -t [id] -rad

$ transmission-remote [host:port] --auth [user:password] -l

transmission-remote [host:port] [--auth user:pass] [-t id] [options]

transmission-remote is a command-line utility for controlling the Transmission BitTorrent daemon remotely. It connects to transmission-daemon (default: localhost:9091) to manage torrents, configure settings, and monitor transfer status.
The tool provides full control over the daemon including adding and removing torrents, starting and stopping transfers, setting speed limits, viewing detailed torrent information, and managing individual files within torrents. Multiple torrents can be selected using the -t option with IDs, ranges, or 'all'.
Authentication can be provided via the --auth option, the TR_AUTH environment variable, or a .netrc file. For remote daemons, specify the host and port as the first argument.

-l, --list

List all torrents with status, progress, and speeds.

Add a torrent file or magnet URI.

Select torrent(s) by ID. Can be single ID, range (1-5), comma list (1,3,5), or 'all'.

Start the selected torrent(s).

Stop (pause) the selected torrent(s).

Remove the selected torrent(s) but keep downloaded files.

Remove the selected torrent(s) and delete downloaded files.

Set global download speed limit in KB/s.

Set global upload speed limit in KB/s.

Provide authentication credentials for the daemon.

Connect to specified RPC port (default: 9091).

Use SSL/TLS for the RPC connection.

Show detailed information about the selected torrent.

List files in the selected torrent.

List connected peers for the selected torrent.

Requires transmission-daemon to be running. Default connection is localhost:9091; remote connections may require firewall configuration. Authentication credentials in command-line arguments may be visible to other users via process listings; prefer environment variables or .netrc for sensitive environments.

transmission-remote was developed as part of the Transmission project, which began in 2005. The remote control utility was created to enable headless operation of the BitTorrent client, allowing system administrators to manage torrent downloads on servers without graphical interfaces. It has become a standard tool for automated torrent management in scripts and server environments.

transmission-daemon(1), transmission-cli(1), transmission-create(1), transmission-show(1)