GitHub - 2boom-ua/update_check: This script is a monitoring tool for DietPi systems that performs periodic checks for available system updates, upgrades, and live patches.t supports configurable notifications via messaging platforms, including Telegram, Discord, Slack, Gotify, Ntfy, Pushbullet, Matrix, Mattermost, Pushover, Rocket.Chat, Pumble, Flock, Zulip, Apprise and Custom.

Update Monitoring Script

Overview

This Python script monitors the availability of system updates, upgrades, and live patches on a DietPi system. It periodically checks specific files and sends notifications through various messaging services when updates are available.

Features

Update Monitoring: Checks for available updates, upgrades, and live patches.
Real-time notifications with support for multiple accounts via:
- Telegram
- Discord
- Slack
- Gotify
- Ntfy
- Pushbullet
- Pushover
- Rocket.chat
- Matrix
- Mattermost
- Pumble
- Flock
- Zulip
- Apprise
- Custom webhook
Dynamic Configuration: Load settings from a JSON configuration file.
Polling Period: Adjustable interval for checking updates.

Requirements

Python 3.x
Docker installed and running
Dependencies: requests, schedule

Edit crontab (crontab -e)

0 */1 * * * /boot/dietpi/dietpi-update 2

Clone the repository:

git clone https://github.com/2boom-ua/update_check.git
cd dockcheck

Install required Python packages:

pip install -r requirements.txt

Edit config.json:

A config.json file in the same directory as the script, and include your API tokens and configuration settings.

TELEGRAM

