Stream Master Watchdog

Stream Master Watchdog is a Python script designed to monitor streams in the StreamMaster application. It ensures uninterrupted streaming by detecting buffering issues and automatically switching to the next stream if buffering persists for a configurable period.

Features

• Monitors streams for buffering issues in real-time.
• Displays the current speed of each stream being monitored.
• Detects buffering below a configurable speed threshold.
• Automatically switches to the next stream after prolonged buffering.
• Logs relevant messages to the console, including buffering detection and resolution status.

Requirements

• Python 3.8 or higher
• Dependencies:
  • requests

Installation

1. Clone this repository:

   git clone https://github.com/SergeantPanda/StreamMaster-Watchdog.git
   cd StreamMaster-Watchdog

2. Install required Python dependencies:

   pip install requests

3. Ensure ffmpeg is installed and available on your system.

Configuration

Update the following variables in the script to match your environment:

• SERVER_URL: Base URL of your StreamMaster server (e.g., http://localhost:7095).
• USER_AGENT: Identifier used for the watchdog client.
• QUERY_INTERVAL: Interval (in seconds) to query the API for stream updates. Setting this faster will not speed up buffer detection. (default: 5)
• BUFFER_SPEED_THRESHOLD: Speed threshold to detect buffering. (default: 1.0)
• BUFFER_TIME_THRESHOLD: Time (in seconds) to wait before switching streams when buffering. (default: 30)
• BUFFER_EXTENSION_TIME: Time (in seconds) to add to the buffer timeout after switching streams. (default: 10)
• FFMPEG_PATH: Path to your ffmpeg executable.
• MODULE: Module name to use. (default: Stream_Master)

Usage

1. Start the script:

   python stream-master-watchdog.py

2. The script will:
   • Periodically query the StreamMaster API for active streams.
   • Monitor each stream's speed using FFmpeg.
   • Switch to the next stream if buffering persists.

Docker Compose Example

You can deploy Stream Master Watchdog using Docker Compose for easier setup and management.

version: "3.8"
services:
  streammasterwatchdog:
    image: sergeantpanda/streammasterwatchdog:latest
    container_name: StreamMasterWatchdog
    environment:
      - SERVER_URL=http://STREAMMASTER:7095
      - QUERY_INTERVAL=5 # Optional
      - USER_AGENT=Buffer Watchdog # Optional
      - BUFFER_SPEED_THRESHOLD=1.0 # Optional
      - BUFFER_TIME_THRESHOLD=30 # Optional
      - BUFFER_EXTENSION_TIME=10 # Optional
      - FFMPEG_PATH=/usr/bin/ffmpeg # Optional - Don't change unless you know what you're doing
      - MODULE=Stream_Master # Optional
      - TZ=US/Central # Optional
    restart: unless-stopped
    logging:
      driver: "json-file"
      options:
         max-size: "10m"
         max-file: "3"

API Integration

The script uses the following StreamMaster APIs:

Get Channel Metrics

• Endpoint: /api/statistics/getchannelmetrics
• Method: GET
• Purpose: Fetches the current active streams and client details.

Move to Next Stream

• Endpoint: /api/streaming/movetonextstream
• Method: PATCH
• Payload:

  {
    "SMChannelId": <stream_id>
  }

• Purpose: Commands StreamMaster to switch to the next stream.

Example Output

Starting stream watchdog monitor...
Started watchdog for channel ID: 101 - Sports Channel
Started watchdog for channel ID: 102 - Movie Channel
Started watchdog for channel ID: 103 - News Channel
Channel ID: 101 - Current Speed: 1.2x - Sports Channel
Channel ID: 102 - Current Speed: 1.0x - Movie Channel
Channel ID: 103 - Current Speed: 0.8x - News Channel
Buffering detected on channel 103 - News Channel.
Channel ID: 103 - Current Speed: 0.6x - News Channel
Buffering persisted on channel 103 (News Channel) for 30.05 seconds.
Attempting to switch to the next stream for channel 103...
Switched to the next stream for channel 103. Added 10 seconds to buffer timer.
Channel ID: 101 - Current Speed: 1.2x - Sports Channel
Channel ID: 102 - Current Speed: 1.0x - Movie Channel
Channel ID: 103 - Current Speed: 1.1x - News Channel (New Stream)
Buffering resolved on channel 103 - News Channel.

Contributing

Contributions are welcome! Feel free to submit issues or pull requests to improve this script.

License

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.

Acknowledgments

Special thanks to the Stream Master developer Senex for providing a robust API to enhance streaming experiences.