ChannelWatch: The Complete Monitoring Dashboard for Channels DVR

Playground Hacks
#1

favicon
favicon1280×1280 197 KB
ChannelWatch: The Complete Monitoring Dashboard for Channels DVR

Hey everyone!

ChannelWatch v1.0 is coming soon. Scroll down for the latest update. The overview below reflects v0.7 (the current release) and will be updated when v1.0 drops.

ChannelWatch is a comprehensive monitoring solution with a modern web interface that tracks Channels DVR activity and sends real-time notifications whenever viewing activity occurs, recordings change status, or system conditions change.

What It Does

ChannelWatch provides real-time monitoring with detailed notifications for:

  • :iphone: Live TV viewing with channel and program details
  • :clapper: VOD/recorded content playback tracking with metadata and progress
  • :red_circle: Complete recording lifecycle tracking (scheduled, started, completed, cancelled, stopped)
  • :floppy_disk: Disk space monitoring with customizable thresholds and visual dashboard
  • :bell: Multi-device awareness and session tracking across all clients
  • :globe_with_meridians: Modern web dashboard for configuration and system status monitoring
  • :bar_chart: Real-time status overview with active streams and upcoming recordings
  • :hammer_and_wrench: Built-in diagnostic tools accessible directly from the web UI
  • :desktop_computer: Multi-DVR support for monitoring multiple Channels DVR servers
  • :lock: API key authentication and security hardening

Key Features

  • Multiple Alert Types:
    • Channel-Watching for live TV
    • VOD-Watching for recorded content
    • Recording-Events for DVR activity
    • Disk-Space for storage monitoring
  • Rich Notifications:
    • Program information with titles and descriptions
    • Channel information with logos
    • Device and stream details
    • Playback progress for recorded content
    • Recording status with timing information
  • System Features:
    • Real-time event monitoring with minimal resource usage
    • Multiple notification options: Pushover, Discord, Slack, Telegram, Email and more!
    • Runs as a Docker container with multi-platform support (amd64, arm64, arm/v7)
    • Tailscale / MagicDNS support
    • Comprehensive configuration options
    • Open source and free to use

Example Notifications

Channel Watching Alert

📺 ABC
Channel: 7
Program: Good Morning America
Device: Living Room
IP: 192.168.1.101
Source: HDHR

VOD Watching Alert

🎬 Crank: High Voltage (2009)
Duration: 58m 46s / 1h 42m 11s
Device Name: Living Room
Device IP: 192.168.1.100

Rating: R · Genres: Action, Thriller
Cast: Jason Statham, Amy Smart, Dwight Yoakam

Disk Space Alert

⚠️ Low Disk Space Warning
Free Space: 200.59 GB / 1.82 TB (10.8%)
Used Space: 1.62 TB
DVR Path: /shares/DVR

Recording Events Alerts

Scheduled Recording Alert

📺 ACTION NETWORK
Channel: 137
Status: 📅 Scheduled
Program: Batman (1989)
-----------------------
Scheduled: Today at 8:54 AM EDT
Duration:  2 hours 16 minutes

Caped Crusader (Michael Keaton) saves Gotham City from the Joker (Jack Nicholson).

Recording Started Alert

📺 MOVIE CHANNEL
Channel: 129
Status: 🔴 Recording (Manual)
Program: Crank: High Voltage (2009)
-----------------------
Recording: 8:49 AM EDT
Program:   8:48 AM EDT
Duration:  1 hour 42 minutes
Total Streams: 1

Chev Chelios (Jason Statham) seeks revenge after someone steals his nearly indestructible heart.

Recording Completed Alert

📺 MOVIE CHANNEL
Channel: 129
Status: ✅ Completed
Program: Pet Sematary (1989)
-----------------------
Duration: 1 hour 54 minutes
Total Streams: 1

A doctor (Dale Midkiff) and his family move to a town near an ancient Indian burial ground.

How to Install

Installation is simple with Docker. Here's a complete setup:

name: channelwatch
services:
  channelwatch:
    image: coderluii/channelwatch:latest
    container_name: channelwatch
    network_mode: host
    init: true
    volumes:
      - /your/local/path:/config
    restart: unless-stopped

All configuration is done through the web UI at http://your-server-ip:8501

Note:

  • For bridge networking, replace network_mode: host with:
network_mode: bridge
ports:
  - "8501:8501"

Requirements

  • Docker and Docker Compose
  • Channels DVR server
  • At least one notification service configured (Pushover, Discord, Telegram, etc.)

Get It Now

I'd love to hear your feedback and suggestions for future features!

#2

:hammer_and_wrench: v0.8 Development Starting Soon

First, I owe you all an explanation. I went quiet for a while. Life hit me from a few directions at once. Health stuff knocked me down, the day job got intense, and I just needed to step back and take care of things. I never abandoned the project, but I had to put myself first for a bit. I'm back now, feeling good, and ready to get back to work.

I've been building ChannelWatch solo since day one. And if I'm being honest? The features people use the most weren't my ideas. They came from you guys.

→ Apprise integration? Community request.
→ Device tracking? Community request.
→ Disk space alerts? Someone here asked for it.

So let's do it again. v0.8 is a blank canvas.

Tell me what you need:

:bug: Bugs: something broken? Share logs or screenshots and I'll dig in.

:sparkles: Features: what's missing? What would make ChannelWatch a must-have for your setup?

:wrench: Enhancements: something works but could work better? I want to know.

:bulb: Integrations: other tools or services you want ChannelWatch to play nice with?

Already on my list:

→ Multi-DVR support: multiple Channels DVR servers • Planned
→ Channel art fixes: missing images for cc4c/TVE sources • Investigating
→ Bridge mode improvements: easier setup without host networking • Planned
→ Notification upgrades: more Apprise providers, richer formatting • Ongoing

