Telegram_Restricted_Media_Downloader

1. 对于Windows11用户，Windows Terminal默认已经安装好，可跳过下载的步骤，直接前往第3步（将Windows Terminal设为默认终端）。

2. 对于Windows10用户，推荐使用Windows Terminal作为默认终端，仅作为推荐安装，无论安装与否不会影响本软件的使用，Windows Terminal能提供更出色的显示、交互、体验效果，以及避免出现文字显示乱码。

   Windows Terminal下载地址如下表：

   平台	下载地址
   微软商店	点击跳转
   Github	点击跳转

3. 下载完成完成后win+r输入wt回车打开，然后将Windows Terminal设为默认终端再启动软件，教程如下：

   

   

2.2.1.申请教程

1. 前往网站：https://t.me/BotFather

2. 打开后会提示"要打开 Telegram Desktop 吗？"此时点击"打开Telegram Desktop"如下图所示：

   

   如果没有这个弹窗，说明电脑没有安装Telegram客户端，安装后再重试即可。

3. 点击开始，如下图所示：

   

4. 然后在当前聊天框中输入/newbot后回车，如下图所示：

   

   它会回复你"Alright, a new bot. How are we going to call it? Please choose a name for your bot."意思是给机器人取一个名字，如下图所示：

   

5. 这个名字是显示名称（display name），并不是唯一识别码，随便设置一下即可，之后可以通过 /setname命令进行修改。

   

6. 接着设置机器人的唯一名称。字符串必须 以bot结尾，比如 HelloWorld_bot 或 HelloWorldbot 都是合法的。如果设置的名字已经被占用需要重新设置。如设置成了 trmd_bot但是这个名字已经有人使用了，此时会提示"Sorry, this username is already taken. Please try something different."意思是已经被使用了，需要拟定一个不重复的，如下图所示：

   

   如果结果如上图所示，则就代表名字重复了，需要重新拟定一个。

7. 直到提示你"Done! Congratulations on your new bot. . ."如下图所示：

   

   如果结果如上图所示，则代表bot_token申请成功了，箭头指的红框处就是你所申请的bot_token，切记不要泄露给任何人！

2.2.2.使用教程

1. 申请完成后，在软件配置时询问"是否启用「机器人」（需要提供bot_token）？ - 「y|n」（默认n）"选择y代表需要使用，如下图所示：

   

   然后在上图箭头所指处填入"2.2.1.申请教程"第7步申请的bot_token后回车，即可配置完成。

2. 在一切配置完成，软件启动成功后等待提示"「机器人」启动成功。"，就代表机器人可以使用了，如下图所示：

   

3. 在Telegram客户端中找到与BotFather的对话框，找到"2.2.1.申请教程"第7步对话的位置（或者用你自己的方式找到你的机器人的对话框），如下图所示：

   

   然后在上图箭头所指处即可跳转到机器人对话框。

4. 点击开始，如下图所示：

   

   不出意外，会收到一条来自机器人发送的消息，如下图所示：

   

   如果没收到尝试给机器人发送任意命令。

