⚠️ Warning: project is still under development, use with caution.
Simple Youtube LiveStreams notifier in telegram based on youtube-dlp and aiogram .
Use this bot to receive periodic reports on live broadcasts on YouTube and generate and send the report to telegram.
The current version of the bot works in the telegram channel ДИСКОРДОВО СЕЛО.
-
Generating a custom report using jinja.
-
Administration of channels (adding/disabling/deleting) through telegram windows using aiogram-dialog.
-
Regularly checking active channels using aps-schedule.
-
Getting information about streams using youtube-dlp.
Command | Scope | Description |
---|---|---|
add_channel | User | Add youtube channel |
channels | User | Channels Administration |
cancel | User | Clear current fsm-state (if error) |
add_user | Superuser | Add user |
add_channels | Superuser | Bulk channels importing from file |
scheduler_start | Superuser | Start scheduling periodic tasks of fetching information about streams |
scheduler_pause | Superuser | Pause scheduling periodic tasks of fetching information about streams |
Tested on Ubuntu 22.04, python 3.11
Just copy source code:
git clone https://github.com/bralbral/telegram-youtube-notifier.git
Install requirements:
pip install -r requirements.txt
Fill config.yml and place it to root dir. (In parent dir to src
)
Run:
python3 -m src
Stable release with
main
tag on dockerhub
Just copy docker-compose.yml and fill in config.yaml.
Run containers:
docker-compose up -d
or if you have new docker docker compose up -d
Of course, you can build image yourself:
Just copy source code:
git clone https://github.com/bralbral/telegram-youtube-notifier.git
and build docker image:
docker build -t <your_image_name>:<your_tag_name>
And use this image with docker-compose.yml from deploy
dir.
You can use own cookies for yt-dlp extractors.
yt-dlp
does not read cookies from the browser when the browser is open. Just close it before then.
First extract the cookies to a file using the command below:
yt-dlp --cookies-from-browser [chrome/firefox/etc]
Just rename it to cookies.txt
, and use it in docker-compose.yml or place in root dir (parent to src
dir).
It will be load automatically after launch.
You can rent a server from various hosters, for example from Aeza.
By registering via the link you will support the project and receive a 15% bonus on your balance, which will be valid for 24 hours.
The bot will require the simplest VDS, in rubles this is approximately 100-200 for promotional offers, or about 500 rubles per month.
Feel free to create issue or pull request.
For development, you should install the requirements from requirements_dev.txt
pip install -r requirements_dev.txt
Use pre-commit.sh before commit.