TelegramYTDLBot

April 18, 2026 · View on GitHub

A Telegram Bot to Download YouTube videos in the highest quality possible under 2GB.

Only for Educational Purposes.

Features

✅ Fast & High quality downloads.
✅ Max video upload size : 2GB
✅ Fewer dependencies
✅ Docker deployment

How to Deploy

Docker

docker build -t telegram-ytdl-bot .
docker run --env-file .env telegram-ytdl-bot

Python

git clone https://github.com/hansanaD/TelegramYTDLBot.git;
cd TelegramYTDLBot;
pip install -r requirements.txt;

Setup Environment VariablesInstallation

Rename the .exmaple.env to .env and update its values. Instructions can be found as comments in the .env file.

Run api server locally (optional)

You can choose not to use this service.
But then you won't be able to upload files up to 2000 MB and get these features.

Generate your instructions from here. (This step might take upto 20 mins.)
Go to:
```
cd telegram-bot-api/bin
```
Get API ID & HASH from here. (Watch this Tutorial to get help.)
Start the server. (Remember to replace the values with your own values):

./telegram-bot-api --api-id=XXXXX --api-hash=XXXXXXXXXXXX --http-port=8081 --local

Read the instructions on eternnoir/pyTelegramBotAPI and tdlib/telegram-bot-api for more information.

Run your bot

Open a new "screen" or tab on your terminal. Then run:

python bot.py

both the script & api server should run at the same time order to work.

This repository is intended for educational and personal use only. The use of this repository for any commercial or illegal purposes is strictly prohibited. The repository owner does not endorse or encourage the downloading or sharing of copyrighted material without permission. The repository owner is not responsible for any misuse of the software or any legal consequences that may arise from such misuse