Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cccaaannn/telegram_youtube_downloader

Telegram bot for downloading video or audio from multiple sites.
https://github.com/cccaaannn/telegram_youtube_downloader

bot facebook-video-downloader instagram-video-downloader python telegram-bot twitter-video-downloader youtube-dl youtube-music-downloader youtube-video-downloader yt-dlp

Last synced: 1 day ago
JSON representation

Telegram bot for downloading video or audio from multiple sites.

Awesome Lists containing this project

README

        

# Telegram YouTube downloader
---
## Telegram bot for downloading video or audio from [multiple](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md) sites, you can run it with [single](#running) command.

![GitHub top language](https://img.shields.io/github/languages/top/cccaaannn/telegram_youtube_downloader?color=blue&style=for-the-badge) [![GitHub release](https://img.shields.io/github/v/release/cccaaannn/telegram_youtube_downloader?color=blueviolet&style=for-the-badge)](https://github.com/cccaaannn/telegram_youtube_downloader/releases?style=flat-square) [![GitHub](https://img.shields.io/github/license/cccaaannn/telegram_youtube_downloader?color=brightgreen&style=for-the-badge)](https://github.com/cccaaannn/telegram_youtube_downloader/blob/master/LICENSE) [![Docker Pulls](https://img.shields.io/docker/pulls/cccaaannn/telegram_youtube_downloader?color=blue&style=for-the-badge)](https://hub.docker.com/r/cccaaannn/telegram_youtube_downloader) [![Docker Image Size (tag)](https://img.shields.io/docker/image-size/cccaaannn/telegram_youtube_downloader/latest?color=teal&style=for-the-badge)](https://hub.docker.com/r/cccaaannn/telegram_youtube_downloader)

## Table of contents
- [Demo](#demo)
- [Commands](#commands)
- [Download](#1-download)
- [Search](#2-search)
- [Utilities](#3-utilities)
- [Running](#running)
- [Docs](#docs)

## Demo
drawing drawing


## Commands

### 1. Download
```shell
/video
/video
/v
```
```shell
/audio
/audio
/a
```
- You can set a [default command](https://github.com/cccaaannn/telegram_youtube_downloader/blob/master/docs/CONFIGURATIONS.md#default_command) to run a download command on bare messages.

### 2. Search
Performs a YouTube search to download. [Also see setup/search](https://github.com/cccaaannn/telegram_youtube_downloader/blob/master/docs/SETUP.md#search-command)
```shell
/search
/s
```

### 3. Utilities
[See configurations](https://github.com/cccaaannn/telegram_youtube_downloader/blob/master/docs/CONFIGURATIONS.md) for command configurations.
```shell
/formats
/sites
/help
/about
```

## Running
You can also run the bot without Docker and with multiple other ways check [Setup](https://github.com/cccaaannn/telegram_youtube_downloader/blob/master/docs/SETUP.md) for more information.
### Docker
Run the container with your telegram bot key. [Docker image](https://hub.docker.com/r/cccaaannn/telegram_youtube_downloader)
```shell
docker run -d --name telegram_youtube_downloader --restart unless-stopped -e TELEGRAM_BOT_KEY= cccaaannn/telegram_youtube_downloader:latest
```

Example with all flags [Setup with Docker](https://github.com/cccaaannn/telegram_youtube_downloader/blob/master/docs/SETUP.md#1-docker)
- Search feature [Setup/search](https://github.com/cccaaannn/telegram_youtube_downloader/blob/master/docs/SETUP.md#search-command)
- Mapped logs
- Custom configurations
```shell
docker run -d --name telegram_youtube_downloader --restart unless-stopped \
-e TELEGRAM_BOT_KEY= \
-e YOUTUBE_API_KEY= \
-v /configs:/telegram_youtube_downloader/telegram_youtube_downloader/configs \
-v /logs:/telegram_youtube_downloader/logs \
cccaaannn/telegram_youtube_downloader:latest
```

## Daily build
This project depends on [yt-dlp](https://github.com/yt-dlp/yt-dlp) and it is constantly updated, a [daily Docker build](https://hub.docker.com/r/cccaaannn/telegram_youtube_downloader/tags) 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.
```shell
docker run -d --name telegram_youtube_downloader --restart unless-stopped -e TELEGRAM_BOT_KEY= cccaaannn/telegram_youtube_downloader:daily
```

## Docs
### Also see
- [Setup](https://github.com/cccaaannn/telegram_youtube_downloader/blob/master/docs/SETUP.md) for more ways to run the bot.
- [Configurations](https://github.com/cccaaannn/telegram_youtube_downloader/blob/master/docs/CONFIGURATIONS.md) for all configurable options.
- [Hardware Acceleration](https://github.com/cccaaannn/telegram_youtube_downloader/blob/master/docs/HARDWARE_ACCELERATION.md) for using ffmpeg with hardware acceleration.
- [Api Server](https://github.com/cccaaannn/telegram_youtube_downloader/blob/master/docs/API_SERVER.md) for using with custom telegram api server with increased download limits.