← 返回命令列表

Linux command

transmission-cli 命令

文件

复制后可按需替换文件名、目录或参数。

常用示例

Download a torrent

transmission-cli [path/to/file.torrent]

Download a magnet link

transmission-cli "[magnet:?xt=urn:btih:...]"

Download to a specific directory

transmission-cli -w [path/to/download/dir] [file.torrent]

Download with speed limits

transmission-cli -d [500] -u [100] [file.torrent]

Download and exit immediately

transmission-cli -m [file.torrent]

Download with peer blocklist enabled

transmission-cli -b [file.torrent]

Run in quiet mode

transmission-cli -q [file.torrent]

说明

transmission-cli is a lightweight, command-line BitTorrent client for downloading and uploading torrents. It supports both .torrent files and magnet URIs, making it suitable for servers, headless systems, and scripted torrent operations. The client handles a single torrent per invocation, downloading the content and optionally seeding upon completion. Progress is displayed in the terminal showing download/upload speeds, peer connections, and completion percentage. Configuration is stored in ~/.config/transmission by default, allowing resume functionality if a download is interrupted. The client respects the TRANSMISSION_HOME environment variable for custom config locations and http_proxy for tracker announces. Sending SIGHUP to a running transmission-cli process contacts the tracker for additional peers.

参数

-b, --blocklist
Enable peer blocklists. Transmission understands the bluetack blocklist format.
-d _limit_
Set maximum download speed in KB/s. 0 means unlimited.
-u _limit_
Set maximum upload speed in KB/s. 0 means unlimited.
-f _script_
Run a script when the torrent finishes downloading.
-g, --config-dir _dir_
Directory for configuration files. Allows sharing config between different Transmission clients.
-m
Do not seed after download completes; exit immediately.
-p, --port _port_
Set the port to listen for incoming peers. Default: 51413.
-w _dir_
Directory to save downloaded files. Defaults to current directory.
-q
Quiet mode. Suppress most output, show only critical messages.
-h, --help
Display help message and exit.
-v, --version
Display version number and exit.

FAQ

What is the transmission-cli command used for?

transmission-cli is a lightweight, command-line BitTorrent client for downloading and uploading torrents. It supports both .torrent files and magnet URIs, making it suitable for servers, headless systems, and scripted torrent operations. The client handles a single torrent per invocation, downloading the content and optionally seeding upon completion. Progress is displayed in the terminal showing download/upload speeds, peer connections, and completion percentage. Configuration is stored in ~/.config/transmission by default, allowing resume functionality if a download is interrupted. The client respects the TRANSMISSION_HOME environment variable for custom config locations and http_proxy for tracker announces. Sending SIGHUP to a running transmission-cli process contacts the tracker for additional peers.

How do I run a basic transmission-cli example?

Run `transmission-cli [path/to/file.torrent]` in a terminal, then adjust file names, paths, flags, or remote targets for your system.

What does -b, --blocklist do in transmission-cli?

Enable peer blocklists. Transmission understands the bluetack blocklist format.