https://github.com/spektom/youtube-audio-bot
Make an audio podcast from your favorite YouTube channels
https://github.com/spektom/youtube-audio-bot
Last synced: 3 months ago
JSON representation
Make an audio podcast from your favorite YouTube channels
- Host: GitHub
- URL: https://github.com/spektom/youtube-audio-bot
- Owner: spektom
- Created: 2022-03-14T08:53:43.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-05-14T16:29:39.000Z (about 2 years ago)
- Last Synced: 2025-01-20T16:53:31.764Z (4 months ago)
- Language: Python
- Size: 60.5 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
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:
```bash
apt install -y ffmpeg \
python3 python3-wheel python3-venv python3-pip \
libwebkit2gtk-4.0-dev
```
## Configuration
Refer to [updating configuration](#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](https://core.telegram.org/api/obtaining_api_id) for deleting old audio messages from a channel.
* `telegram_api_hash` - [Telegram API hash](https://core.telegram.org/api/obtaining_api_id) 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:
```bash
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:
```bash
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:
```bash
curl -X POST \
-H "Content-Type: application/json" \
-d '{"name": "Сергей Пархоменко", "youtube_id": "sparkhom", "is_username": true}' \
http://localhost:8056/sources
```