5. 目前机器人支持的命令用法及解释如下表所示：

   命令	用法	解释
   /help	向机器人发送发送/help即可。	展示可用命令。
   /download	/download 链接1 链接2 链接3 链接n或/download 频道链接 1 100	分配新的下载任务，两种方式可选（指定链接下载和范围下载，具体使用方法请见下方说明）。
   /table	向机器人发送/table即可。	在终端输出当前下载情况的统计信息。
   /forward	/forward https://t.me/A https://t.me/B 1 100	将频道A的消息转发至频道B，其中1代表起始ID，100代表截止ID。
   /exit	向机器人发送/exit即可。	退出软件。
   /listen_download	/listen_download https://t.me/A https://t.me/B https://t.me/n	实时监听频道A、频道B和频道n的最新消息（任意消息）进行下载。
   /listen_forward	/listen_forward https://t.me/A https://t.me/B	实时监听频道A的最新消息（任意消息）转发至频道B。当频道A存在内容保护限制时，回退至下载后上传。
   /listen_info	向机器人发送/listen_info即可。	查看当前已经创建的监听信息。
   /upload	/upload 本地文件 目标频道	上传本地的文件到指定频道。
   /upload_r	/upload_r 本地文件夹 目标频道	递归上传文件夹（包含子文件夹）到指定频道。
   /download_chat	/download_chat 频道链接	获取该频道全部内容，用户通过自定义条件进行内容筛选，最终下载该频道中用户所需内容。
   /auth	/auth或/auth 用户ID或/auth @用户名	添加/移除/查看授权使用机器人的用户，支持用户ID或@用户名。

   其他功能：

   • （≥v1.8.7）转发视频、图片、音频、语音、GIF、文档、视频笔记、实况图片类型的消息给机器人，即可创建下载任务。
     • 此项功能不受用户自定义下载类型限制，确保文件即时获取。
     • 转发的消息将按新消息处理，每次均生成独立文件命名。暂不支持重复文件识别，请妥善管理多次转发的相同内容。
     • 此功能仅用于便利用户日常使用，对于无法被转发、下载的消息，请根据实际需求使用对应的命令。

2.2.3.命令

/help

菜单

/download

⚠️ 版本变更说明：

• 方式一：

  • 
  • 只要发送了正确的下载命令，终端就会创建对应的下载任务，如下图所示：
  • 

• 方式二：

  • 该功能为版本≥v1.5.1的新增功能，用于对于单一链接的范围下载，并且该方式要求指定频道链接、起始ID与结束ID：

    # 语法格式如下：
    /download 频道链接 起始ID 结束ID
    # 举例：
    /download https://t.me/test 1 500
    # 代表下载https://t.me/test从消息ID=1到结束ID=500的媒体。
    

/table

需要注意的是，这个表格是实时的状态，并不是最终下载完成的结果，每一次使用它都会随着当前的下载记录而更新。

链接统计表的使用，如下图所示：

注意：由于早期代码设计缺陷，链接统计表为后续支持的功能：

• 链接统计表仅会统计所有支持的类型，并不会只统计用户当前所选择的类型。

• 链接统计表对于评论区媒体的统计，会出现总数统计错误的问题，体现在总数为1，小于当前的下载数，完成率>>100%的问题（该问题已在≥v1.5.9修复）。

• 当用户未选择下载所有支持的类型时，在用户所选择的类型下载完成后（或使用机器人发送链接统计表），尽管所有用户指定类型的文件已经下载完成，当链接统计表显示完成率不为100%时，代表该链接还存在其他用户未指定的文件类型，但实际用户所指定的类型已经下载完成了，是正常情况（该问题已在≥v2.0.2调整：在机器人设置或配置文件中被定义为跳过的下载类型与不支持的下载类型，统计时不再计入总数）。

• 版本≥v1.6.5起已支持导出表格功能，通过该命令可在运行时控制是否在退出后导出指定类型的表格。

计数统计表的使用，如下图所示：

/forward

⚠️ 注意：
消息能否转发，在于频道是否开启了限制保存内容功能。
如果无法转发，机器人会在聊天框提供一个下载按钮与下载后上传按钮（≥v1.6.7）。

⚠️ 版本变更说明：

• 转发消息语法：

  /forward 频道A 频道B 起始ID 结束ID
  

• 实例：

  • 该实例代表转发https://t.me/test频道中从消息ID=1到结束ID=500的消息到 https://t.me/test2 频道。

  /forward https://t.me/test https://t.me/test2 1 500
  

