TG_MediaDownloader

TG_MediaDownloader copied to clipboard

TG Media Downloader Bot 🤖

A simple MTProto-based bot that can download various types of media (>10MB) on a local storage

:book: About The Project

A telegram bot based on Pyrogram that downloads on a local storage the following media files: animation, audio, document, photo, video, voice.

The bot is inspired from the Telethon-based bot by rodriguezst.

(back to top)

Why should I use a MTProto bot?

MTProto clients connect directly to Telegram’s servers, which means there is no HTTP connection, no “polling” or “web hooks”. This means less overhead, since the protocol used between you and the server is much more compact than HTTP requests with responses in wasteful JSON.

Since there is a direct connection to Telegram’s servers, even if their Bot API endpoint is down, you can still have connection to Telegram directly.

Using a MTProto client, you are also not limited to the public API that they expose, and instead, you have full control of what your bot can do.

HTTP Bots can't download file bigger than 10mb meanwhile MTProto can download files of 1.5~4GB!

(back to top)

:gear: Getting Started

The bot requires the following parameters to work:

(back to top)

Installation

The bot can be executed inside a Docker container or directly on your PC/Server OS.

(back to top)

Usage

After the setting up process, the bot is ready to use. Send/forward any supported media to the bot to start the download on your local storage.

The bot supports the following commands:

(back to top)

Generating Telegram API keys

To make the bot work you must provide your own API ID and hash:

1. Go to My Telegram and login with your phone number;
2. Click under API Development tools;
3. A Create new application window will appear. Fill in your application details. There is no need to enter any URL, and only the first two fields (App title and Short name) can currently be changed later;
4. Click on Create application at the end. Remember that your API ID and API Hash are secrets and Telegram won't let you revoke it. Don't post it anywhere!

(back to top)

Creating a Telegram Bot

1. Open a conversation with @BotFather in Telegram

2. Use the /newbot command to create a new bot. The BotFather will ask you for a name and username, then it will generate an authorization token for your new bot.

   • The name of your bot is displayed in contact details and elsewhere.
   • The Username is a short name, to be used in mentions and telegram.me links. Usernames are 5-32 characters long and are case-insensitive, but may only include Latin characters, numbers, and underscores. Your bot`s username must end in ‘bot’, e.g. ‘tetris_bot’ or ‘TetrisBot’.
   • The token is a string along the lines of 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw that is required to authorize the bot and send requests to the Bot API. Keep your token secure and store it safely, it can be used by anyone to control your bot.

(back to top)

TO-DO

• [x] It runs
• [x] It downloads supported media
• [x] Use a fallback for missing metadata
• [x] Allow custom names for un-named files instead of file_unique_id
• [x] On the fly configuration changes
• [ ] Improve error handling related to Telegram's service

(back to top)

:dizzy: Contributing

If you are interested in contributing, please refer to Contributing Guidelines for more information and take a look at open issues. Ask any questions you may have and you will be provided guidance on how to get started.

Thank you for considering contributing.

(back to top)

:handshake: Support

If you find value in my work, please consider making a donation to help me create, and improve my projects.

Your donation will go a long way in helping me continue to create free software that can benefit people around the world.

(back to top)

:warning: License

The content of this repository is distributed under the GNU GPL-3.0 License. See LICENSE for more information.

(back to top)

:hammer_and_wrench: Built With

• Python
• Pyrogram

(back to top)