下载 #

从链接下载： #

点击官方客户端的 “复制链接” 按钮获取消息链接。

tdl dl -u https://t.me/tdl/1 -u https://t.me/tdl/2

从 JSON 下载： #

有两种导出 JSON 文件的方式：

tdl dl -f result1.json -f result2.json

合并下载： #

tdl dl \
  -u https://t.me/tdl/1 -u https://t.me/tdl/2 \
  -f result1.json -f result2.json

自定义目录： #

将文件下载到自定义目录

tdl dl -u https://t.me/tdl/1 -d /path/to/dir

自定义参数： #

使用每个任务8个线程，4个并发任务下载：

tdl dl -u https://t.me/tdl/1 -t 8 -l 4

反序下载： #

按反序下载文件（从最新到最旧）

不同的顺序将影响“恢复下载”功能

tdl dl -f result.json --desc

MIME 探测： #

如果文件扩展名与 MIME 类型不匹配，tdl将使用正确的扩展名重命名文件。

副作用：例如 .apk 文件将被重命名为 .zip。

tdl dl -u https://t.me/tdl/1 --rewrite-ext

相册/组合消息探测 #

自动检测消息是否为相册/组合消息，并下载相应的所有文件。

tdl dl -u https://t.me/tdl/1 --group

自动跳过 #

在下载时跳过相同的文件（即名称和大小相同）。

tdl dl -u https://t.me/tdl/1 --skip-same

“Takeout” 会话 #

通过 “Takeout” 会话 下载文件：

如果下载大量媒体，更倾向于使用 “Takeout” 会话，它允许您以较低的速率限制从您的帐户中导出数据。

tdl dl -u https://t.me/tdl/1 --takeout

过滤器 #

使用扩展名过滤器下载文件：

扩展名仅与文件名匹配，而不是 MIME 类型。因此，这可能不会按预期工作。

白名单和黑名单不能同时使用。

白名单：只下载扩展名为 .jpg .png 的文件

tdl dl -u https://t.me/tdl/1 -i jpg,png

黑名单：下载除了扩展名为 .mp4 .flv 的所有文件

tdl dl -u https://t.me/tdl/1 -e mp4,flv

文件名模板 #

使用自定义文件名模板下载：

请参考 模板指南 了解更多。

tdl dl -u https://t.me/tdl/1 \
  --template "{{ .DialogID }}_{{ .MessageID }}_{{ .DownloadDate }}_{{ .FileName }}"

恢复/重新开始下载 #

在不需要交互的情况下恢复下载：

tdl dl -u https://t.me/tdl/1 --continue

在不需要交互的情况下重新开始下载：

tdl dl -u https://t.me/tdl/1 --restart

HTTP 文件服务器 #

将文件暴露为 HTTP 服务器，而不使用内置下载它们

当您想要使用下载管理器（如 aria2/wget/axel/IDM）下载文件时，适合使用此选项。

tdl dl -u https://t.me/tdl/1 --serve

使用自定义端口：

tdl dl -u https://t.me/tdl/1 --serve --port 8081