• 转发至个人收藏夹（任选一种命令即可）：

  • 方式1，使用me或self指向个人收藏夹（任选一种命令即可）：

    /forward https://t.me/test me 1 500
    

    /forward https://t.me/test self 1 500
    

  • 方式2，使用 https://t.me/用户名 ：

    • 用户名即指个人账户信息里@后面那一串，需用户提前手动自己设置，否则无法使用该方式。
    • 例如通过查询个人信息，得知当前设置的用户名为@developer，此时指向个人的链接即为https://t.me/developer。

    /forward https://t.me/test https://t.me/developer 1 500
    

  • 无论使用方式1或方式2，都代表转发 https://t.me/test 频道 中从消息ID=1到结束ID=500的消息到个人收藏夹。

• 转发个人收藏夹的内容至任意频道：

  • 方式1：

    /forward me https://t.me/test 1 500
    

  • 方式2：

    /forward https://t.me/developer me 1 500
    

  • 无论使用方式1或方式2，都代表转发个人收藏夹中从消息ID=1到结束ID=500的消息到https://t.me/test 频道。

/exit

/listen_download

• /listen_download监听下载用于，实时监听该链接的最新消息进行下载。
  • 在用户发送了正确的监听命令后，会收到机器人的成功提示。
  • 当被监听的频道有可下载的内容时，就会自动发送命令下载。

注册监听下载

/listen_download https://t.me/A

注销监听下载

注销方法

再次向机器人发送创建监听时的命令，机器人将会提供给用户一个用于注销监听的内联键盘，点击确认即可。

与此同时，也可通过网页面板的监听版块提供的按钮注销监听下载（≥v2.0.2）。

/listen_download https://t.me/A

注册多个监听下载

/listen_download https://t.me/A https://t.me/B https://t.me/n

注销多个监听下载

/listen_download https://t.me/A https://t.me/B https://t.me/n

/listen_forward

⚠️ 版本变更说明：

• /listen_forward监听转发用于，实时监听该链接的最新消息。
  • 与/forward命令一样，消息能否转发，在于频道是否开启了限制保存内容功能。
  • 但在≥v1.6.7起可以通过下载再上传的方式进行"转发"。
  • 在用户发送了正确的监听命令后，会收到机器人的成功提示。
  • 当被监听的频道有任何新内容时，就会自动转发至用户所指定的频道。

监听行为说明

• 频道独占原则：
  • 每个频道同一时间只能激活一种监听模式（下载或转发）。
  • 对于/listen_forward命令，"同一频道"特指被监听的源频道。
  • 转发目标频道不受此限制，仍可通过/listen_download创建下载任务。
• 操作限制：
  • 当频道A正在监听转发频道B时：
    • 可以同时在频道B设置监听下载。
    • 但频道B的监听下载，不会响应来自频道A的监听转发。
• 监听切换流程：
  • 必须先通过同一命令（注册监听时的命令）来取消现有监听。
  • 然后才能创建新的监听事件。

注册监听转发

/listen_forward https://t.me/A https://t.me/B

注销监听转发

注销方法

再次向机器人发送创建监听时的命令，机器人将会提供给用户一个用于注销监听的内联键盘，点击确认即可。

与此同时，也可通过网页面板的监听版块提供的按钮注销监听转发（≥v2.0.2）。

/listen_forward https://t.me/A https://t.me/B

/listen_info

• /listen_info用于查看当前已经创建的监听信息，直接发送即可：

  /listen_info
  

/upload

⚠️ 版本变更说明：

• /upload用于上传本地的文件到指定频道。

  • 支持上传文件夹（当指定路径为文件夹时并且版本需≥v1.7.1）。
  • 当指定的路径为文件夹时，将会上传指定文件夹下所有的文件。

• 上传文件语法：

  /upload 本地文件（夹） 目标频道
  

注意事项

Telegram 对上传的单个文件大小设有明确限制：

• 普通用户：单个文件最大上传大小为2000 MiB（约 2 GB）。
• 会员用户（Telegram Premium）：单个文件最大上传大小为4000 MiB（约 4 GB）。

对于Windows用户

上传一个文件

/upload C:\files\video.mp4 https://t.me/test

上传一个文件夹

