# Telethon Downloader

Telethon Downloader is a self-hosted Telegram bot that automatically downloads multimedia files sent to it. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1187/telethon-downloader

## Description

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.

## Health score

61/100 (Good), based on 4 of 5 factors.
- Maintained: 72 (last commit 21 days ago)
- Popular: 46 (206 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 85 (no serious findings, CI)

## Links

- Docker Hub: https://hub.docker.com/r/jsavargas/telethon_downloader
- Unraid: https://ca.unraid.net/apps/telethon-downloader-0rxi8xk08knkxg?q=telethon-downloader

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/1187/telethon-downloader), the self-hosted and open-source app directory.
