https://github.com/2boom-ua/mpn_json
A user-friendly web application for generating and testing notification configurations in JSON format. Designed specifically to simplify setup for monitoring tools created by @2boom-ua, such as Dockcheck, WatchDigest, Check Services, Web Check and ect..Multi-Platform Notification JSON Creator
https://github.com/2boom-ua/mpn_json
apprise dockcheck gotify matrix mattermost ntfy pumble rocketchat self-hosted telegram watchdigest webntfy zulip
Last synced: 3 months ago
JSON representation
A user-friendly web application for generating and testing notification configurations in JSON format. Designed specifically to simplify setup for monitoring tools created by @2boom-ua, such as Dockcheck, WatchDigest, Check Services, Web Check and ect..Multi-Platform Notification JSON Creator
- Host: GitHub
- URL: https://github.com/2boom-ua/mpn_json
- Owner: 2boom-ua
- Created: 2025-12-17T20:29:23.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-02-14T08:26:17.000Z (5 months ago)
- Last Synced: 2026-02-14T16:50:49.632Z (5 months ago)
- Topics: apprise, dockcheck, gotify, matrix, mattermost, ntfy, pumble, rocketchat, self-hosted, telegram, watchdigest, webntfy, zulip
- Language: HTML
- Homepage:
- Size: 315 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Multi-Platform Notification JSON Creator
A user-friendly web application for generating and testing notification configurations in JSON format. Designed specifically to simplify setup for monitoring tools created by [@2boom-ua](https://github.com/2boom-ua), such as **Dockcheck**, **WatchDigest**, **Check Services**, **Web Check** and ect..
This tool provides an interactive interface to configure notifications for over a dozen popular platforms, with real-time JSON preview and one-click testing.
---
[Configuration examples for Telegram, Discord, Matrix, Apprise, Pumble, Mattermost, Discord, Ntfy, Gotify, Zulip, Flock, Slack, Rocket.Chat, Pushover, Pushbullet, Webntfy](docs/json_message_config.md)
---
## Features
* **Interactive Form Builder**: Fill in platform-specific fields with guidance and validation.
* **Real-Time JSON Preview**: See the generated `notifications` section instantly as you type.
* **Test Notifications**: Send a test message directly from the app to verify your configuration works.
* **Export Options**: Copy to clipboard or download the JSON snippet/file.
* **Reset & Clear**: Easily reset forms or clear individual fields.
* **Toast Notifications**: Friendly feedback for actions like success or errors.
* **Responsive Design**: Clean, mobile-friendly interface.
* **Generic Panel**: For custom or unsupported platforms.
### Supported Notification Platforms (15+)
| Category | Platforms |
| :--- | :--- |
| **Messaging Apps** | Telegram, Discord, Slack, Matrix |
| **Team Collaboration** | Mattermost, Rocket.Chat, Zulip, Pumble |
| **Self-Hosted** | Ntfy, Gotify, Apprise |
| **Push Services** | Pushover, Pushbullet, Webntfy |
| **Others** | Custom webhook/API |
---
### Compatible Tools
| Tool | Description | Link |
| :--- | :--- | :--- |
| **Dockcheck** | Monitors Docker resources and notifies on changes | [GitHub](https://github.com/2boom-ua/dockcheck) |
| **WatchDigest** | Checks for outdated Docker image digests | [GitHub](https://github.com/2boom-ua/watchdigest) |
| **Check Services**| Monitors systemd service status | [GitHub](https://github.com/2boom-ua/check_services) |
| **Web Check** | Website availability monitoring | [GitHub](https://github.com/2boom-ua/web_check) |
---
## Installation & Running
The application is distributed as a Docker image for easy deployment.
### Access the App
Open your browser and go to: http://localhost:5299 (or your server's IP).
### 1. Using Docker CLI
```bash
docker run --name mpn_json \
-p 5299:5299 \
-e TZ=Etc/UTC \
--restart unless-stopped \
ghcr.io/2boom-ua/mpn_json:latest
```
### Using Docker Compose
```bash
services:
mpn_json_creator:
image: ghcr.io/2boom-ua/mpn_json:latest
container_name: mpn_json
ports:
- "5299:5299"
environment:
- TZ=Etc/UTC
restart: unless-stopped
```
### Start
```
docker compose up -d
```
## Running as a Linux Service
You can set this app to run as a Linux service for continuous monitoring.
### Clone the repository:
```
git clone https://github.com/2boom-ua/mnp_json.git
cd mnp_json
```
### Install required Python packages:
```
pip install -r requirements.txt
```
### Create a systemd service file:
```
nano /etc/systemd/system/mpn_json.service
```
### Add the following content:
```
[Unit]
Description=Multi-Platform Notification JSON Creator
After=multi-user.target
[Service]
Type=simple
Restart=always
ExecStart=/usr/bin/python3 /opt/mpn_json/mpn_json_creator.py
[Install]
WantedBy=multi-user.target
```
### Start
```
systemctl daemon-reload
```
```
systemctl enable mpn_json.service
```
```
systemctl restart mpn_json.service
```
### Contributing
Contributions are welcome! Feel free to:
### Report bugs
Suggest new platforms
Submit pull requests
Please open an issue first for major changes.
### License
This project is licensed under the MIT License - see the LICENSE file for details.