版本需要≥v1.7.1。

/upload C:\files https://t.me/test

对于Linux用户

上传一个文件

/upload /home/username/files/video.mp4 https://t.me/test

上传一个文件夹

版本需要≥v1.7.1。

/upload /home/username/files https://t.me/test

/upload_r

⚠️ 版本变更说明：

• /upload_r命令是/upload命令的扩展版本，专为批量文件上传场景设计，支持递归处理目录结构，与/upload不同的是：

  • /upload_r命令接收文件夹路径作为其第二个参数，自动遍历该目录及其所有子目录中的文件。

    /uploadr C:\files https://t.me/test
    

  • 当第二个参数为文件路径时，自动切换为 /upload的单文件上传模式。

    /uploadr C:\files\video.mp4 https://t.me/test
    

    /upload C:\files\video.mp4 https://t.me/test
    

    以上两个命令在功能上完全等效，系统会自动识别文件类型并采用相应的上传策略。

/download_chat

• /download_chat下载指定频道。

  • 与/download不同的是：/download_chat支持通过机器人发送的内联键盘进行自定义内容过滤。
  • 该命令支持下载无法复制具体请求链接的对话。
  • 使用该命令后，需要通过操作机器人回复中的内联键盘，来设置过滤器、执行任务或取消任务。
  • 需要注意的是，在上一个/download_chat命令任务未执行或取消前，无法发起新的/download_chat命令来创建下载任务。
  • 自版本≥v1.7.5起，/download_chat命令创建的下载任务过滤条件将完全遵循用户在内联键盘中的设置，意味着该命令不会遵循配置文件中的任何规则（例如配置文件中的下载文件类型设置）。

• 目前支持的过滤方式：

• 下载指定频道语法：

  /download_chat 频道链接
  

  • 发送命令后，可根据个人需求设置过滤器（可选）。

  • 在设置完成后，必须手动点击"执行任务"或"取消任务"以继续或终止流程，否则该命令将始终处于等待状态，并阻塞新的/download_chat命令。

• 下载用户与机器人的对话媒体：

  用户与机器人的对话无法复制具体的请求链接，因此该方法用于解决某些用户与机器人对话中禁止用户进行转发、下载的情况。

  • 首先要获取机器人用户名称，在聊天对话框中点击机器人名称查看其用户名，此处假设机器人名称为@developer_bot。

  • 拼接机器人的请求链接为https://t.me/developer_bot。

    /download_chat https://t.me/developer_bot
    

• 下载个人收藏夹（任选一种命令即可）：

  • 方式1（任选一种命令即可）：

    /download_chat me
    

    /download_chat self
    

  • 方式2：

    • 首先要获取用户名称，此处假设用户名已设定，个人信息中查看用户名为@developer。
    • 拼接个人收藏夹的请求链接为https://t.me/developer。

    /download_chat https://t.me/developer
    

• 自版本≥v1.8.8起，/download_chat命令新增通过匹配关键词下载，匹配关键词说明：

  • 该命令会根据消息的text（文本）和caption（标题）信息，筛选并下载包含所设置关键词的相关对话内容。

  • 在使用该命令后点击[🔑设置匹配关键词]此时，机器人将进入接收关键词模式。

  • 关键词可以为一个或多个，当关键词为多个时，以空格分隔，例如：

    我的最爱

    学习 资料 健康 营养

  • 用户再次发送已添加的关键词时，机器人会提供一个[⌨️内联键盘]按钮用于[🗑️移除]或[👁️‍🗨️忽略]该关键词。

  • 同一时段内发送多个相同的已添加关键词，只会对第一个触发移除选项，后续重复内容不会重复触发。

  • 在[🔑设置匹配关键词]界面：

    • 点击[✅确认关键词]时，将会添加所有设置的关键词。
    • 点击[❌取消]时，将会清空所有设置的关键词。
    • 点击[🔙返回]时，不做任何操作，仅返回至主页面。

