Telethon Downloader

Telethon Downloader is a self-hosted Telegram bot that automatically downloads multimedia files sent to it.

  • Downloaders
  • Tools & Utilities
Telethon Downloader is a self-hosted Telegram bot that automatically downloads multimedia files sent to it. Built on the open-source Telethon Python client, it retrieves media attachments from Telegram messages and saves them to your local filesystem, supporting files up to 2000 MB. A lightweight tool for self-hosters who want to archive Telegram media without relying on third-party cloud storage.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

61/100 Good

Maintained
72last commit 21 days ago
Popular
46206 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
85no serious findings, CI

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 47 days ago

GitHub stars
206
Open issues
10
Last commit
2026-10-30
License
GPL-3.0
Activity
rising

Checked 19 days ago - source: GitHub (jsavargas/telethon_downloader)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install Python and Telethon first Before starting, check Python with python --version and install the stable Telethon library (the Python package that connects to Telegram) with python -m pip install --upgrade "telethon~=2.0". Then run python -c "import telethon; print(telethon.__version__)" to confirm it works, because without it the downloader cannot start. source
  • Add your Telegram API details Fill in your Telegram api_id and api_hash (small identifiers that authorize your app with Telegram) and give the session a file name before first run. Without these values, the downloader cannot sign in or download. source
  • Keep your session file private Save the session file in a private folder and never share or upload it, because it acts like a password for your Telegram login. If someone gets it, they can connect as your account or access your Telegram session. source

Fetched 54 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

What Telegram values must I provide before first run?

Fill in your Telegram api_id and api_hash and give the session a file name. Without these values, the downloader cannot sign in or download.

How can I confirm the Telethon dependency is working?

Run the import command and print the Telethon version after installing the stable library. If it does not work, the downloader cannot start.

Can it download from links instead of only files sent to the bot?

Yes, it can download videos or audios from YouTube and direct links to files via their URL.

Is there a Docker image for the app?

Yes, the jsavargas/telethon_downloader image is available on Docker Hub. It packages the Telethon-based downloader in Python.

Answers sourced from docs.telethon.dev, docs.telethon.dev, github.com, hub.docker.com

Community

Collected 53 days ago - public community threads