Download media files from a telegram conversation/chat/channel up to 2GiB per file
Find a file
2019-11-07 17:56:33 +01:00
.circleci add: pylint & mypy code check 2019-11-06 17:38:48 +01:00
tests upd: adapt unittest 2019-11-07 17:56:33 +01:00
.gitignore upd: exclude media download dir 2019-08-05 17:17:35 +02:00
config.yaml add: support for multiple media type download 2019-08-05 17:33:47 +02:00
dev-requirements.txt add: pylint & mypy code check 2019-11-06 17:38:48 +01:00
LICENSE Batman! (this commit has no parents) 2019-07-24 17:41:01 +02:00
Makefile add: pylint & mypy code check 2019-11-06 17:38:48 +01:00
media_downloader.py pass message & file_ref to 2019-11-07 17:55:43 +01:00
pylintrc add: pylint & mypy code check 2019-11-06 17:38:48 +01:00
README.md upd: Supported Python version 2019-11-06 12:12:49 +01:00
requirements.txt adding additional dependencies 2019-07-25 14:18:45 +02:00

Telegram Media Downloader

Build Status Coverage Status License: MIT Code style: black

Overview:

Download all media files from a conversation or a channel that you are a part of from telegram. A meta of last read/downloaded message is stored in the config file so that in such a way it won't download the same media file again.

Support:

Category Support
Language Python 3.6 and above
Download file types document

ToDo:

  • Add support for multiple channels/chats.

Installation

For *nix os distributions with make availability

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

For Windows which doesn't have make inbuilt

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

Configuration

Getting your API Keys: The very first step requires you to obtain a valid Telegram API key (API id/hash pair):

  1. Visit https://my.telegram.org/apps and log in with your Telegram Account.
  2. Fill out the form to register a new Telegram application.
  3. Done! The API key consists of two parts: api_id and api_hash.

Getting chat id:

  1. Open https://web.telegram.org
  2. Now go to the chat/channel and you will see the URL as something like
    • https://web.telegram.org/#/im?p=u853521067_2449618633394 here 853521067 is the chat id.
    • https://web.telegram.org/#/im?p=@somename here somename is the chat id.
api_hash: your_api_hash
api_id: your_api_id
chat_id: telegram_chat_id
last_read_message_id: 0
media_types:
- audio
- photo
- video
- document
- voice
  • api_hash - The api_hash you got from telegram apps
  • api_id - The api_id you got from telegram apps
  • chat_id - The id of the chat/channel you want to download media. Which you get from the above-mentioned steps.
  • last_read_message_id - If it is the first time you are going to read the channel let it be 0 or if you have already used this script to download media it will have some numbers which are auto-updated after the scripts successful execution. Don't change it.
  • media_types - Type of media to download, yopu can update what type of media you want to download it can be only one or all the available types.

Execution

$ python3 media_downloader.py

All the documents will be stored inside a direcotry named documents/ in the same path as the pythin script.