Skip to content

yurnov/ua-explosion-notification-bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Відправка повідомлень у телеграм-групу при появі повідомлень про вибухи у ЗМІ

python-version license Code style: black

Невеликий Telegram bot що працює у Docker контейнері і потребує мінімальну конфігурацію. Джерелом даних є сервер даних Сервер даних JAAM.

Що потрібно для роботи?

  • Docker engine встановлений на хост з x86_64
  • Телеграм-бот та його токен (дивись керівництво)
  • Chat ID чату, куди бот присиатиме повідомлення

Налаштування

Просто надай BOT_TOKEN та CHAT_ID у файлі .env, можеш використовувати .env.example як приклад. Додатково можна обрати, щодо яких регіонів бот буде відправляти повідомлення, для цього використовуй змінну REGION_LIST, приклад і список регіонів, що підтримуються можеш знайти у .env.example.

Додатково можна налаштувати часовий пояс (за змовчуванням використовується Europe/Kyiv і для нього нічого вказувати не потрібно), а також вимкнути нотифікації за допомогою параметра SLIENT (його можна ставити у true чи false)

Також, бот може відправляти схематичну карту повітряних тривог з сервера даних JAAM - Just another alerts map, для цього додай параметер MAP (його можна ставьт у true чи false, за змовчуванням false). При цьому, якщо вам подобається інша карта потвітряних тривог (наприклад https://ubilling.net.ua/aerialalerts/?map=true), лінк на зображення (формати png чи jpg) можуть бути передані у змінній MAP_URL.

Запуск

Збудуй власний імедж

Клонуй цей репозиторій:

git https://github.com/yurnov/ua-explosion-notification-bot.git
cd ua-explosion-notification-bot

збудуй імедж

docker build . -t explosion-notification-bot

Запускай

docker run --rm -d --env-file .env explosion-notification-bot

Не забудь перед запуском відредагувати .env файл!

Запускай готовий імедж

Відредагуй .env (дивись секцію налаштувань) та запускай уже збудований імедж:

docker pull ghcr.io/yurnov/explosion-notifier:latest
docker run -d --rm --env-file .env ghcr.io/yurnov/explosion-notifier:latest

Можеш використовувати теги latest для останньої випущеної версії, чи dev для версії, що розробляється.

Перестороги

Це персональний проект, робота бота та актуальність даних не гарантуються. Не варто сприймати повідомлення для важливих для життя рішень!

Подяка

Пану @v00g100skr та його JAAM - Just another alerts map за ідею та сервер даних.

Але головна подяка — ЗСУ!, можете і ви подякувати їм тут

License

Files included in this repository is avaliable under terms of MIT license. external dependency, such as requests is avaliable under their own licenses.

Stand With Ukraine