HDHomeRun DVR API: How can I determine which airing instance a series recording rule has selected?

Want to write your own code to work with a HDHomeRun or work with the HDHomeRun DVR? We are happy to help with concepts, APIs, best practices.
Post Reply
JPTapt
Posts: 2
Joined: Tue Jul 21, 2026 5:34 am

HDHomeRun DVR API: How can I determine which airing instance a series recording rule has selected?

Post by JPTapt »

I am trying to understand how the DVR determines the exact airing instance that will be recorded.

For a series recording rule, the guide data can contain multiple airings of the same episode. For example:

Grantchester on Masterpiece
S11E08

- Aug 2 9:00 PM - Channel 30.1
- Aug 3 5:00 PM - Channel 30.1
- Aug 3 2:00 AM - Channel 30.1

The HDHomeRun app shows a red recording indicator next to the specific airings that are scheduled to record. I would like to retrieve that same information through an API.

I can retrieve:
- Series information from recorded_files.json
- Episode listings from:
https://api.hdhomerun.com/api/episodes? ... &SeriesID=...
- Upcoming recordings from:
https://api.hdhomerun.com/api/upcoming_ ... eviceAuth=...

However, I have not found an API response that identifies the actual selected airing instance (ProgramID + StartTime + ChannelNumber) that the DVR has scheduled.

The episode API returns fields like:
- ProgramID
- StartTime
- RecordingRule
- RecordingRuleExt (RecordIfNotRecorded / RecordDuplicate)

but those appear to indicate that the episode matches a rule, not which specific airing will be recorded.

Is there a DVR endpoint or API call that exposes the scheduled recording instances before they occur?

Ideally I am looking for something equivalent to:

{
"ProgramID": "EP025199990078",
"ChannelNumber": "30.1",
"StartTime": 1785718800,
"Status": "Scheduled"
}

The goal is to display the same information as the HDHomeRun app: show the actual scheduled airing, and when selected, show the other possible airings with the scheduled one marked.

Thanks

jasonl
Silicondust
Posts: 17858
Joined: Sun Oct 28, 2007 9:23 pm
x 115

Re: HDHomeRun DVR API: How can I determine which airing instance a series recording rule has selected?

Post by jasonl »

When a recording is scheduled to start, the DVR will check to see if that episode exists on the DVR already, and if not, it will attempt to record it. If it succeeds, then at the next scheduled recording it will see that recording on the DVR and not record it. If it fails (no signal, no tuners available, etc.) then the recording won't be there and the process repeats. If the first one succeeds and you delete it and mark it to not rerecord, then the later airings will no longer be scheduled to record.

JPTapt
Posts: 2
Joined: Tue Jul 21, 2026 5:34 am

Re: HDHomeRun DVR API: How can I determine which airing instance a series recording rule has selected?

Post by JPTapt »

Thank you. That's what I needed.

Post Reply