This is absolutely great! It definitely fulfills all my needs at this point
I saw one issue that i had missed before - it wont parse hdhomerun/broadcast channels - pretty sure its because its chopping off the .x number at the end of each one - i had one person streaming 13.1 and it said they were streaming 13 and i actually have a virtual channel there
So when i stream 13.1 it looks like this in channels logs
And in channels admin
And in your notifications
Thanks for all the great work
@bnhf - ChannelWatch is open source with a focus on reliable deployment through Docker. While some core files are compiled to ensure consistent operation, the project's architecture and interfaces remain fully accessible. I'm currently prioritizing stable user experience in these early stages of development. The project's structure and documentation remain transparent for the community.
@Matthew_Crommert - Thank you for sharing your experience with ChannelWatch! I'm glad it's working well for you. I've identified the issue with decimal channels like 13.1 and will fix this in the next release(v0.4) to properly handle subchannels. That Harry Potter notification looks great!
Cheers,
CoderLuii
Indeed I have. Once again, thanks @CoderLuii for expanding the capabilities of this tool. I've added v0.3.0 to OliveTin-for-Channels, with support for multiple DVRs, as before:
Set log_level to 0 to kill the active instance of ChannelWatch for the selected DVR. The icon will remain green as long as there's at least one instance running. Be sure to select at least one notification method.
Also, thanks to some fine stress testing by @TerryD, @Edwin_Perez and @chDVRuser the new OliveTin EZ-Start process is better than ever. Just two env vars for initial spin-up, and there's an Action to help you determine the rest.
@CoderLuii sorry i don't seem to find all of these at the same time
So for virtual channels in plex there doesn't seem to be a corresponding log entry
For example watching my Home Improvement channel
but in logs
And no notification
This one might not be fixable
@Matthew_Crommert - Thanks for sharing these detailed logs! I see the issue now. What you're watching is video-on-demand content from Plex rather than a standard live TV channel. ChannelWatch is currently designed to detect standard channel watching that include channel numbers in the log pattern.
For VOD/recorded content that uses different activity patterns (like your Home Improvement example), I'll need to implement additional detection rules. This is a good enhancement request that I'll add to the roadmap for future development.
Cheers,
CoderLuii
I tried using this and I get this error from channelwatch
[2025-03-25 01:13:55] Log file: /config/channelwatch.log (keeping 7 days)
[2025-03-25 01:13:55] Log level: 2 (Verbose)
[2025-03-25 01:13:55] Starting ChannelWatch v0.3
[2025-03-25 01:13:55] ERROR: CHANNELS_DVR_HOST environment variable not set
Let's move this discussion over to the OliveTin thread...
I've been working around the clock on ChannelWatch v0.4, and it's packed with improvements based directly on your feedback! Here's what's coming:
Program Titles - See exactly what's playing on each channel directly in notifications
Program Images - Choose between channel logos or actual program images in alerts
Enhanced Metadata - Richer program information with improved formatting
Decimal Channel Support - Full support for subchannels (13.1, etc.) for broadcast/OTA channels
Total Streams Counter - See how many concurrent streams are active across your system
Stream Source Identification - Cleaner display of M3U, TVE, and Tuner sources
VOD/Recorded Content Detection - New support for virtual channels and recorded content
Disk Space Monitoring - Configurable alerts when recording space runs low (by % or GB)
24-hour Program Cache - Extended program data caching for better performance
Performance Optimizations - Preloaded cache at startup for faster operation
Expanded Configuration - Control exactly what appears in your notifications
Cache Management - Configurable TTLs and improved validation
I'm in the final stages of development for v0.4 - is there anything else you'd like to see included? Now's your chance to get your requests in before release! Drop a comment below with any ideas or suggestions you have.
All these changes make ChannelWatch more feature-rich, configurable and robust, while maintaining compatibility with previous versions.
Coming very soon!
Cheers,
CoderLuii
ChannelWatch v0.4.0 RELEASED - Major Feature Expansion!I'm thrilled to announce that ChannelWatch v0.4.0 is now available! This release represents a major expansion of capabilities, with several key enhancements requested directly by the community. Your feedback has been invaluable in shaping this update.
NEW: VOD-Watching AlertAs requested by @Matthew_Crommert, we now fully support tracking recorded/VOD content! This new alert type provides:
No more missed notifications when watching recorded content or virtual channels!
NEW: Disk-Space MonitoringKeep an eye on your DVR storage with configurable alerts when space runs low:
Channel-Watching Improvements
System Improvements
Bug Fixes
How to Update
docker pull coderluii/channelwatch:latest
docker-compose down
docker-compose up -d
If you're using @bnhf's excellent OliveTin integration, watch for updates there soon!
Thank You!This release would not have been possible without the valuable feedback and suggestions from our amazing community. Special thanks to:
I'm committed to continuing development of ChannelWatch based on your needs. If you have any issues or suggestions for future versions, please don't hesitate to let me know!
Cheers,
CoderLuii
The low disk space warning looks good. 
Thank you for this great release! 
My pleasure. The new v0.4.0 looks pretty slick.
Added to bnhf/olivetin:latest (aka bnhf/olivetin:2025.03.31):
EDIT: For those moving from a previous version of the OliveTin version of ChannelWatch, be sure to stop the Channelwatch Action -- and then delete the Channelwatch image in Portainer. Then, with the latest version of OliveTin-for-Channels (2025.03.31), the most recent version of ChannelWatch will be pulled next time you run the OliveTin Action.
ChannelWatch v0.5 RELEASED - Recording Events Alert!I'm excited to announce that ChannelWatch v0.5 is now available! Based on community feedback, this release adds comprehensive monitoring for your DVR recording activities with rich, detailed notifications.
NEW: Recording-Events AlertNow you can track the entire lifecycle of your recordings with real-time alerts! This highly-requested feature provides:
Scheduled notifications when new recordings are added to your DVR
Started alerts when a recording begins capturing content
Completed notifications when recordings finish successfully
Cancelled alerts if scheduled recordings are removed before starting
Stopped notifications when recordings are manually ended earlyEach alert includes rich metadata with program details, channel information, precise timing, and duration statistics.
Never miss a DVR activity again - whether recordings are scheduled in advance, start capturing, complete successfully, or get cancelled!
Enhanced FeaturesAs always, upgrade to the latest version with coderluii/channelwatch:latest. Your feedback helps shape future releases - please keep it coming!
Cheers,
CoderLuii
This is amazing, thanks so much for your work on this! Is there an alert to tell you if a scheduled recording failed for some reason?
@augie0041 Thanks for the kind words!
Yes, ChannelWatch will alert you if a scheduled recording fails. When a recording doesn't complete properly, it will show up as " Completed (Interrupted)" in the notification.
You'll get the same detailed notification format as other recording events, including the channel information, program details, and duration, so you'll know exactly which recording had issues.
Here are examples of what both interrupted and delayed recording notifications would look like:
For an Interrupted Recording:
📺 NBC
Channel: 5
Status: ✅ Completed (Interrupted)
Program: The Tonight Show
-----------------------
Duration: 15 minutes
Total Streams: 1
Jimmy Fallon interviews celebrity guests and features musical performances.
For a Delayed Recording:
📺 ESPN
Channel: 206
Status: ✅ Completed (Delayed)
Program: Monday Night Football
-----------------------
Duration: 3 hours 15 minutes
Total Streams: 1
Live coverage of NFL Monday Night Football featuring postgame analysis and highlights.
Have you been having any specific issues with your recordings?
Is there any suggestions you'd like to see in the upcoming release of ChannelWatch v0.6?
Cheers,
CoderLuii
Yes, an example is when I'm in a blackout region for an MLB game or one of the custom channels I've programmed such as m0ngr31's ESPNTV docker app that I need to go in and re validate my TVE or MLBTV credentials as quick as possible to not miss the game I'm recording.
Finally, is there a way to suppress some notifications, because I extend almost all of my live game recordings by 2-3 hours in case of overtime, rain delays, etc, and Channels provides a confusing message next to every recording that it was recorded but was interrupted. It works fine so I never said anything, but I certainly don't need a notification telling me this every day.
@augie0041 - Regarding the TVE/MLBTV credential validation issue - I'd need more details about exactly what happens during these credential failures to better understand if there's a way ChannelWatch could help. Since each provider handles authentication differently, this would be helpful to know for improving error handling.
For suppressing notifications - you have a few options:
You can completely disable specific alert types in your docker-compose.yml by setting:
ALERT_RECORDING_EVENTS: FALSE
For more granular control, you can disable just completed recording alerts while keeping scheduled/started notifications:
RD_ALERT_COMPLETED: FALSE
If you only want to suppress notifications during certain times, most notification providers (like Pushover) have quiet hours or temporary muting options.
I recommend checking the main configuration post for all available options:
Nice @CoderLuii! v0.5 now integrated into OliveTin-for-Channels via bnhf/olivetin:latest (aka bnhf/olivetin:2025.04.03), with the usual support for multiple DVRs. Tailscale MagicDNS and other hostnames also supported -- as they are throughout OliveTin. There's a DNS override option as well.
All the upside of the OliveTin-for-Channels approach to the multitude of scripts and tricks available for Channels DVR with centralized management, a common user interface, and leveraging of a single set of variables representing your CDVR installation:
EDIT: Also, with this update, you only need to kill your background versions of Channelwatch in the OliveTin interface -- followed by updating OliveTin-for-Channels. This will automatically bring Channelwatch to v0.5.
@augie0041 Thanks for adding the screenshots! I didn't get notified when you updated your post, so I just saw these now.
I see the issues you're encountering - those M3U/playlist errors are actually part of Channels DVR's core functionality rather than something ChannelWatch currently monitors. This would require a completely new module focused on error detection and reporting, which isn't part of the current recording alert system.
To build something like this properly, I'd need to:
If you'd be interested in helping with development, would you mind sending me a list of the common errors you encounter (either via private message or just a list)? I'm going to scrape the community forums as well to identify the most common issues users face.
For your specific blackout/credential validation issues, this would be particularly valuable information since I don't have a TVE setup to test with.
This will take a few iterations to get right, but I think it could be very useful for many users!
Cheers,
CoderLuii
ChannelWatch v0.6: Modern Web UI Coming Soon!
Hey everyone!
I've been working on something really exciting for ChannelWatch, and I wanted to give you all a preview of what's coming in version 0.6! This update completely transforms the user experience with a modern web interface and dramatically simplifies setup.
What's Coming in v0.6 Super Simple SetupInstallation will be as simple as:
version: '3.0'
services:
ChannelWatch:
image: coderluii/channelwatch:latest
container_name: channelwatch
network_mode: host
volumes:
- /your/local/path:/config
restart: unless-stopped
That's it! Just access http://your-server-ip:8501 to configure everything through the web UI.
All the notification features you love (channel watching, VOD tracking, recording events, disk space monitoring) will still be there, but now with an interface that makes everything infinitely easier to set up and monitor.
I'm putting the finishing touches on it now and will share the full release soon!
Special thanks to @Matthew_Crommert, @Jean0987654321, @augie0041, @mjitkop, @TerryD, @Edwin_Perez, and @chDVRuser for all your feedback and support on previous versions - your input has been invaluable in shaping ChannelWatch's evolution!
What do you think about the new design? Let me know in the comments below!
Cheers,
CoderLuii
@CoderLuii Looks like I pretty much wasted my time front-ending ChannelWatch, eh? 
Looks great though. I'll likely move it from an OliveTin-for-Channels Action, to a Project One-Click deployment.
BTW, I don't believe I'm seeing any art in notifications when channels are tuned via ah4c, cc4c or ADBTuner. Any fix for that coming in this release?