Release Notes

v1.0 — Current release

Tip

ChannelWatch v1.0 is the current production release. It replaces the older single-DVR preview model with a multi-DVR-first architecture and a cleaner installation story.

Caution

Two items remain in progress as of v1.0. T20c (async runtime-path lock migration) affects alert_manager.py, stream_tracker.py, and session_manager.py. The per-DVR isolation behavior is real; the lock strategy is not yet finalized. T27 (encryption bootstrap) has active coverage: ChannelWatch persists per-DVR API keys as Fernet-encrypted values under settings.json with /config/encryption.key, and key rotation/debug utilities are available. See the CHANGELOG for status updates.

Highlights

• Multi-DVR support by default — monitor more than one Channels DVR server from a single install.
• Credential hardening — per-DVR API keys are encrypted at rest in settings.json via Fernet (/config/encryption.key), while UI secret values are not exposed in plaintext.
• Notification routing by DVR — route each DVR to different providers if you want.
• Improved diagnostics — better troubleshooting guidance, health probes, and debug-bundle support.
• Expanded notification coverage — built-in setup docs for Pushover, Discord, Telegram, Slack, Email, Gotify, Matrix, and custom Apprise.

Breaking changes from older previews

• CHANNELS_DVR_HOST and CHANNELS_DVR_PORT are no longer first-class setup inputs.
• First-run setup now happens through the web UI wizard and the v1.0 multi-DVR configuration model.
• Some older single-DVR assumptions in preview deployments are migrated automatically. See the migration guide.

Not in v1.0

The following are deliberately not part of this release:

• SSO / OIDC
• built-in historical analytics dashboards
• distributed / HA mode
• mobile app / PWA

See the roadmap for planned future work.

New docs to read first

• Install with Docker
• First-Run Configuration
• Multi-DVR Overview
• Notification Provider Matrix
• Migration Guide

---

Version history (v0.1 through v0.7)

The entries below are sourced from the app repository README. Exact release dates are not recorded in the source material; version headings are used without fabricated dates.

v0.7

Notification enhancements release. Improved email and Discord integration, UI documentation improvements, and bug fixes for image selection.

v0.6

Complete project restructuring. Introduced the modern web UI, simplified configuration (no environment variables required), a responsive dashboard, and enhanced error recovery.

v0.5

Recording-Events alerts added. Covers the full recording lifecycle: scheduled, started, completed, cancelled, and stopped events. Also includes enhanced stream count integration and improved time formatting.

v0.4

Expanded alert types. Added VOD-Watching and Disk-Space monitoring. Enhanced Channel-Watching with program details and images, and improved session tracking.

v0.3

Complete architecture overhaul. Introduced real-time event monitoring, multi-provider notifications, session tracking, and enhanced stability.

v0.2

Security update release. Addressed Python dependency vulnerabilities and added Docker supply chain attestations.

v0.1

Initial release. Core monitoring and notification features.

---

Related pages

• Roadmap
• Migration Guide
• Provider Matrix
• CHANGELOG