I'll keep this list updated as things come in. Can't promise timelines since it's still just me, but every single reply gets read.

Reply here or open an issue on GitHub. Whatever works for you.

Let's make v0.8 the best one yet! :rocket:

Cheers,
CoderLuii
CoderLuii

1 Like
#3

Were you ever able to identify the issue where ChannelWatch sent thousands of notifications through my Pushover account?

#4

Hey @bnhf, thanks for bringing this up again. I honestly don't have enough details yet to pinpoint what caused the notification flood on your end.

If you still have any logs from when it happened, that would be really helpful. Otherwise, rate limiting is already on my priority list for v0.8 so this kind of thing can't happen again regardless of the root cause.

If you're open to it, could you create a GitHub issue with whatever info you have? Even timestamps or a rough description of what was running at the time would help me narrow it down.

I take this seriously and I want to make sure it's properly addressed before the next release.

Cheers,
CoderLuii
CoderLuii

#5

Since this happened 9 or 10 months ago, I don't have anything more for you than I posted at the time. After that notification storm, I don't recall firing up the project again.

Given my monthly allowance with Pushover could be used up in a short period of time at the rate they were sent, I wasn't really feeling comfortable running it again. Especially if I happened to be away from my phone when the notifications started rolling in.

Also, I only received a fraction of the notifications that Pushover reported were sent. If you're planning to address this in v0.8, great. Once you roll that out, I'll take a fresh look at it.

3 Likes
#6

Looking forward to seeing the next release.

1 Like
#7

This looks interesting, will give you a chance to bring out your new version.

1 Like
#8

@CoderLuii nice app, but this doesnt work if you don't connect a notification service? why is that mandatory?

after connecting the notification service everything works but when I disable alerts for VOD watching for example, any VOD played won't be recorded in the activity. alerts have to be turned on in order for it to be shown.

is that by design?

it would be great if this can be used without a notification service or at least disable them and still have them be shown in the GUI.

thanks.

2 Likes
#9

@bnhf Totally understand. Nine months is a long time and I wouldn't expect you to have logs from that far back. Rate limiting is happening in v0.8. Not as a "nice to have," it's a hard requirement before release. Configurable thresholds, cooldown periods, the works. I get the Pushover concern. Burning through a monthly allowance because of a bug is not acceptable. When v0.8 drops I'll call it out in the release notes so you know it's safe to give it another shot.

@Jackamus @JefferMC Appreciate you both! Good timing, v0.8 is in active development right now. If either of you spin it up and hit anything weird, let me know here or on GitHub.

@AeroR1 Good question. Right now the notification service is required because that's how ChannelWatch was originally built. It was a notification tool first, and the web dashboard came later. So the activity tracking and the notification pipeline are tied together under the hood.

You're right that it shouldn't have to work that way. I'm adding this to the v0.8 list:

  • Decouple activity tracking from notification delivery
  • Allow ChannelWatch to run in "monitor only" mode without a notification service
  • Disabling an alert type should still log the activity in the UI

That last point is the real one. Turning off VOD alerts shouldn't mean VOD activity disappears from the dashboard. That's a bug, not a design choice. Thanks for flagging it.

Cheers,
CoderLuii
CoderLuii

#10

:rocket: v1.0 is almost here.

Quick update for everyone who's been following along.

What started as v0.8 turned into something much bigger. The amount of work that went into this one earned it the v1.0 name. Every part of ChannelWatch got touched. Here's what's coming.

Dashboard, rebuilt from the ground up. Live uptime ticker, richer stream details with artwork, a real time status panel showing your entire system at a glance, and a completely redesigned activity timeline.

image
image1077×836 208 KB

Clickable activity and recording details. Tap any item in the recent activity list or upcoming recordings to pull up full details instantly.

image
image940×643 66.7 KB

Live log viewer. Built right into the Diagnostics page. Search, filter by level, pause, download. No more SSHing into your container.

image
image1072×719 38.1 KB

Notification rate limiter. Configurable sliding window that keeps you informed without flooding your phone. @bnhf, you reported the notification flood issue that sent thousands of Pushover alerts. That will never happen again.

image
image1077×449 23.1 KB

Multi-DVR support. @chDVRuser, you've been asking for this since the early days. Monitor multiple Channels DVR servers from a single ChannelWatch instance. The most requested feature since day one.

image
image1081×973 60.2 KB

Per DVR and global settings. Full control. Configure each server individually or set defaults across all of them.

image
image996×746 51.5 KB

Light mode. Better version of the previous Light Mode. Fully polished. Every page, every component.

image
image1074×1037 200 KB

Tailscale / MagicDNS support. @bnhf and @chDVRuser, you both ran into DNS and networking issues with bridge mode. This should make things a lot smoother.

I also want to shout out @Jackamus, @Kryptonyte, @Fofer, and everyone else who's been patiently waiting for the next release. @Kryptonyte, you compared ChannelWatch to the old SageTV alerts. That meant a lot. @Fofer, the wait is almost over.

None of this would exist without the people who posted feedback, opened issues, and kept pushing for improvements. Genuinely, thank you. This community shaped what v1.0 became.

Aiming to release within the next week. Full release notes and screenshots coming with it.

Cheers,
CoderLuii

CoderLuii

#11

Wow, it looks amazing. I will be reinstalling and setting it up as soon as it is available. I hope the Olivetin One click project will still work to set up the 0.7 version and then will pull the new version.

#12

It will. The current version is currently on the "deprecated" page (and can still be installed from there), but I'll move it back to the main Project One-Click page once the new version is available.