tangyoha /telegram_media_downloader

基于Dineshkarthik的项目, 电报视频下载,电报资源下载,跨平台,支持web查看下载进度 ,支持bot下发指令下载,支持下载已经加入的私有群但是限制下载的资源, telegram media download,Download media files from a telegram conversation/chat/channel up to 2GiB per file

★ 5,661⑂ 660👁 15⑃ 78● 175▤ 16
JavaScriptMITCreated 2023-02-13
Download: v2.2.5, 2025-01-07v2.2.5, ↓2.2.52025-01-06
+1
Daily
5,661
stars
660
forks
15
watchers
78
prs
175
issues
16
releases

README

Telegram Media Downloader












  中文 · 
  Feature request
   · 
  Report a bug
   · 
  Support: Discussions
   & 
  Telegram Community


 Overview
 Support two default running

 The robot is running, and the command download or forward is issued from the robot

 Download as a one-time download tool

 UI

 Web page

 After running, open a browser and visit localhost:5000
 If it is a remote machine, you need to configure web_host: 0.0.0.0




 Robot

 Need to configure bot_token, please refer to Documentation



 Support

| Category             | Support                                          |
| -------------------- | ------------------------------------------------ |
| Language             | Python 3.7 and above                           |
| Download media types | audio, document, photo, video, video_note, voice |

 Version release plan

 v2.2.0

 Installation

For nix os distributions with make availability

sh
git clone https://github.com/tangyoha/telegram_media_downloader.git
cd telegram_media_downloader
make install


For Windows which doesn't have make inbuilt

sh
git clone https://github.com/tangyoha/telegram_media_downloader.git
cd telegram_media_downloader
pip3 install -r requirements.txt


 Docker
 For more detailed installation tutorial, please check the wiki

Make sure you have docker and docker-compose installed
sh
docker pull tangyoha/telegram_media_downloader:latest
mkdir -p ~/app && mkdir -p ~/app/log/ && cd ~/app
wget https://raw.githubusercontent.com/tangyoha/telegram_media_downloader/master/docker-compose.yaml -O docker-compose.yaml
wget https://raw.githubusercontent.com/tangyoha/telegram_media_downloader/master/config.yaml -O config.yaml
wget https://raw.githubusercontent.com/tangyoha/telegram_media_downloader/master/data.yaml -O data.yaml
 vi config.yaml and docker-compose.yaml
vi config.yaml

 The first time you need to start the foreground
 enter your phone number and code, then exit(ctrl + c)
docker-compose run --rm telegram_media_downloader

 After performing the above operations, all subsequent startups will start in the background
docker-compose up -d

 Upgrade
docker pull tangyoha/telegram_media_downloader:latest
cd ~/app
docker-compose down
docker-compose up -d


 Upgrade installation

sh
cd telegram_media_downloader
pip3 install -r requirements.txt


 Configuration

All the configurations are  passed to the Telegram Media Downloader via config.yaml file.

Getting your API Keys:
The very first step requires you to obtain a valid Telegram API key (API id/hash pair):

1. Visit  https://my.telegram.org/apps  and log in with your Telegram Account.
2. Fill out the form to register a new Telegram application.
3. Done! The API key consists of two parts:  api_id  and  api_hash.

Getting chat id:

1. Using web telegram:

1. Open 

2. Now go to the chat/channel and you will see the URL as something like
   - https://web.telegram.org/?legacy=1/im?p=u853521067_2449618633394 here 853521067 is the chat id.
   - https://web.t

Top issues

Discussions

Latest release

v2.2.5, 2025-01-07 v2.2.5 2025-01-06

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON