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 的開放性和包容性。請閱讀並遵守我們的行為準則。