ChannelWatch: Monitoring Dashboard for Channels DVR
Hey everyone!
ChannelWatch v0.9.9 is available now.
ChannelWatch is a self-hosted monitoring dashboard for Channels DVR. It gives you one place to see what is being watched, what is recording soon, whether your DVRs are healthy, and whether notifications actually delivered.
The current website/wiki docs are here:
ChannelWatch Official Docs Site
Why I built it
Channels DVR is already great at recording and serving TV. ChannelWatch sits beside it and answers the operator questions that come up when you run the DVR yourself:
-
Who is watching live TV right now?
-
Which device started the stream?
-
Did a recording start, finish, stop, cancel, or fail?
-
Is disk space getting tight?
-
Did a notification send, retry, fail, or get rate-limited?
-
Are all DVRs in a multi-DVR setup still reachable?
The goal is simple: run one Docker container, open the web UI, add your DVR, and let ChannelWatch watch the boring-but-important stuff.
What is new in v0.9.9
This update adds the new Update Center and keeps improving the notification fixes reported in this thread.
-
Settings > Updates can now check for compatible ChannelWatch app updates from the web UI.
-
Compatible app-only updates can be verified, backed up, applied, restarted, and rolled back from inside ChannelWatch.
-
Future releases that need a new container image will be marked clearly as container image update required instead of trying to force an unsafe in-app update.
-
Signed update manifests and signed app bundles are now published with the release.
-
Local/private notification destinations can be approved for exact trusted LAN receivers, which helps with local Mattermost and custom Apprise HTTP-style destinations.
-
Live-watch history and session state are recorded before provider delivery, so Recent Activity should keep updating even if Pushover, Apprise, or routed delivery fails.
A quick visual tour
Dashboard overview
The dashboard gives you active streams, uptime, upcoming recordings, disk space, recent activity, and per-DVR status in one place.
Update Center
The new Update Center lets ChannelWatch check for compatible app updates, verify signed update metadata, create a backup, apply the update, restart, and roll back if activation fails.
Multi-DVR setup
ChannelWatch can monitor more than one Channels DVR server, with separate status, history, sessions, and notification routing.
Notification routing
Route alerts by DVR and alert type. For example, send live TV alerts to one destination, recording alerts somewhere else, and disk alerts to a quieter route.
Delivery history
The delivery log shows what sent, what retried, what failed, and which route handled the alert.
Diagnostics and support
Diagnostics gives you connection checks, API checks, alert tests, live logs, debug bundle download, and the Report a Problem support path.
What ChannelWatch monitors
-
Live TV viewing with channel, program, device, IP, and source details
-
VOD and recorded playback with metadata and progress
-
Recording events, including scheduled, started, completed, cancelled, and stopped recordings
-
Disk space with configurable warning and critical thresholds
-
Multiple Channels DVR servers from one dashboard
-
Active sessions across devices
-
Notification delivery history, retries, failures, and circuit-breaker state
-
Health, readiness, metrics, logs, diagnostics, backup, restore, and
/api/v1endpoints
Notification providers
ChannelWatch supports Pushover through Apprise, plus a broad set of Apprise-backed destinations including Discord, Slack, Telegram, email, Gotify, Matrix, and custom Apprise URLs.
It also supports signed outbound webhooks for custom automations.
Install
The website has the current install and migration instructions:
-
Docker Compose install: Install (Docker Compose) | ChannelWatch
-
First-run setup: First-Run Configuration | ChannelWatch
-
Updating ChannelWatch: Updating ChannelWatch | ChannelWatch
-
v0.7 migration guide: Migrating from v0.7 | ChannelWatch
-
Multi-DVR setup: Multi-DVR Overview | ChannelWatch
-
Notification setup: Provider Matrix | ChannelWatch
-
Report a Problem: Report a Problem | ChannelWatch
Short version:
services:
channelwatch:
image: coderluii/channelwatch:latest
container_name: channelwatch
network_mode: host
volumes:
- /mnt/user/appdata/channelwatch:/config
environment:
TZ: America/New_York
CHANNELWATCH_SECRET_STORAGE_KEY: "change-this-to-a-unique-32-character-value"
PUID: "99"
PGID: "100"
restart: unless-stopped
Then open:
http://your-server-ip:8501
The first-run web setup handles auth mode, DVR discovery/manual entry, connection testing, and alert settings.
Images
Docker Hub:
coderluii/channelwatch:0.9.9
coderluii/channelwatch:latest
GHCR:
ghcr.io/coderluii/channelwatch:0.9.9
ghcr.io/coderluii/channelwatch:latest
Published platforms: linux/amd64 and linux/arm64
Requirements
-
Docker and Docker Compose
-
Channels DVR server
-
At least one notification service if you want alerts outside the dashboard
Links
I would really like feedback from anyone who tries it, especially around multi-DVR setups, notifications, migration from v0.7, the new Update Center, and anything that still feels rough.
Cheers,
CoderLuii
v0.8 Development Starting Soon
Bugs: something broken? Share logs or screenshots and I'll dig in.
Features: what's missing? What would make ChannelWatch a must-have for your setup?
Enhancements: something works but could work better? I want to know.
Integrations: other tools or services you want ChannelWatch to play nice with?