• 包括评论区设置说明：

  • 评论区开关：
    • 默认为关闭状态。
    • 开启时，按钮状态为[✅包含评论区]，匹配到的消息，存在评论区模块时，进一步匹配评论区。
    • 关闭时，按钮状态为[❌包含评论区]，匹配到的消息，存在评论区模块时，忽略评论区内容。
  • 评论区功能适用性：
    • 平台部分频道在消息下方设有评论区模块，该功能为可选扩展项。用户需基于个人实际需求，自行判断是否需同步获取评论区内容。 评论区匹配与过滤规则：
    • 开启包含评论区选项后，即便消息因媒体类型被过滤而未下载，但只要该消息存在评论区，其评论同样会被获取（≥v2.0.8）。
    • 评论区的过滤条件仅遵循本次任务中用户指定的媒体类型作为过滤条件，其余过滤条件将被忽略（例如日期）。
  • 任务处理时效性：
    • 开启包含评论区选项后，需对所匹配到的消息的评论区进行读取，消息过多时，任务创建至完成的时间可能相应延长，需耐心等待。

/auth

⚠️ 权限说明： /auth命令为root专用（root即登录用户），非root用户发送该命令将收到"该命令仅root可用"的提示。

• /auth用于管理授权使用机器人的用户，支持通过用户ID或@用户名添加授权，并支持查看与移除已授权用户。

• 查看当前已授权的用户列表（不带任何参数，直接发送即可）：

  /auth
  

• 添加授权用户（root通过指定用户ID或@用户名进行添加）：

  /auth 1234567890
  

  /auth @username
  

• 移除授权用户：进入机器人菜单的[🔐授权用户]→[🔑添加/移除授权用户]，在已授权用户列表中点击对应的[🗑️移除授权]内联按钮即可移除。

链接获取方法

对想要保存的媒体文件点击鼠标右键然后选择复制消息直链，如下图所示：

links参数的文本内容具体写法

如下图所示，即一行代表一个链接：

常见的links参数的文本内容的错误写法

如下图所示：

关于私密频道链接的下载行为

• 要求当前所登录的Telegram账号，在这个私密频道中，否则会报错无法下载。
• 这是Telegram服务端设计所决定的，任何下载器都无法越界。

重复链接问题说明

问题描述

• 如上图所示，在提交的下载任务中，存在多个前缀相同但参数不同的链接（如?comment、?single或?single&comment）。

问题原因

• 当链接包含?comment参数时，会自动下载原始消息及其评论区内容。
• 如果同时提交相同前缀但无?comment的链接，会导致同一资源被重复添加至下载队列。
• 若前一次任务尚未完成，重复提交相同资源会触发任务冲突，进而引发下载异常。

解决方案

• ≥v2.0.8已针对重复链接导致的资源竞争问题进行自动处理。
• 仅需提交一个完整链接（如带?comment的版本），系统会自动处理原始内容及评论区，无需额外提交无参数版本。
• 避免重复提交相同资源，确保每条链接的t.me/c/<频道>/<消息ID>部分唯一，防止任务冗余。
• 由于这些链接的频道名和消息ID完全一致，实际上指向的是同一资源的不同表现形式。
• 但请注意以下参数的功能差异：
  • ?comment用于标识是否下载评论区内容。
  • ?single用于在媒体组中指定仅下载该消息ID对应的单个资源。
  • ?single&comment用于指定仅下载评论区中该消息ID所对应的内容。

Telegram字段解释

链接解释说明

Telegram链接组成

Telegram链接所有链接格式

"所有"指的是如果有合并发送为一组的文件，则给定一个链接，所有合并发送的文件会被全部下载。

"媒体"指的是用户在config.yaml文件中，通过download_type参数所设置的所需下载类型的媒体。

如何下载评论区的文件

复制的链接时，带?comment字段

通常在评论区复制任意一条消息链接即可。

评论区链接的下载行为规则的说明

