XMLTV guide data

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
robert@fltvlabs.org
Posts: 3
Joined: Mon Jun 16, 2025 1:36 pm

Re: XMLTV guide data

Post by robert@fltvlabs.org »

Thank you everyone for the guidance.

- I can confirm that all devices have enabled "Sync with guide server" (which was required before the device would include DeviceAuth in the discover.json).
- From the network perspective, I'm reasonably certain there are no outbound firewall deny rules in place that would affect any devices from communicating (Last firmware was recognized and updated smoothly).
- Have logged into the HDhomerun App (v 20250316 app/20250604a ui) on a windows 11 machine on the same network as the devices.
--- All tuner devices appear in the App > settings > devices with a check-mark
--- Under App > settings > Account Information - Was logged in with the email and activation code (first 8 characters), but logged out and back in to double check (original user and activation was purchased under old email robert@fltvlabs.com)
--- not sure if it is relevant but under App > settings > Account Information > DVR Active the interface says "No"
- Used Accept-Encoding flag as recommended by nickk

Code: Select all

curl -H 'Accept-Encoding: gzip' https://api.hdhomerun.com/api/xmltv?DeviceAuth=<any_current_DeviceAuth_string>
403 Forbidden

NedS
Silicondust
Posts: 3402
Joined: Mon Dec 10, 2018 12:38 pm
x 141

Re: XMLTV guide data

Post by NedS »

Changing the e-mail address will change the DVR key. I have e-mailed you your new DVR key.

robert@fltvlabs.org
Posts: 3
Joined: Mon Jun 16, 2025 1:36 pm

Re: XMLTV guide data

Post by robert@fltvlabs.org »

The new DVR code appears to have done the trick, I'm able to pull the zipped xmltv data. Thank you all for your assistance.

SatorSquare
Posts: 1
Joined: Sat Aug 09, 2025 11:42 am

Re: XMLTV guide data

Post by SatorSquare »

Hi! Are there any plans to allow subscribers to create a stable API key to use for accessing this guide data instead of an ephemeral "DeviceAuth" param?

freddienuxx
Posts: 3
Joined: Sat Aug 30, 2025 9:15 am

Re: XMLTV guide data

Post by freddienuxx »

Hello I have a dvr subscription may I have epg url/api key for tv guide? Thx in advance

signcarver
Expert
Posts: 11459
Joined: Wed Jan 24, 2007 1:04 am
Device ID: 10A05954 10802091 131B34B7 13231F92 1070A18E 1073ED6F 15300C36
x 34

Re: XMLTV guide data

Post by signcarver »

freddienuxx wrote: Sat Aug 30, 2025 9:19 am Hello I have a dvr subscription may I have epg url/api key for tv guide? Thx in advance
Access to the API's is given via the DeviceAuth of the device and typically changes every 8 hours unique to your devices.

The device has to be a modern device (I believe not just legacy as legacy devices don't work with the DVR) and associated with your DVR subscription (are you really asking how to do that?) and be able to communicate through the internet to maintain the DeviceAuth and inform SD of your lineup. One would get the DeviceAuth from the discover.json (if you only have one HDHomeRun you should be able to go to hdhomerun.local/discover.json but I usually go by ip address rather than mdns. Then one uses the api URL for the xml, note that whatever requests it must be able to accept a compressed format (gzip) so often one needs to add a parameter to allow that such as:

Code: Select all

curl --compressed https://api.hdhomerun.com/api/xmltv?DeviceAuth=YourActualDeviceAuth > guide.xml

freddienuxx
Posts: 3
Joined: Sat Aug 30, 2025 9:15 am

Re: XMLTV guide data

Post by freddienuxx »

Thx I want the epg url for tivimate
I was told on reddit that you need a dvr subscription to get access via email for url . I have a hdhomerun prime and using my local IP address for m3u url I just don't have epg guide xml for guide. Any help would be great. Thx in advance

signcarver
Expert
Posts: 11459
Joined: Wed Jan 24, 2007 1:04 am
Device ID: 10A05954 10802091 131B34B7 13231F92 1070A18E 1073ED6F 15300C36
x 34

Re: XMLTV guide data

Post by signcarver »

When you purchase the dvr subscription, you should get an email with a code... it used to be clicking on a link on that email would be all one needed to do but years ago most browsers blocked connection to your local devices from a remote site so now activation is done in the HDHomeRun app... see https://info.hdhomerun.com/info/dvr:activation

Have you installed the dvr engine, launched the official hdhomerun app and linked the prime to your dvr account.

Is your prime using cablecard as often there are issues for guide with clear qam as it requires both a virtual channel number and name to be in the psip data. A properly activated cablecard from your provider will have a channel map having that information.

Ken.F
Posts: 2613
Joined: Fri Apr 05, 2013 9:20 am
Device ID: 1041A706, 1043EB32, 104BAD9E, 13168DC5, 1322A7AC
Location: West Rockhill, PA
x 17

Re: XMLTV guide data

Post by Ken.F »

freddienuxx wrote: Sun Aug 31, 2025 1:02 am Thx I want the epg url for tivimate
There's a discussion in this thread about downloading HDHomeRun guide data with EPG123 for use in tivimate starting around page 12.

freddienuxx
Posts: 3
Joined: Sat Aug 30, 2025 9:15 am

Re: XMLTV guide data

Post by freddienuxx »

Okay thank you
Also I'm gonna reach out to customer service and see if I can get a url.
Like sparkle iptv player and notice it always has a unique device auth epg url line for guide. Wondering if they can email a epg url

Post Reply