mirror of https://github.com/tgbot-collection/ytdlbot.git synced 2025-02-23 14:54:14 +08:00

Download videos from Youtube and other platforms through a Telegram Bot

starred-repo starred-tgbot-collection-repo

Find a file

Benny eedb8e335c add pdm		2024-11-25 18:19:55 +01:00
.github	fix README.md	2023-12-12 20:59:32 +01:00
assets	step1	2024-09-21 17:43:44 +02:00
ytdlbot	add pdm	2024-11-25 18:19:55 +01:00
.dockerignore	let's try pyrogram 2.x again	2023-12-17 14:11:19 +01:00
.gitignore	limitations on premium download	2023-12-21 19:38:47 +01:00
docker-compose.yml	update text	2024-04-09 18:31:37 +02:00
Dockerfile	step1	2024-09-21 17:43:44 +02:00
LICENSE	Initial commit	2021-05-03 18:24:44 +08:00
pdm.lock	add pdm	2024-11-25 18:19:55 +01:00
pyproject.toml	add pdm	2024-11-25 18:19:55 +01:00
README.md	remove	2024-11-04 20:08:28 +01:00

README.md

ytdlbot

YouTube Download Bot🚀🎬⬇️

This Telegram bot allows you to download videos from YouTube and other supported websites.

Usage

EU(recommended): https://t.me/benny_2ytdlbot
Asia:https://t.me/benny_ytdlbot
Join Telegram Channel https://t.me/+OGRC8tp9-U9mZDZl for updates.

Just send a link directly to the bot.

Supported websites

YouTube 😅
Any websites supported by yt-dlp

Specific link downloader (Use /spdl for these links)
- Instagram (Videos, Photos, Reels, IGTV & carousel)
- Pixeldrain
- KrakenFiles
- Terabox (file/~~folders~~) (you need to add cookies txt in ytdlbot folder with name) terabox.txt.

Features

fast download and upload.
ads free
support progress bar
audio conversion
playlist download
payment support: afdian, buy me a coffee, Telegram Payment and Tron(TRX)
different video resolutions
sending as file or streaming as video
subscriptions to YouTube Channels
cache mechanism - download once for the same video.
instagram posts(only available for my bot)
4 GiB file size support with Telegram Premium
History and inline mode support
Supports multiple download engines (yt-dlp, aria2, requests).

Note

For users of my official bot
Files larger than 2 GiB will be automatically uploaded by me(My Premium Account). By utilizing our service for such downloads, you consent to this process.
That means I know who you are and what you download.
Rest assured that we handle your personal information with the utmost care.

Limitations

Due to limitations on servers and bandwidth, there are some restrictions on this free service.

Each user is limited to 5 free downloads per 24-hour period

Maximum of three subscriptions allowed for YouTube channels.

Files bigger than 2 GiB will require at least 1 download token.

If you need more downloads, you can buy download tokens.

Thank you for using the official bot.

Screenshots

Normal download

Instagram download

How to deploy?

This bot can be deployed on any platform that supports Python.

Run natively on your machine

To deploy this bot, follow these steps:

Install bot dependencies
- Install Python 3.10 or a later version, FFmpeg.
- (optional)Aria2 and add it to the PATH.

Clone the code from the repository and cd into it.

git clone https://github.com/tgbot-collection/ytdlbot

```
cd ytdlbot/
```

Creating a virtual environment and installing required modules in Python.

```
python -m venv venv
```

source venv/bin/activate   # Linux
#or
.\venv\Scripts\activate   # Windows

```
pip install --upgrade pip
```
```
pip install -r requirements.txt
```

Set the environment variables TOKEN, APP_ID, APP_HASH, and any others that you may need.
- Change values in ytdlbot/config.py or
- Use export APP_ID=111 APP_HASH=111 TOKEN=123
Finally, run the bot with
- ```
python ytdlbot/ytdl_bot.py
```

Docker

One line command to run the bot

docker run -e APP_ID=111 -e APP_HASH=111 -e TOKEN=370FXI bennythink/ytdlbot

Complete deployment guide for docker-compose

contains every functionality
compatible with amd64 and arm64

1. get docker-compose.yml

Download docker-compose.yml file to a directory

You can configure all the following environment variables:

PYRO_WORKERS: number of workers for pyrogram, default is 100
APP_ID: REQUIRED, get it from https://core.telegram.org/
APP_HASH: REQUIRED
TOKEN: REQUIRED
REDIS: REQUIRED if you need VIP mode and cache ⚠️ Don't publish your redis server on the internet. ⚠️
EXPIRE: token expire time, default: 1 day
ENABLE_VIP: enable VIP mode
OWNER: owner username
AUTHORIZED_USER: only authorized users can use the bot
REQUIRED_MEMBERSHIP: group or channel username, user must join this group to use the bot
MYSQL_HOST:MySQL host
MYSQL_USER: MySQL username
MYSQL_PASS: MySQL password
AUDIO_FORMAT: default audio format
ARCHIVE_ID: forward all downloads to this group/channel
IPv6 = os.getenv("IPv6", False)
ENABLE_FFMPEG = os.getenv("ENABLE_FFMPEG", False)
PROVIDER_TOKEN: stripe token on Telegram payment
PLAYLIST_SUPPORT: download playlist support
M3U8_SUPPORT: download m3u8 files support
ENABLE_ARIA2: enable aria2c download
FREE_DOWNLOAD: free download count per day
TOKEN_PRICE: token price per 1 USD
GOOGLE_API_KEY: YouTube API key, required for YouTube video subscription.
RCLONE_PATH: rclone path to upload files to cloud storage
TMPFILE_PATH: tmpfile path(file download path)
TRONGRID_KEY: TronGrid key, better use your own key to avoid rate limit
TRON_MNEMONIC: Tron mnemonic, the default one is on nile testnet.
PREMIUM_USER: premium user ID, it can help you to download files larger than 2 GiB

3.2.1 Create MySQL db

Required for VIP(Download token), settings, YouTube subscription.

docker-compose up -d
docker-compose exec mysql bash

mysql -u root -p

> create database ytdl;

3.3 Tidy docker-compose.yml

You can also limit CPU and RAM usage by adding a deploy key, use --compatibility when deploying.

    deploy:
      resources:
        limits:
          cpus: '0.5'
          memory: 1500M

docker-compose up -d ytdl

4.2 VIP mode

You'll have to start MySQL and redis to support VIP mode, subscription and settings.

docker-compose up -d mysql redis ytdl

docker-compose -f worker.yml up -d

⚠️ You should not publish Redis directly on the internet. ⚠️

4.4 4 GiB Support

Subscribe to Telegram Premium
Setup user id PREMIUM_USER in ytdl.env
Create session file by running python premium.py
Copy the session file premium.session to data directory
docker-compose up -d premium

Command

start - Let's start
about - What's this bot?
help - Help
spdl - Use to download specific link downloader links
ytdl - Download video in group
leech - Download file using aria2
direct - Download file using requests
settings - Set your preference
buy - Buy token
sub - Subscribe to YouTube Channel
unsub - Unsubscribe from YouTube Channel
sub_count - Check subscription status, owner only.
uncache - Delete cache for this link, owner only.
purge - Delete all tasks, owner only.
ping - Ping the Bot
stats - Bot running status
show_history - Show download history
clear_history - Clear download history