youtube-audio-bot

Delivers audio from your favorite YouTube channels to a Telegram channel.

The scheme of operation:

The process polls Google RSS feed for finding new favorite YouTube channels and users videos.
Audio streams of newly posted videos are downloaded using youtube-dl utility.
Downloaded audio undergo a voice enhancement process using ffmpeg, which equalizes spikes and decays in voices levels.
Processed audio stream is split into chunks with size lower than 50Mb, which is a limit for voice message in Telegram.
The files are delivered to the Telegram channel.

Prerequisites

Linux or Windows WSL environment.
Python3
ffmpeg
libwebkit2gtk-4.0-dev

To install all the dependencies on Ubuntu-like system, run:

apt install -y ffmpeg \
      python3 python3-wheel python3-venv python3-pip \
      libwebkit2gtk-4.0-dev

Configuration

Refer to updating configuration section below.

Running

Use run.sh to run the process. The script invokes setup.sh on the first run, if the Python environment is not prepared yet.

It's advised to set up a supervisor daemon to handle the process lifetime.

To install supervisor daemon, run: sudo apt install supervisor. Sample configuration can be found in file supervisor.conf.template.

HTTP Endpoints

Updating configuration

The following configuration values must be set:

telegram_bot_token - Token key of the Telegram Bot that delivers audio messages.
telegram_api_id - Telegram API ID for deleting old audio messages from a channel.
telegram_api_hash - Telegram API hash for deleting old audio messages from a channel.
telegram_channel_id - ID of the Telegram channel audio messages will be sent to.

Updating configuration using API:

curl -X POST \
     -H "Content-Type: application/json" \
     -d '{"telegram_bot_token": "...", "telegram_channel_id": "-1234..."}' \
     http://localhost:8056/config

Adding new YouTube channel

Adding a YouTube channel:

curl -X POST \
     -H "Content-Type: application/json" \
     -d '{"name": "Живой гвоздь", "youtube_id": "UCWAIvx2yYLK_xTYD4F2mUNw", "is_username": false}' \
     http://localhost:8056/sources

Adding new YouTube username:

curl -X POST \
     -H "Content-Type: application/json" \
     -d '{"name": "Сергей Пархоменко", "youtube_id": "sparkhom", "is_username": true}' \
     http://localhost:8056/sources

spektom/youtube-audio-bot