telegram_media_downloader

テレグラムメディアダウンローダー

機能リクエスト·バグの報告·サポート: ディスカッション& Telegram コミュニティ

概要：

Telegram から参加している会話またはチャネルからすべてのメディア ファイルをダウンロードします。最後に読み取られた/ダウンロードされたメッセージのメタは構成ファイルに保存されるため、同じメディア ファイルが再度ダウンロードされることはありません。

サポート：

カテゴリ	サポート
言語	Python 3.7以降
ダウンロードメディアタイプ	オーディオ、ドキュメント、写真、ビデオ、ビデオノート、音声

ToDo:

• 複数のチャネル/チャットのサポートを追加します。

インストール

make Availability を備えた *nix OS ディストリビューションの場合

$ 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の 2 つの部分で構成されます。

チャットIDの取得:

1. Web テレグラムを使用する:

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を取得し、 id => -1001301254321の先頭に-100を追加します。
   • https://web.telegram.org/?legacy=1#/im?p=c1301254321_6925449697188775560ここでは1301254321を取得し、 id => -1001301254321の先頭に-100を追加します。

2. ボットの使用:

1. @username_to_id_bot を使用してチャット ID を取得します
   • ほぼすべての Telegram ユーザー: ユーザー名をボットに送信するか、メッセージをボットに転送するだけです
   • 任意のチャット: チャットのユーザー名を送信するか、その結合チャット リンクをコピーしてボットに送信します。
   • パブリックまたはプライベート チャネル: チャットと同じ、コピーしてボットに送信するだけです
   • 電報ボットの ID

config.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 - ダウンロードするメディアのタイプ。ダウンロードするメディアのタイプを更新できます。利用可能なタイプの 1 つまたは任意のタイプにすることができます。
• 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 をオープンで包括的な状態に保つためにご協力ください。当社の行動規範を読み、従ってください。