# telethon_downloader

> Self-hosted Telegram bot built on Telethon that automatically downloads media files, YouTube videos and audio, and handles torrents via qBittorrent or watch folders.

- **Category:** Download Management
- **Licence:** GPL-3.0
- **Latest version:** v3.1.9
- **Open source:** oss
- **Languages:** Python
- **Platforms:** Docker Compose
- **Tags:** Automation, Torrents, Media Downloader, Telegram bot, Self Hosted, Youtube Dl, Telethon

## Description

Telethon Downloader is a self-hosted Telegram bot that automatically saves multimedia files sent to it. Built on the Telethon library, it handles media from Telegram messages, downloads videos and audio from YouTube links, and processes .torrent files by sending them to qBittorrent or a watch folder. Files are organized into folders based on extension, group or channel ID, keywords, or regex patterns configured via config.ini or bot commands. The bot provides interactive commands for renaming files, setting download paths, and browsing directories. It runs as a Docker container with configurable environment variables for Telegram API credentials, download limits, YouTube format preferences, and torrent client settings. All interaction happens through Telegram chat — there is no web UI.

## Links

- [Homepage](https://github.com/jsavargas/telethon_downloader)
- [Docker](jsavargas/telethon_downloader)
- [GitHub Repository](https://github.com/jsavargas/telethon_downloader)
- [Docker Hub](https://hub.docker.com/r/jsavargas/telethon_downloader)
- [Discord Community](https://discord.gg/FdJMau8sf6)

---
Source: https://selfhost.directory/project/telethondownloader