/telegram_youtube_downloader

Telegram bot for downloading video or audio from multiple sites.

Primary LanguagePythonMIT LicenseMIT

Telegram YouTube downloader

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

GitHub top language GitHub release GitHub Docker Pulls Docker Image Size (tag)

Table of contents

Demo

drawing drawing


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