Telethon Downloader
Telethon Downloader is a self-hosted Telegram bot that automatically downloads multimedia files sent to it.
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
Variants
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
- How to download images to my local PC using telethon (forum)
- How to correctly use the iter_download functionality for multi ... (forum)
- python - Telethon: download channel videos and pictures based on ... (forum)
- Telethon Downloader. Bot de descargas para Telegram (reddit)
Collected 53 days ago - public community threads