标准链接（无?comment参数）

• 仅下载消息正文内容（即频道/群组中直接发布的原始消息）。
• 不包含评论区内容，即使原消息存在评论，也不会被纳入下载任务。

带?comment参数的链接

• 下载消息正文 + 关联的全部评论区内容（完整会话结构）。
• 若原消息无评论区（如频道消息或评论功能关闭），则仅下载消息正文内容，与无参数版本行为一致。

非下载评论区的推荐写法

如下表所示:

关于?single及?single&comment参数的下载行为说明

功能变更概述

自≥v1.5.8版本起，链接中包含?single或?single&comment参数时，系统将启用单文件下载模式。此模式专为以下场景设计与优化：

• 解决≥1.5.8版本/listen_download当监听到合并发送的文件时，出现重复下载问题。
• 用户需求，仅需从合并发送的多媒体组中提取特定单一文件。
• 用户需求，仅需下载评论区中的单个指定媒体（避免评论区媒体过多时，迟迟下载不到想要的文件）。

参数行为详解

版本兼容性说明

• 此特性仅对≥v1.5.8版本生效。
• 历史版本中这些参数可能被忽略，导致完整内容下载。

最佳实践建议

单一文件下载

当消息包含多个媒体文件时，使用标准链接附加?single参数可精准获取首个文件：

https://t.me/c/123456789/123?single

评论区单文件下载

需从评论区单独下载文件时，应采用复合参数格式：

https://t.me/c/123456789/123?single&comment=xx

参数互斥原则

• 避免同时提交同一消息的完整版和单文件版链接（≥v2.0.8已针对重复链接导致的资源竞争问题进行自动处理）。
• 单文件模式与评论区下载模式（?comment）不可混用。

设置命令行运行参数需先在软件目录打开终端，或任意位置打开终端进入软件目录（经常使用建议配置环境变量）。

目前支持的命令行参数用法及解释如下表所示：

长参数与短参数最终结果一致。

4.1.参数

-h、–help

该参数用于展示帮助。

• 对于生产环境用户（需要先完成前置步骤“3.0.在生产环境中运行”）：

  python3 main.py -h
  

  python3 main.py --help
  

• 对于Windows用户：

  TRMD.exe -h
  

  TRMD.exe --help
  

• 对于Linux用户：

  ./TRMD -h
  

  ./TRMD --help
  

-v、–version

该参数用于展示版本信息。

• 对于生产环境用户（需要先完成前置步骤“3.0.在生产环境中运行”）：

  TRMD.exe -v
  

  TRMD.exe --version
  

• 对于Windows用户：

  TRMD.exe -v
  

  TRMD.exe --version
  

• 对于Linux用户：

  ./TRMD -v
  

  ./TRMD --version
  

-q、–quiet

• 对于生产环境用户（需要先完成前置步骤“3.0.在生产环境中运行”）：

  python3 main.py -q
  

  python3 main.py --quiet
  

• 对于Windows用户：

  TRMD.exe -q
  

  TRMD.exe --quiet
  

• 对于Linux用户：

  ./TRMD -q
  

  ./TRMD --quiet
  

-c、–config

• 对于生产环境用户（需要先完成前置步骤“3.0.在生产环境中运行”）：

  以Linux系统为例（Winodws系统同理），此处假设用户配置文件位于/home/username/files/example.yaml。

  python3 main.py -c /home/username/files/example.yaml
  

  python3 main.py --config /home/username/files/example.yaml
  

• 对于Windows用户：

  此处假设用户配置文件位于C:\files\example.yaml。

  TRMD.exe -c C:\files\example.yaml
  

  TRMD.exe --config C:\files\example.yaml
  

• 对于Linux用户：

  此处假设用户配置文件位于/home/username/files/example.yaml。

  ./TRMD -c /home/username/files/example.yaml
  

  ./TRMD --config /home/username/files/example.yaml
  

-s、–session

⚠️ 版本变更说明：