mirror of
https://github.com/Dineshkarthik/telegram_media_downloader.git
synced 2024-12-27 09:11:56 +08:00
Download media files from a telegram conversation/chat/channel up to 2GiB per file
archiving-mediamedia-downloaderpyrogrampythonpython3starred-dineshkarthik-repostarred-repotelegramtelegram-apitelegram-appstelegram-desktop
.circleci | ||
tests | ||
.gitignore | ||
config.yaml | ||
dev-requirements.txt | ||
LICENSE | ||
Makefile | ||
media_downloader.py | ||
pylintrc | ||
README.md | ||
requirements.txt |
Telegram Media Downloader
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):
- Visit https://my.telegram.org/apps and log in with your Telegram Account.
- Fill out the form to register a new Telegram application.
- Done! The API key consists of two parts: api_id and api_hash.
Getting chat id:
- Open https://web.telegram.org
- Now go to the chat/channel and you will see the URL as something like
https://web.telegram.org/#/im?p=u853521067_2449618633394
here853521067
is the chat id.https://web.telegram.org/#/im?p=@somename
heresomename
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.