zackwag/channels2mqtt

By zackwag

•Updated 5 months ago

Bridges Channels DVR to Home Assistant via MQTT Discovery.

Image

Integration & delivery

Monitoring & observability

1.3K

Overview Tags

zackwag/channels2mqtt repository overview

⁠Channels2MQTT

Channels2MQTT bridges your Channels DVR Server⁠ to MQTT, enabling seamless Home Assistant integration via MQTT Discovery.

Automatically creates and manages three sensors in Home Assistant:

📺 Latest Recording — updates only when a genuinely new recording is completed
⏸️ All Recordings — full library with count and metadata
📡 Upcoming Recordings — scheduled recordings with full program details

⁠Features

Zero configuration in Home Assistant — sensors appear automatically via MQTT Discovery
Configurable watched filter for latest and all recordings
Optionally include in-progress recordings in latest recording
No false notifications when watched recordings are removed from the queue
Upcoming recordings automatically removed when their start time passes
Fully configurable via environment variables

⁠Quick Start

services:
  channels2mqtt:
    image: zackwag/channels2mqtt:latest
    container_name: channels2mqtt
    restart: unless-stopped
    environment:
      - CHANNELS_HOST=192.168.x.x
      - MQTT_HOST=192.168.x.x
      - MQTT_USER=your_mqtt_username
      - MQTT_PASS=your_mqtt_password

⁠Environment Variables

Variable	Required	Default	Description
`CHANNELS_HOST`	✅	—	Channels DVR server IP address
`CHANNELS_PORT`	❌	`8089`	Channels DVR server port
`MQTT_HOST`	✅	—	MQTT broker IP address
`MQTT_PORT`	❌	`1883`	MQTT broker port
`MQTT_USER`	✅	—	MQTT username
`MQTT_PASS`	✅	—	MQTT password
`MQTT_TOPIC`	❌	`channels2mqtt/latest_recording`	Topic for latest recording
`UPCOMING_TOPIC`	❌	`channels2mqtt/upcoming_recordings`	Topic for upcoming recordings
`ALL_RECORDINGS_TOPIC`	❌	`channels2mqtt/all_recordings`	Topic for all recordings
`POLL_INTERVAL`	❌	`60`	Poll interval in seconds
`LATEST_INCLUDE_WATCHED`	❌	`false`	Include watched in latest recording
`ALL_INCLUDE_WATCHED`	❌	`false`	Include watched in all recordings
`LATEST_INCLUDE_IN_PROGRESS`	❌	`false`	Include in-progress recordings in latest

⁠Versions

Tag	Description
`latest`	Most recent stable release
`1.2.0`	Fix false notifications when watched recordings shift queue position
`1.1.0`	Fix notification firing on recording start; add `LATEST_INCLUDE_IN_PROGRESS`
`1.0.0`	Initial release

Tag summary

Recent tags

Content type

Image

Digest

sha256:d0285d803…

Size

46.4 MB

Last updated

5 months ago

docker pull zackwag/channels2mqtt