下载
从链接下载：
INFO
点击官方客户端的 "复制链接" 按钮获取消息链接。
消息链接示例
https://t.me/telegram/193https://t.me/c/1697797156/151https://t.me/iFreeKnow/45662/55005https://t.me/c/1492447836/251015/251021https://t.me/opencfdchannel/4434?comment=360409https://t.me/myhostloc/1485524?thread=1485523...（如果发现新的链接格式，请提交新的 Issue）
bash
tdl dl -u https://t.me/tdl/1 -u https://t.me/tdl/2从 JSON 下载：
有两种导出 JSON 文件的方式：
bash
# 请参考 "工具-导出消息" 章节text
1. 选择要导出的对话，点击右上角的三个点，然后点击 `导出聊天历史`。
2. 取消选中所有选项（您现在不需要下载它们），将 `大小限制` 设置为最小值。
3. 设置格式为 `JSON` 并选择您需要的时间段。
4. 导出它！`result.json` 就是您需要的文件。bash
tdl dl -f result1.json -f result2.json合并下载：
bash
tdl dl \
-u https://t.me/tdl/1 -u https://t.me/tdl/2 \
-f result1.json -f result2.json自定义目录：
将文件下载到自定义目录
bash
tdl dl -u https://t.me/tdl/1 -d /path/to/dir自定义参数：
使用每个任务8个线程，4个并发任务下载：
bash
tdl dl -u https://t.me/tdl/1 -t 8 -l 4反序下载：
按反序下载文件（从最新到最旧）
WARNING
不同的顺序将影响“恢复下载”功能
bash
tdl dl -f result.json --descMIME 探测：
如果文件扩展名与 MIME 类型不匹配，tdl将使用正确的扩展名重命名文件。
WARNING
副作用：例如 .apk 文件将被重命名为 .zip。
bash
tdl dl -u https://t.me/tdl/1 --rewrite-ext相册/组合消息探测
自动检测消息是否为相册/组合消息，并下载相应的所有文件。
bash
tdl dl -u https://t.me/tdl/1 --group自动跳过
在下载时跳过相同的文件（即名称和大小相同）。
bash
tdl dl -u https://t.me/tdl/1 --skip-same"Takeout" 会话
通过 "Takeout" 会话 下载文件：
如果下载大量媒体，更倾向于使用 "Takeout" 会话，它允许您以较低的速率限制从您的帐户中导出数据。
bash
tdl dl -u https://t.me/tdl/1 --takeout过滤器
使用扩展名过滤器下载文件：
WARNING
扩展名仅与文件名匹配，而不是 MIME 类型。因此，这可能不会按预期工作。
白名单和黑名单不能同时使用。
白名单：只下载扩展名为 .jpg .png 的文件
bash
tdl dl -u https://t.me/tdl/1 -i jpg,png黑名单：下载除了扩展名为 .mp4 .flv 的所有文件
bash
tdl dl -u https://t.me/tdl/1 -e mp4,flv文件名模板
使用自定义文件名模板下载：
请参考 模板指南 了解更多。
bash
tdl dl -u https://t.me/tdl/1 \
--template "{{ .DialogID }}_{{ .MessageID }}_{{ .DownloadDate }}_{{ .FileName }}"恢复/重新开始下载
在不需要交互的情况下恢复下载：
bash
tdl dl -u https://t.me/tdl/1 --continue在不需要交互的情况下重新开始下载：
bash
tdl dl -u https://t.me/tdl/1 --restartHTTP 文件服务器
将文件暴露为 HTTP 服务器，而不使用内置下载它们
INFO
当您想要使用下载管理器（如 aria2/wget/axel/IDM）下载文件时，适合使用此选项。
bash
tdl dl -u https://t.me/tdl/1 --serve使用自定义端口：
bash
tdl dl -u https://t.me/tdl/1 --serve --port 8081