Self-host telethon_downloader
v3.1.9Telegram bot for auto media downloads with YouTube & torrent
- Stars
- 206
jsavargas/telethon_downloader
What is telethon_downloader?
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.
Should you self-host telethon_downloader?
telethon_downloader scores 45/100 on selfhost.directory (how scoring works) and ranks #34 of 45 in Download Management. It has 206 GitHub stars.
There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Python.
Its closest alternative on selfhost.directory is cobalt (83/100, 45 589 stars). It scores higher overall, so compare the two before you pick. See telethon_downloader vs cobalt side by side.
Features
- Automatic media downloads
- Directory Browser
- Direct URL file download
- Download progress tracking
- File organization by extension
- File organization by group/channel
- File organization by keywords
- File organization by regex patterns
- Interactive file rename
- Interactive path configuration
- Quick extension path setting
- Quick group path setting
- Torrent support via watch folder
- YouTube video and audio download
telethon_downloader README
More in Download Management
tidaloaderA self-hosted, open-source web app that downloads music from Tidal in multiple quality tiers and imports playlists from Spotify and ListenBrainz.
Transmission_VPNA self-hosted, open-source Docker container that runs Transmission and its web UI only while an OpenVPN tunnel is active, with presets for many VPN providers.
Tube ArchivistTube Archivist is a self-hosted, open-source YouTube media server for downloading, indexing, and playing videos offline with full-text search.
tubesyncA self-hosted, open-source YouTube PVR like Sonarr for YouTube: it indexes channels and playlists, downloads media via yt-dlp, and updates your Plex or Jellyfin library.
UmlautAdaptarrUmlautAdaptarr is a self-hosted proxy fixing German umlaut matching issues for Sonarr, Radarr, Lidarr, and Readarr during release searches and imports.
UmlautAdaptarrEXSelf-hosted proxy that sits between *arr apps and indexers to fix umlaut and German title matching for Sonarr, Radarr, Lidarr, and Readarr via Newznab/Torznab API.
unpackerrSelf-hosted daemon that extracts archives for Starr apps or watches folders, with web UI on port 5656.
vertexVERTEX is a self-hosted, open-source tool for PT users to automate show tracking and seeding via Docker with a web UI.
VibraVidSelf-hosted open-source downloader for movies, series, anime and music via HLS/DASH/ISM, with Widevine/PlayReady decryption, web GUI and Sonarr/Radarr automation.
WebVideo2NASSelf-hosted Chrome extension and NAS downloader for HLS, DASH, MP4, MOV streams with multi-worker architecture.
WhisparrSelf-hosted adult movie manager for Usenet and BitTorrent that monitors RSS feeds, integrates with download clients and media servers, and auto-upgrades quality.
ydl_api_ngSelf-hosted REST API wrapper around yt-dlp for downloading videos/audio from hundreds of sites, with queue management, scheduled downloads, and browser integration.
0 comments