Telegram YouTube downloader

---

Telegram bot for downloading video or audio from multiple sites, you can run it with single command.

Table of contents

• Demo
• Commands
  • Download
  • Search
  • Utilities
• Running
• Docs

Demo

Commands

1. Download

/video <download url>
/video <format> <download url>
/v <download url>

/audio <download url>
/audio <format> <download url>
/a <download url>

• You can set a default command to run a download command on bare messages.

2. Search

Performs a YouTube search to download. Also see setup/search

/search <query>
/s <query>

3. Utilities

See configurations for command configurations.

/formats
/sites
/help
/about

Running

You can also run the bot without Docker and with multiple other ways check Setup for more information.

Docker

Run the container with your telegram bot key. Docker image

docker run -d --name telegram_youtube_downloader --restart unless-stopped -e TELEGRAM_BOT_KEY=<TELEGRAM_BOT_KEY> cccaaannn/telegram_youtube_downloader:latest

Example with all flags Setup with Docker

• Search feature Setup/search
• Mapped logs
• Custom configurations

docker run -d --name telegram_youtube_downloader --restart unless-stopped \
-e TELEGRAM_BOT_KEY=<TELEGRAM_BOT_KEY> \
-e YOUTUBE_API_KEY=<YOUTUBE_API_KEY> \
-v <YOUR_CONFIGS_PATH>/configs:/telegram_youtube_downloader/telegram_youtube_downloader/configs \
-v <YOUR_LOGS_PATH>/logs:/telegram_youtube_downloader/logs \
cccaaannn/telegram_youtube_downloader:latest

Daily build

This project depends on yt-dlp and it is constantly updated, a daily Docker build pipeline added to keep the project up to date with external dependencies. It is not tested so might not be stable but if you are getting download errors on the latest version you can use daily until latest is fixed.

docker run -d --name telegram_youtube_downloader --restart unless-stopped -e TELEGRAM_BOT_KEY=<TELEGRAM_BOT_KEY> cccaaannn/telegram_youtube_downloader:daily

Docs

Also see

• Setup for more ways to run the bot.
• Configurations for all configurable options.
• Hardware Acceleration for using ffmpeg with hardware acceleration.
• Api Server for using with custom telegram api server with increased download limits.