https://github.com/eyaadh/iptv-stream-checker
This Python script monitors a list of UDP streams (unicast or multicast) and sends a Telegram notification if any streams are inactive or unreachable.
https://github.com/eyaadh/iptv-stream-checker
monitoring multicast python3 requests socket telegram udp
Last synced: 7 days ago
JSON representation
This Python script monitors a list of UDP streams (unicast or multicast) and sends a Telegram notification if any streams are inactive or unreachable.
- Host: GitHub
- URL: https://github.com/eyaadh/iptv-stream-checker
- Owner: eyaadh
- Created: 2025-04-21T07:00:02.000Z (9 days ago)
- Default Branch: main
- Last Pushed: 2025-04-21T07:17:03.000Z (9 days ago)
- Last Synced: 2025-04-21T08:29:24.117Z (9 days ago)
- Topics: monitoring, multicast, python3, requests, socket, telegram, udp
- Language: Python
- Homepage:
- Size: 4.88 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🔍 IPTV UDP Stream Checker with Telegram Alerts
This Python script monitors a list of UDP streams (unicast or multicast) and sends a Telegram alert if any stream becomes inactive or unreachable.
Perfect for IPTV providers, network admins, or anyone relying on uninterrupted UDP stream delivery.
---
## 🚀 Features
- ✅ Supports both multicast and unicast UDP streams.
- ✅ Retries failed stream checks before declaring them down.
- ✅ Optional requirement for receiving actual data (for more accurate checks).
- ✅ Sends real-time alerts to Telegram when streams go down.
- ✅ Uses a scheduler to run periodic checks (default: **every 1 hour**).
- ✅ Detailed logs for monitoring, alerts, and debugging.
---
## 📦 Requirements
- Python 3.6+
- Install dependencies using:
```bash
pip install -r requirements.txt
```
Contents of `requirements.txt`:
```txt
requests==2.32.3
apscheduler==3.10.4
```
---
## ⚙️ Configuration
Create a file named `config.json` in the same directory:
```json
{
"telegram": {
"bot_token": "your_telegram_bot_token_here",
"chat_id": "your_telegram_chat_id_here"
},
"streams": {
"udp": [
{
"name": "Channel 1",
"url": "udp://239.1.1.1:1234"
},
{
"name": "Channel 2",
"url": "udp://239.1.1.2:5678"
}
]
}
}
```
- Replace `bot_token` and `chat_id` with your Telegram bot credentials.
- Add as many UDP streams as needed, each with a descriptive `name` and valid `url`.
---
## 📡 How It Works
1. Loads UDP streams and Telegram bot settings from `config.json`.
2. Parses each stream's address and checks for availability.
3. If multicast, joins the group before checking.
4. Optionally listens for real UDP traffic (`require_data=True`).
5. Retries failed streams before marking them as down.
6. Sends a Telegram alert if any streams are unreachable.
---
## 🛠️ Usage
Run the script with:
```bash
python main.py
```
What it does:
- Immediately runs a stream check.
- Starts a background scheduler that checks **every hour**.
- Keeps running until terminated manually.
---
## 🔄 Customization
You can adjust the stream-check behavior by modifying the parameters inside the `scheduled_task()` function:
```python
check_channels(
udp_streams,
timeout=10, # Timeout per attempt (in seconds)
retry_attempts=2, # Number of retries before failure
retry_delay=2, # Delay between retries (in seconds)
require_data=True # Set to True to require actual packet reception
)
```
---
## 📬 Telegram Bot Setup
1. Message [@BotFather](https://t.me/BotFather)
2. Create a new bot: `/newbot`
3. Copy the generated `bot_token`
4. To find your chat ID:
- Start a conversation with your bot.
- Visit:
```
https://api.telegram.org/bot/getUpdates
```
- Look for `"chat":{"id":...}` in the JSON response.
---
## 📝 Example Telegram Alert
```
🚨 IPTV Stream Alert 🚨
The following channels are DOWN:
- Channel 1: No response or timeout
- Channel 2: Invalid URL
```
---
## 📄 License
MIT License — free to use, modify, and distribute.
---
## 👨💻 Author
Built with ❤️ by **eyaadh**
📧 Email: [email protected]
💬 Telegram: [@eyaadh](https://t.me/eyaadh)