Skip to content
ChannelWatch

Welcome to the ChannelWatch handbook

Where to start

Configure

Walk through the first-run wizard, connect your DVR, and set your timezone and log level. First-Run Configuration

Notification Providers

Send alerts to Pushover, Discord, Telegram, Slack, Email, Gotify, Matrix, or any Apprise target. Browse providers

Release Notes

Read what changed in the v1.0 production release before you migrate or deploy. What's new in v1.0

Provider Matrix

Compare notification providers by setup effort, best-fit workflow, and rich media support. Open the provider matrix

What ChannelWatch monitors

ChannelWatch watches your Channels DVR server and fires a notification the moment something happens:

  • Channel watching - who is watching what, and on which tuner
  • VOD watching - on-demand playback events
  • Recording events - scheduled recordings starting, completing, or failing
  • Disk space - threshold alerts before your drive fills up

All event types are configurable. You can enable only the ones you care about.

Multi-DVR support

ChannelWatch v1.0 supports multiple Channels DVR servers from a single container. Add servers through the web UI or via YAML config, and route each server's notifications to a different provider if you want. See the Multi-DVR overview for details.

Choose your path

Not sure where to go next? Pick the description that fits your situation.

First-time installer

Start with the Docker Compose guide. Once the container is up, the First-Run Configuration page walks you through connecting your DVR and choosing a notification destination. The Provider Matrix helps you compare providers before you commit to one.

Upgrading to v1.0

Read the Release Notes first, then use the Migration guide if you're coming from v0.7.

Troubleshooting an issue

Start with Common Issues. If you need more detail, open Diagnostics, review the CLI Commands reference, or check the FAQ.

Need help?

Check Common Issues first, then run channelwatch doctor for a self-diagnostic report. The FAQ covers the most frequent questions.