xteve-channel-alerts

Why?

Occasionally you may find that a channel you want to watch has disappeared from your xTeVe playlist. With xTeVe-Channel-Alerts, you can stay informed about these changes. When configured to run after your automatic xTeVe update, it compares the current channel list with the previous. If xTeVe-Channel-Alerts detects a missing channel, it sends a detailed rich-embed message to your Discord webhook, keeping you in the loop.

Multi-Architecture Support ✅

The Docker image celsian/xteve-channel-alerts:latest is published as a multi-arch image.
Docker (and Unraid) automatically pull the correct build:

No flags are required—Docker fetches the right image.

Quick-start (single run)

docker run -d \
  --name xteve-channel-alerts \
  -e XTEVE_URL="http://192.168.1.100:34400/m3u/xteve.m3u" \
  -e DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/…" \
  -e CRON_SCHEDULE="0 4 * * *" \
  -v /path/to/appdata:/app/data \
  celsian/xteve-channel-alerts:latest

/path/to/appdata is a single directory that the container organises like:

data/
├── logs/   ──▶  app.log , cron.log
└── m3us/   ──▶  current.m3u , previous.m3u

docker-compose example

version: '3'
services:
  xteve-channel-alerts:
    image: celsian/xteve-channel-alerts:latest
    container_name: xteve-channel-alerts
    environment:
      XTEVE_URL: http://192.168.1.100:34400/m3u/xteve.m3u
      DISCORD_WEBHOOK_URL: https://discord.com/api/webhooks/…
      CRON_SCHEDULE: 0 4 * * *        # daily at 04:00
    volumes:
      - ./data:/app/data              # organised sub-dirs: logs/  m3us/
    restart: unless-stopped

Environment variables

Volume mapping

If this volume is not mapped persistently the container will treat every run as the first run and logs will be lost.

Cron schedule

CRON_SCHEDULE accepts any standard five-field cron expression:

Change the variable and restart the container to apply.

Troubleshooting

Updating & backup

• Update – pull the new image and restart; /app/data retains state
• Backup – copy /mnt/user/appdata/xteve-channel-alerts/ to preserve logs and the previous M3U snapshot

Happy monitoring 🎉