OPEN SOURCE · SELF-HOSTED · DESKTOP READY
telegram-download-bot
Save Telegram content. Keep it under your control.
Send a Telegram message link and retrieve the original text and media through your own logged-in account—including content from private channels and groups that account can already access.
Built with tdl · MTProto · Docker · AGPL-3.0
Private channel album
ONE LINK, A COMPLETE MESSAGE
Download from the Telegram spaces you already belong to.
The tool uses a logged-in Telegram user account, so it can work with public posts and with private sources that account is permitted to view.Private channels
Download linked posts from private channels when the logged-in Telegram account is already a member and can view the message.
Private groups
Retrieve linked messages and media from private groups the logged-in account can access.
Public posts
Send public channel, group, or message links and receive the available original content back in chat.
Media albums
Preserve grouped photos, videos, documents, and the accompanying message text as one download task.
Permission-aware
Private content works only when your logged-in account is allowed to view it.
Original content
MTProto retrieves the message and available media from Telegram directly.
Your deployment
Run the bot and desktop workflow on infrastructure you control.
BUILT FOR REAL DOWNLOAD WORKFLOWS
More than a link-to-file converter.
telegram-download-bot combines Telegram account access, message parsing, media handling, permissions, and deployment into one focused product.Public and private message links
Accept Telegram message links from public sources as well as private channels and groups available to the logged-in account.
Text and captions
Keep the message text or media caption together with the downloaded files so important context is not lost.
Photos and videos
Retrieve available Telegram photo and video media and send the result back through the bot workflow.
Documents and albums
Handle files and grouped media instead of requiring every album item to be downloaded separately.
In-bot account login
Sign in to the Telegram user account used by MTProto and check or clear its current session from the bot.
Admin access control
Grant and revoke users with administrator commands so the downloader is not open to everyone by default.
Desktop workflow
Use the desktop app when you want to submit links and manage downloaded content on a larger screen.
Docker self-hosting
Configure the bot token, Telegram API credentials, administrator ID, and optional proxy, then deploy with Docker Compose.
BEFORE YOU DOWNLOAD
Frequently asked questions
Can it download from private Telegram channels?
Yes, when the MTProto user account logged into the tool is already a member of that private channel and has permission to view the linked message.
Can it download from private groups?
Yes, under the same rule—the logged-in account must already be able to open the group and view the message.
Does it bypass Telegram access controls?
No. The tool uses the permissions of your logged-in Telegram account. It cannot retrieve a private message that the account itself cannot access.
What message content can it handle?
It supports message text, captions, photos, videos, documents, and grouped media albums when those items are available to the account.
Is it open source and self-hosted?
Yes. The project is published under AGPL-3.0, includes Docker Compose configuration, and can be deployed on your own infrastructure.
Is there a desktop version?
Yes. The desktop app complements the Telegram bot and provides a computer-based workflow for links and downloaded content.
YOUR ACCOUNT · YOUR ACCESS · YOUR DEPLOYMENT