{
    "TELEGRAM": {
        "ENABLED": false,
        "TOKENS": [
            "first tocken",
            "second tocken",
            "...."
        ],
        "CHAT_IDS": [
            "first chat_id",
            "second chat_id",
            "...."
        ]
    },

Item	Required	Description
ENABLED	true/false	Enable or disable Telegram notifications
TOKENS	String	The token of your Telegram bot
CHAT_IDS	String	The ID of the Telegram chat where notifications will be sent

DISCORD

    "DISCORD": {
        "ENABLED": false,
        "WEBHOOK_URLS": [
            "first url",
            "second url",
            "...."
        ]
    },

Item	Required	Description
ENABLED	true/false	Enable or disable Discord notifications
WEBHOOK_URLS	url	The URL of your Discord webhook

SLACK

    "SLACK": {
        "ENABLED": false,
        "WEBHOOK_URLS": [
            "first url",
            "second url",
            "...."
        ]
    },

Item	Required	Description
ENABLED	true/false	Enable or disable Slack notifications
WEBHOOK_URLS	url	The URL of your Slack webhook

GOTIFY

    "GOTIFY": {
        "ENABLED": false,
        "TOKENS": [
            "first tocken",
            "second tocken",
            "...."
        ],
        "CHAT_URLS": [
            "first server_url",
            "second server_url",
            "...."
        ]
    },

Item	Required	Description
ENABLED	true/false	Enable or disable Gotify notifications
SERVER_URLS	url	The URL of your Gotify server
TOKENS	String	The token for your Gotify application

NTFY

    "NTFY": {
        "ENABLED": false,
        "WEBHOOK_URLS": [
            "first url",
            "second url",
            "...."
		]
    },

Item	Required	Description
ENABLED	true/false	Enable or disable Ntfy notifications
WEBHOOK_URLS	url	The URL of your self-hosted Ntfy server (or use https://ntfy.sh)

PUSHBULLET

    "PUSHBULLET": {
        "ENABLED": false,
        "TOKENS": [
            "first tocken",
            "second tocken",
            "...."
        ]
    },

Item	Required	Description
ENABLED	true/false	Enable or disable Pushbullet notifications
TOKENS	String	The token for your Pushbullet application

PUSHOVER

    "PUSHOVER": {
        "ENABLED": false,
        "TOKENS": [
            "first tocken",
            "second tocken",
            "...."
        ],
        "USER_KEYS": [
            "first user_key",
            "second user_key",
            "...."
        ]
    },

Item	Required	Description
ENABLED	true/false	Enable or disable Pushover notifications
TOKENS	String	The token for your Pushover application
USER_KEYS	String	The user key for your Pushover application

MATRIX

    "MATRIX": {
        "ENABLED": false,
        "TOKENS": [
            "first tocken",
            "second tocken",
            "...."
        ],
        "SERVER_URLS": [
            "first server_url",
            "second server_url",
            "...."
        ],
        "ROOM_IDS": [
            "!first room_id",
            "!second room_id",
            "...."
        ]
    },

Item	Required	Description
ENABLED	true/false	Enable or disable Matrix notifications
TOKENS	String	The token for your Matrix application
SERVER_URLS	url	The URL of your Matrix server

MATTERMOST

    "MATTERMOST": {
        "ENABLED": false,
        "WEBHOOK_URLS": [
            "first url",
            "second url",
            "...."
        ]
    },

Item	Required	Description
ENABLED	true/false	Enable or disable Mattermost notifications
WEBHOOK_URLS	url	The URL of your Mattermost webhook

ROCKET

    "ROCKET": {
        "ENABLED": false,
        "TOKENS": [
            "first tocken",
            "second tocken",
            "...."
        ],
		"USER_IDS": [
            "first user_id",
            "second user_id",
            "...."
        ],
        "SERVER_URLS": [
           "first server_url",
            "second server_url",
            "...."
        ],
		"CHANNEL_IDS": [
            "#first channel",
            "#second channel",
            "...."
        ]
    },

Item	Required	Description
ENABLED	true/false	Enable or disable Rocket.Chat notifications
SERVER_URLS	url	The URL of your Rocket.Chat server
TOKENS	String	The token for your Rocket.Chat application
CHANNEL_IDS	String	The ID of the Rocket.Chat channel where notifications will be sent

FLOCK

    "FLOCK": {
        "ENABLED": false,
        "WEBHOOK_URLS": [
            "first url",
            "second url",
            "...."
		]
    },

Item	Required	Description
ENABLED	true/false	Enable or disable Flock notifications
WEBHOOK_URLS	url	The URL of your Flock webhook

PUMBLE

    "PUMBLE": {
        "ENABLED": false,
        "WEBHOOK_URLS": [
            "first url",
            "second url",
            "...."
		]
    },

Item	Required	Description
ENABLED	true/false	Enable or disable Pumble notifications
WEBHOOK_URLS	url	The URL of your Pumble webhook

ZULIP

    "ZULIP": {
        "ENABLED": false,
        "WEBHOOK_URLS": [
            "first url",
            "second url",
            "...."
		]
    },

Item	Required	Description
ENABLED	true/false	Enable or disable Zulip notifications
WEBHOOK_URLS	url	The URL of your Zulip webhook

APPRISE

    "APPRISE": {
        "ENABLED": false,
        "WEBHOOK_URLS": [
            "first url",
            "second url",
            "...."
        ],
        "FORMAT_MESSAGES": [
            "markdown",
            "html",
            ...
        ]
    },

Item	Required	Description
ENABLED	true/false	Enable or disable Apprise notifications
WEBHOOK_URLS	url	The URL of your Apprise webhook
FORMATS	markdown, html, text, asterisk	The format(s) to be used for the notification (e.g., markdown/html/text/asterisk)

CUSTOM

    "CUSTOM": {
        "ENABLED": false,
        "WEBHOOK_URLS": [
            "first url",
            "second url",
            "...."
        ],
        "HEADERS": [
            {first JSON structure},
            {second JSON structure},
            ...
        ],
        "PYLOADS": [
            {first JSON structure},
            {second JSON structure},
            ...
        ],
        "FORMAT_MESSAGES": [
            "markdown",
            "html",
            ...
        ]
    },

Item	Required	Description
CUSTOM
ENABLED	true/false	Enable or disable Custom notifications
WEBHOOK_URLS	url	The URL of your Custom webhook
HEADERS	JSON structure	HTTP headers for each webhook request. This varies per service and may include fields like {"Content-Type": "application/json"}.
PAYLOAD	JSON structure	The JSON payload structure for each service, which usually includes message content and format. Like as {"body": "message", "type": "info", "format": "markdown"}
FORMAT_MESSAGE	markdown, html, text, asterisk	Specifies the message format used by each service, such as markdown, html, or other text formatting.

markdown - a simple text-based format with lightweight syntax for basic styling (Pumble, Mattermost, Discord, Ntfy, Gotify),
html - a web-based format using tags for advanced text styling,
text - raw text without any styling or formatting.
asterisk - non-standard Markdown (Telegram, Zulip, Flock, Slack, RocketChat).

Examples for Telegram, Matrix, Apprise, Ntfy, Zulip, Gotify, Pushover, Pushbullet

    "CUSTOM": {
        "ENABLED": true,
        "WEBHOOK_URLS": [
            "https://api.telegram.org/bot{token}/sendMessage",
            "{server_url}/_matrix/client/r0/rooms/{room_id}/send/m.room.message?access_token={token}",
            "{server_url}/notify/{config_id}",
            "{server_url}/{subsribe}",
            "{organizattion}.zulipchat.com/api/v1/external/slack_incoming?api_key={api_key}",
            "{server_url}/message?token={token}",
            "https://api.pushover.net/1/messages.json",
            "https://api.pushbullet.com/v2/pushes"
        ],
        "HEADERS": [
            {},
            {"Content-Type": "application/json"},
            {"Content-Type": "application/json"},
            {"Content-Type": "application/json", "Priority": "1", "Markdown": "yes"},
            {},
            {},
            {"Content-type": "application/json"},
            {"Content-Type": "application/json", "Access-Token": "{token}"}
        ],
        "PYLOADS": [
            {"chat_id": "{chat_id}", "text": "message", "parse_mode": "Markdown"},
            {"msgtype": "m.text", "body": "message", "format": "org.matrix.custom.html", "formatted_body": "message"},
            {"body": "message", "type": "info", "format": "markdown"},
            {"data": "message"},
            {"text": "message"},
            {"title": "title", "message": "message", "priority": 0, "extras": {"client::display": {"contentType": "text/markdown"}}},
            {"token": "{token}", "user": "{user_key}", "title": "header", "message": "message", "html": "1"},
            {"type": "note", "title": "header", "body": "message"}
        ],
        "FORMAT_MESSAGES": [
            "asterisk",
            "html",
            "markdown",
            "markdown",
            "asterisk",
            "markdown",
            "markdown",
            "text"
        ]
    }

 "DEFAULT_DOT_STYLE": true,
    "MIN_REPEAT": 1

Item	Required	Description
DEFAULT_DOT_STYLE	true/false	Round/Square dots.
MIN_REPEAT	1	Set the poll period in minutes. Minimum is 1 minute.

Running as a Linux Service

You can set this script to run as a Linux service for continuous monitoring.

Create a systemd service file:

nano /etc/systemd/system/update_check.service

Add the following content:

[Unit]
Description=check update aviable
After=multi-user.target
[Service]
Type=simple
Restart=always
ExecStart=/usr/bin/python3 /opt/update_check/update_check.py
[Install]
WantedBy=multi-user.target

systemctl daemon-reload

systemctl enable update_check.service

systemctl start update_check.service

License

This project is licensed under the MIT License - see the MIT License for details.

Author

2boom - GitHub

Name		Name	Last commit message	Last commit date
Latest commit History 171 Commits
tools		tools
README.md		README.md
config.json		config.json
requirements.txt		requirements.txt
update_check.jpg		update_check.jpg
update_check.py		update_check.py

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Update Monitoring Script

Overview

Features

Requirements

Edit crontab (crontab -e)

Clone the repository:

Install required Python packages:

Edit config.json:

TELEGRAM

DISCORD

SLACK

GOTIFY

NTFY

PUSHBULLET

PUSHOVER

MATRIX

MATTERMOST

ROCKET

FLOCK

PUMBLE

ZULIP

APPRISE

CUSTOM

Examples for Telegram, Matrix, Apprise, Ntfy, Zulip, Gotify, Pushover, Pushbullet

Running as a Linux Service

License

Author

About

Releases

Packages

Languages

2boom-ua/update_check

Folders and files

Latest commit

History

Repository files navigation

Update Monitoring Script

Overview

Features

Requirements

Edit crontab (crontab -e)

Clone the repository:

Install required Python packages:

Edit config.json:

TELEGRAM

DISCORD

SLACK

GOTIFY

NTFY

PUSHBULLET

PUSHOVER

MATRIX

MATTERMOST

ROCKET

FLOCK

PUMBLE

ZULIP

APPRISE

CUSTOM

Examples for Telegram, Matrix, Apprise, Ntfy, Zulip, Gotify, Pushover, Pushbullet

Running as a Linux Service

License

Author

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages