tangyoha /telegram_media_downloader
基于Dineshkarthik的项目, 电报视频下载,电报资源下载,跨平台,支持web查看下载进度 ,支持bot下发指令下载,支持下载已经加入的私有群但是限制下载的资源, telegram media download,Download media files from a telegram conversation/chat/channel up to 2GiB per file
★ 5,661⑂ 660👁 15⑃ 78● 175▤ 16
+1
日增长
5,661
stars
660
forks
15
watchers
78
prs
175
issues
16
releases
README
电报资源下载
English ·
新功能请求
·
报告bug
·
帮助: 讨论
&
电报讨论群
概述
支持两种默认运行
机器人运行,从机器人下发命令下载或者转发
作为一个一次性的下载工具下载
界面
网页
运行后打开浏览器访问localhost:5000
如果是远程机器需要配置web_host: 0.0.0.0
机器人
需要配置bot_token,具体参考文档
支持
| 类别 | 支持 |
| ------------ | ---------------------------------------- |
| 语言 | Python 3.7 及以上 |
| 下载媒体类型 | 音频、文档、照片、视频、video_note、语音 |
版本发布计划
v2.2.0
安装
对于具有 make 可用性的 nix 操作系统发行版
sh
git clone https://github.com/tangyoha/telegram_media_downloader.git
cd telegram_media_downloader
make install
对于没有内置 make 的 Windows
sh
git clone https://github.com/tangyoha/telegram_media_downloader.git
cd telegram_media_downloader
pip3 install -r requirements.txt
Docker容器
更详细安装教程请查看wiki
确保安装了 docker 和 docker-compose
sh
docker pull tangyoha/telegram_media_downloader:latest
mkdir -p ~/app && mkdir -p ~/app/log/ && cd ~/app
wget https://raw.githubusercontent.com/tangyoha/telegram_media_downloader/blob/master/docker-compose.yaml -O docker-compose.yaml
wget https://raw.githubusercontent.com/tangyoha/telegram_media_downloader/blob/master/config.yaml -O config.yaml
wget https://raw.githubusercontent.com/tangyoha/telegram_media_downloader/blob/master/data.yaml -O data.yaml
vi config.yaml and docker-compose.yaml
vi config.yaml
第一次需要前台启动
输入你的电话号码和密码,然后退出(ctrl + c)
docker-compose run --rm telegram_media_downloader
执行完以上操作后,后面的所有启动都在后台启动
docker-compose up -d
# 升级
docker pull tangyoha/telegram_media_downloader:latest
cd ~/app
docker-compose down
docker-compose up -d
升级安装
sh
cd telegram_media_downloader
pip3 install -r requirements.txt
配置
所有配置都通过 config.yaml 文件传递给 Telegram Media Downloader。
获取您的 API 密钥:
第一步需要您获得有效的 Telegram API 密钥(API id/hash pair):
1. 访问 https://my.telegram.org/apps 并使用您的 Telegram 帐户登录。
2. 填写表格以注册新的 Telegram 应用程序。
3. 完成! API 密钥由两部分组成:api_id 和api_hash。
获取聊天ID:
如果你需要下载收藏夹的内容请填me
1。使用网络电报:
1. 打开
2. 现在转到聊天/频道,您将看到 URL 类似
- https://web.telegram.org/?legacy=1/im?p=u853521067_2449618633394 这里 853521067 是聊天 ID。
- https://web.telegram.org/?legacy=1/im?p=@somename 这里的 somename 是聊天 ID。
- https://web.telegram.org/?legacy=1/im?p=s1301254321_6925449697188775560 此处取 1301254321 并将 -100 添加到 id = -1001301254321 的开头。
- https://web.telegram.org/?legacy=1/im?p=c1301254321_6925449697188775560 此处取 1301254321 并将 -100 添加到 id = -1001301254321 的开头。
2。使用机器人:
1.使用@username_to_id_bot获取chat_id
- 几乎所有电报用户:将用户名发送给机器人或将他们的消息转发给机器人
- 任何聊天:发送聊天用户名或复制并发送其加入聊天链接到机器人
- 公共或私人频道:与聊天相同,只需复制并发送给机器人
- 任何电报机器人的 ID
配置文件
yaml
api_hash: your_api_hash
api_id: your_api_id
bot_token: your_bot_token
chat:
- chat_id: telegram_chat_id
last_read_message_id: 0
download_filter: message_date = 2022-12-01 00:00:00 and message_dateTop issues
#240[Feature]: 请求增加配置项,可关闭机器人回复10 comments · 2025-04-18#139[Bug]: the program adds one to the last_read_message_id value7 comments · 2023-12-27#38video thumbnail support7 comments · 2023-04-06#190[Bug]: 下载200个左右就开始报错了6 comments · 2024-08-15#245[Bug]: 飞牛nas里安装总是提示python media_downloader.py not found5 comments · 2025-05-18#155设置了download_filter,下载完毕后又失效了5 comments · 2024-03-16#263[Bug]: | Download error: '<' not supported between instances of 'NoneType' and 'int'4 comments · 2025-12-01#252[Bug]: 执行后无法下载4 comments · 2025-07-25
Discussions
#265批量下载的问题2 comments · 2026-01-09#262日志没有报错但机器人没有任何反应2 comments · 2025-10-31#258有没有安卓版的1 comments · 2025-09-22#257请问下载记录保存在哪里0 comments · 2025-09-07#254新增下载存储机器人且限制下载的资源1 comments · 2025-08-18#251可以加一个按照点赞数排序,下载点赞最多的前n条消息的功能吗1 comments · 2025-07-22#241只能下载jpg图片1 comments · 2025-04-24#210Downloaded only selected media1 comments · 2024-11-04