Skip to content
ChannelWatch

Recording Events

Recording Events alerts track the full lifecycle of a DVR recording. You can enable or disable notifications for each stage independently, so you only hear about the transitions that matter to you.

Lifecycle stages

Section titled “Lifecycle stages”

ChannelWatch handles these recording states. Each notification includes a status emoji so you can identify the stage at a glance.

State Emoji When it fires
Scheduled 📅 A new recording job is created and its start time is more than 30 seconds away
Started 🔴 The DVR begins actively recording (manual or scheduled)
Completed ✅ The recording finishes and the file is processed
Cancelled 🚫 A scheduled recording job is deleted before it starts
Stopped ⏹️ An in-progress recording is stopped before its scheduled end time
Failed ⚠️ The DVR reports that the recording failed
Skipped ⏭️ The DVR skips the scheduled recording
Missed ⚠️ The recording window passes without a completed recording
Interrupted ⏹️ An active recording ends unexpectedly

Options

Section titled “Options”

Configure Recording Events in the web UI under Settings > Alerts > Recording Events.

Option Config key Description
Scheduled Events rd_alert_scheduled Send an alert when a recording is scheduled
Started Events rd_alert_started Send an alert when a recording begins
Completed Events rd_alert_completed Send an alert when a recording finishes
Cancelled Events rd_alert_cancelled Send an alert when a scheduled recording is cancelled
Failed Events rd_alert_failed Send an alert when a recording fails
Skipped Events rd_alert_skipped Send an alert when the DVR skips a recording
Missed Events rd_alert_missed Send an alert when a recording is missed
Interrupted Events rd_alert_interrupted Send an alert when a recording is interrupted
Show Program Name rd_program_name Include the program title in the notification
Show Description rd_program_desc Include the program summary
Show Duration rd_duration Include the recording duration
Show Channel Name rd_channel_name Include the channel name
Show Channel Number rd_channel_number Include the channel number
Show Recording Type rd_type Indicate whether the recording is scheduled or manual

Each event type can be toggled on or off independently. There is no separate Stopped Events toggle in source; stopped notifications are produced from the completed-recording path and follow rd_alert_completed. Fresh installs use the Important Only preset: cancelled, failed, skipped, missed, and interrupted are enabled; scheduled, started, and completed are disabled.

Notification format

Section titled “Notification format”

Notifications use Channels DVR - Recording Event as the default title. The body contains the channel, status, program details, optional summary, and time table.

Scheduled recording:

📺 ACTION NETWORK
Channel: 137
Status: 📅 Scheduled
Program: Batman (1989)
Caped Crusader (Michael Keaton) saves Gotham City from the Joker (Jack Nicholson).
-----------------------
Scheduled: Today at 8:54 AM EDT
Duration:  2 hours 16 minutes

Recording in progress (manual):

📺 MOVIE CHANNEL
Channel: 129
Status: 🔴 Recording (Manual)
Program: Crank: High Voltage (2009)
Chev Chelios (Jason Statham) seeks revenge after someone steals his nearly indestructible heart.
-----------------------
Recording: 8:49 AM EDT
Program:   8:48 AM EDT
Duration:  1 hour 42 minutes
Total Streams: 1

Completed recording:

📺 MOVIE CHANNEL
Channel: 129
Status: ✅ Completed
Program: Pet Sematary (1989)
A doctor (Dale Midkiff) and his family move to a town near an ancient Indian burial ground.
-----------------------
Duration: 1 hour 54 minutes
Total Streams: 1

Cancelled recording:

📺 ACTION NETWORK
Channel: 137
Status: 🚫 Cancelled
Program: Batman (1989)
Caped Crusader (Michael Keaton) saves Gotham City from the Joker (Jack Nicholson).
-----------------------
Scheduled: Today at 8:54 AM EDT
Duration:  2 hours 16 minutes

Stopped recording:

📺 SCI-FI CHANNEL
Channel: 152
Status: ⏹️ Stopped
Program: Pandorum (2009)
Astronauts awake to a terrifying reality aboard a seemingly abandoned spaceship.
-----------------------
Duration: 20 minutes
Total Streams: 1

The “Recording Type” field in the Started notification shows (Scheduled) when the recording came from the scheduled-recordings cache and (Manual) when it started on demand. The Program: time line only appears when the program start time differs from the recording start time by more than 60 seconds.

Testing

Section titled “Testing”

You can send a test Recording Events notification from the Notifications section of the Tests card in Diagnostics without waiting for a real recording to occur. The test sends a sample notification through your configured providers.

From the command line:

Terminal window
docker exec -it channelwatch python -m core.main --test-alert ALERT_RECORDING_EVENTS

Troubleshooting

Section titled “Troubleshooting”

If you stop receiving Recording Events notifications, check the following:

  • Confirm the relevant lifecycle and outcome toggles are enabled in Settings.
  • Verify your notification provider credentials are valid using the Diagnostics tab.
  • Check container logs for any API fetch errors: docker logs channelwatch.
  • Use --monitor-events 60 to watch the raw event stream and confirm ChannelWatch is receiving recording events from the DVR.
Section titled “Related pages”