作为一个优秀的BT下载工具,支持普通BT和PT广受用户喜爱。近日根据需要调整PT种子的属性,所以稍微研究了下transmission的命令行工具,并根据man文档简要翻译出了本份说明。
本说明内容,基于2.8.4版本。
transmission的命令行工具主要有:
- transmission-create:创建种子文件(.torrent格式文件)的工具
- transmission-show:显示种子metadata信息的工具
- transmission-edit:编辑种子信息的工具
- transmission-cli:一个命令行的bt客户端工具
- transmission-daemon:bt下载客户端服务工具
- transmission-remote:远程控制transmission-daemon的工具
transmission-create——创建种子的工具
命令行语法
transmission-create [-h]
transmission-create -V
transmission-create [-p] [-o file] [-c comment] [-t tracker] <source file or directory>
选项参数说明
- -h, --help : 显示一个帮助后退出
- -p, --private : 包含私人追踪信息(private trackers)的bt种子标志,即pt种子
-
-c, --comment : 为种子文件添加一个说明
- comment : 一段字符串,是需要添加的说明内容
-
-t, --tracker :为种子添加追踪用的网址,大多数种子至少需要一个追踪用的网址(通常是发布地址)。要添加不止一个,可以多次使用这个选项
- tracker : 一段URI字符串,是需要添加的追踪用网址
- source file or directory : 要提供下载的源文件或者目录
-
-o : 种子输出到文件,如果没有-o选项,将输出到标准输出设备,可以用来测试
- file : 种子文件路径
- -V, --version : 显示版本信息后退出
例子
transmission-create -p -o /tmp/test.torrent -c "a test BitToorent seed file" -t http:// -t http:// test.txt
transmission-show——显示种子元数据
命令行语法
transmission-show [-h]
transmission-show -V
transmission-show [-m] [-s] file(s)>
选项参数说明
- -h, --help : 显示一个帮助后退出
- -m, --magnet :一指定的magnet链接格式显示种子信息
- -s, --scrape : 向种子的信息追踪网址请求当前有多少连接(显示做种和下载数)
- torrent-file(s) : bt种子文件路径(可以是相对或者绝对路径,支持通配符)
- -V, --version : 显示版本信息后退出
例子
transmission-show -m test.torrent
将显示test.torrent的magnet链接,一个magnet链接形如:
magnet:?xt=urn:btih:<种子文件HASH值>&dn=<种子种的文件名>&tr=<追踪地址信息>
transmission-show -c test.torrent
将显示如下类型的信息:
Name: <文件名>
File: test.torrent
其中
transmission-edit——编辑种子信息的工具
命令行语法
transmission-edit [-h]
transmission-edit -V
transmission-edit [选项和参数] torrent-file(s)
选项参数说明
- -h, --help : 显示一个帮助后退出
-
-a, --add
:添加 作为追踪地址 -
-d, --delete
: 删除 追踪地址 -
-r, --replace
:在追踪地址(列表)中用 替换 - torrent-file(s) : bt种子文件路径(可以是相对或者绝对路径,支持通配符)
- -V, --version : 显示版本信息后退出
例子
transmission-edit -a http:// abc.torrent
transmission-edit -a http:// abc.torrent
transmission-edit -d http:// abc.torrent
transmission-edit -r http:// http:// abc.torrent
通过上面的处理,abc.torrent中至少有一个追踪地址是http://
transmission-cli——命令行的bt客户端工具
命令行语法
transmission-cli [-h]
transmission-cli -V
transmission-cli [选项和参数] <file|url|magnet>
选项参数说明
- -h, --help : 显示一个帮助后退出
- -b, --blocklist : 允许黑名单
- -B, --no-blocklist : 禁止黑名单
-
-d, --downlimit
: 指定最大下载速度为 ,单位kB/s - -D, --no-downlimit : 不限速
- -er, --encryption-required :加密所有peer连接
- -ep, --encryption-preferred : 倾向加密对等连接
- -et, --encryption-tolerated : 倾向非加密对等连接
- -f, --finish