TheBFDBot

acronym for "The BestFlippingDownloader Bot"

A simple, high-performance Telegram bot to download videos from Supported Sites using yt-dlp and spotdl.

Features

• 🎥 Video Download: Supports thousands of sites via yt-dlp, check here for the Supported sites.
• 🎵 Audio Extraction: Convert videos to MP3.
• ⚙️ Quality Selection: Choose video resolution (1080p, 720p, etc.).
• 🚀 High Performance: Concurrent downloads and uploads.
• ⚡ Aria2c Support: Optimized for speed and stability. (Disabled, since default downloader seems to be performiing better)

Installation

1. Clone the repository

   git clone https://github.com/forsyth47/yt-dlp-telegram.git
   cd yt-dlp-telegram

2. Install dependencies

   It requires python3.12 and ffmpeg To install ffmpeg:

   # Ubuntu / debian
   sudo apt install ffmpeg python3-full
   
   #MacOS
   brew install ffmpeg python
   
   #Windows
   idk, you should not be using wind*ws in the first place for development

   Setting up project:

   python3.12 -m venv .venv
   # Note: python3.14 are known to have some issues, so use python version of somewhere between 9-13
   source ./.venv/bin/activate
   pip install -r requirements.txt
   # Completely Optional: Install aria2 for experimental downloads (not recommened, unless for devs)
   # brew install aria2  # macOS
   # sudo apt install aria2  # Linux

3. Configuration Edit config.py with your Telegram API credentials:

   token = "YOUR_BOT_TOKEN"
   api_id = 123456
   api_hash = "your_api_hash"

   Optional:

   Sending logs to a channel, enter the channel id
   logs = -1234567890
   

4. Run the bot

   python main.py

Credits

• yt-dlp
  
• spotdl
  
• Inspired by and based on the idea from ssebastianoo/yt-dlp-telegram.