telegram_media_downloader

Telegram 媒体下载器

功能请求·报告错误·支持：讨论和电报社区

概述：

从 telegram 中下载您所属的对话或频道中的所有媒体文件。最后读取/下载消息的元数据存储在配置文件中，这样它就不会再次下载相同的媒体文件。

支持：

类别	支持
语言	Python 3.7及以上版本
下载媒体类型	音频、文档、照片、视频、video_note、语音

待办事项：

• 添加对多个频道/聊天的支持。

安装

对于具有make可用性的 *nix 操作系统发行版

$ git clone https://github.com/Dineshkarthik/telegram_media_downloader.git
$ cd telegram_media_downloader
$ make install

对于没有内置make Windows

$ git clone https://github.com/Dineshkarthik/telegram_media_downloader.git
$ cd telegram_media_downloader
$ pip3 install -r requirements.txt

配置

所有配置都通过config.yaml文件传递​​到 Telegram Media Downloader。

获取您的 API 密钥：第一步要求您获取有效的 Telegram API 密钥（API id/哈希对）：

1. 访问 https://my.telegram.org/apps 并使用您的 Telegram 帐户登录。
2. 填写表格以注册新的 Telegram 应用程序。
3. 完毕！ API 密钥由两部分组成： api_id和api_hash 。

获取聊天ID：

1. 使用网络电报：

1. 打开 https://web.telegram.org/?legacy=1#/im
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
chat_id : telegram_chat_id
last_read_message_id : 0
ids_to_retry : []
media_types :
- audio
- document
- photo
- video
- voice
file_formats :
  audio :
  - all
  document :
  - pdf
  - epub
  video :
  - mp4

• api_hash - 您从电报应用程序获得的 api_hash
• api_id - 您从电报应用程序获得的 api_id
• chat_id - 您要下载媒体的聊天/频道的 ID。您可以从上述步骤中得到。
• last_read_message_id - 如果这是您第一次读取频道，请将其设置为0 ，或者如果您已经使用此脚本下载媒体，它将有一些数字，这些数字会在脚本成功执行后自动更新。不要改变它。
• ids_to_retry - Leave it as it is.下载程序脚本使用它来跟踪所有跳过的下载，以便可以在下次执行脚本时下载它。
• media_types - 要下载的媒体类型，您可以更新要下载的媒体类型，它可以是一种或任何可用类型。
• file_formats - 支持的媒体类型（ audio 、 document和video要下载的文件类型。默认格式为all ，下载所有文件。

执行

$ python3 media_downloader.py

所有下载的媒体将存储在与 python 脚本相同的路径中命名的相应目录中。

媒体类型	下载目录
声音的	路径/到/项目/音频
文档	路径/到/项目/文档
照片	路径/到/项目/照片
视频	路径/到/项目/视频
嗓音	路径/到/项目/语音
语音笔记	路径/到/项目/voice_note

代理人

目前该项目支持socks4, socks5, http代理。要使用它，请将以下内容添加到config.yaml文件的底部

 proxy :
  scheme : socks5
  hostname : 11.22.33.44
  port : 1234
  username : your_username
  password : your_password

如果您的代理不需要授权，您可以省略用户名和密码。然后代理将自动启用。

贡献

贡献指南

阅读我们的贡献指南，了解我们的提交流程、编码规则等。

想帮忙吗？

想要提交错误、贡献一些代码或改进文档吗？出色的！阅读我们的贡献指南。

行为守则

帮助我们保持 Telegram Media Downloader 的开放性和包容性。请阅读并遵守我们的行为准则。