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
pjswiderski
Posts: 3
Joined: Mon Mar 18, 2024 3:25 pm

Re: XMLTV guide data

Post by pjswiderski »

OK, I figured it out.

Yes, you need to specify https or "-L" flag.
Also, if you do not have the "--compressed" flag, it fails. Unfortunately, the default Windows curl binary doesn't allow for that flag (WTH?) Tested it in linux with "--compressed", it worked. So, I retested with the curl windows binary downloaded from curl.se, specified https and the --compressed flag, and it works.

Thank you for saving my sanity. I owe you one.

flexduoowner
Posts: 1
Joined: Tue Jun 25, 2024 8:29 pm

Re: XMLTV guide data

Post by flexduoowner »

Would it be possible to get this guide on a Homerun Flex Duo? (HDFX-2US) I was going to buy a subscription but didn't show as supported.

NedS
Silicondust
Posts: 3330
Joined: Mon Dec 10, 2018 12:38 pm
x 124

Re: XMLTV guide data

Post by NedS »

flexduoowner wrote: Tue Jun 25, 2024 8:34 pm Would it be possible to get this guide on a Homerun Flex Duo? (HDFX-2US) I was going to buy a subscription but didn't show as supported.
All FLEX models are also supported.

mkolek99
Posts: 5
Joined: Sun Feb 19, 2023 5:04 pm

Re: XMLTV guide data

Post by mkolek99 »

Hello friends,

Every two weeks I need to launch the browser on my phone and navigate to my local HDHR device to see the device auth for the HDHR EPG API:
http://10.0.0.12/discover.json

I then go into the Tivimate settings, EPG, and update the device auth within the HDHR URL.
The OTA channels in the Tivimate guide are then updated to include programming data for the next two weeks.

How do I automate this instead of the manual task every two weeks? I wish the device auth would just remain static for my account, or change like once a year.

themusj
Posts: 313
Joined: Wed Aug 30, 2017 5:44 pm
x 1

Re: XMLTV guide data

Post by themusj »

What am I doing wrong?

My output keeps going to C:\ProgramData\GaRyan2\epg123\output when I have directed it to go to my D drive in a folder called Output.

I have tried so many different syntax I've now turned for help.

Batch File

@echo off

"C:\Program Files (x86)\epg123\hdhr2mxf.exe" -o "D:\output\epg.xmltv" -update

Pause

garyan2
Posts: 66
Joined: Sun Aug 19, 2018 9:36 am
x 5
Contact:

Re: XMLTV guide data

Post by garyan2 »

The -o switch was deprecated and is no longer provided. This is because using the EPG123/HDHR2MXF installer installs a http proxy server as well. To get the hdhr2mxf.xmltv file you just need to point your application to http://<ip address>:9009/output/hdhr2mxf.xmltv.

Note the -update switch is also deprecated as really unnecessary.

You can modify the scheduled task to do what you are looking for by adding an additional task to copy/rename the file from c:\programdata\garyan2\epg123\output\hdhr2mxf.xmlt to d:\output\epg.xmltv.

EDIT: I should add, with the http proxy server there is no need to execute a scheduled creation of the xmltv file. It will be an on demand update so when you request over http to download the xmltv file it will create a new one if the existing one is more than 3 hours old.

Online
EddieP
Posts: 476
Joined: Sat Jun 08, 2019 11:04 am
x 1

Re: XMLTV guide data

Post by EddieP »

garyan2 wrote: Sun Jan 12, 2025 3:14 pm The -o switch was deprecated and is no longer provided. This is because using the EPG123/HDHR2MXF installer installs a http proxy server as well. To get the hdhr2mxf.xmltv file you just need to point your application to http://<ip address>:9009/output/hdhr2mxf.xmltv.

Note the -update switch is also deprecated as really unnecessary.

You can modify the scheduled task to do what you are looking for by adding an additional task to copy/rename the file from c:\programdata\garyan2\epg123\output\hdhr2mxf.xmlt to d:\output\epg.xmltv.

EDIT: I should add, with the http proxy server there is no need to execute a scheduled creation of the xmltv file. It will be an on demand update so when you request over http to download the xmltv file it will create a new one if the existing one is more than 3 hours old.
Everything is working as designed thanks.

Techtony
Posts: 2
Joined: Tue Mar 11, 2025 8:13 pm

Re: XMLTV guide data

Post by Techtony »

Purchased a refurbed flex 4k direct from SiliconDust
Purchased yearly EPG / XML access
Retrieved device auth code by going to discover page
appended auth code to this url: https://api.hdhomerun.com/api/xmltv?DeviceAuth=

Got 403 Forbidden

I visited via browser & attempted to use the url in my plex server under live tv and received error communicating with your provider.

Can someone help me figure out what i'm missing?

I'm on Win11 and not trying to automate the xml retrieval or anything. just get it loaded.

Thanks

nickk
Silicondust
Posts: 20485
Joined: Tue Jan 13, 2004 9:39 am
x 314

Re: XMLTV guide data

Post by nickk »

Techtony wrote: Tue Mar 11, 2025 8:28 pm Got 403 Forbidden
I can check... what is the Device ID of your HDHomeRun?

garyan2
Posts: 66
Joined: Sun Aug 19, 2018 9:36 am
x 5
Contact:

Re: XMLTV guide data

Post by garyan2 »

Techtony wrote: Tue Mar 11, 2025 8:28 pm Purchased a refurbed flex 4k direct from SiliconDust
Purchased yearly EPG / XML access
Retrieved device auth code by going to discover page
appended auth code to this url: https://api.hdhomerun.com/api/xmltv?DeviceAuth=

Got 403 Forbidden

I visited via browser & attempted to use the url in my plex server under live tv and received error communicating with your provider.

Can someone help me figure out what i'm missing?

I'm on Win11 and not trying to automate the xml retrieval or anything. just get it loaded.

Thanks
Make sure you url encode the auth string. There could be unallowed characters in the string.

nickk
Silicondust
Posts: 20485
Joined: Tue Jan 13, 2004 9:39 am
x 314

Re: XMLTV guide data

Post by nickk »

garyan2 wrote: Wed Mar 12, 2025 4:59 pm Make sure you url encode the auth string. There could be unallowed characters in the string.
The DeviceAuth is URL parameter safe - no special characters.

jasonl
Silicondust
Posts: 17308
Joined: Sun Oct 28, 2007 9:23 pm
x 75

Re: XMLTV guide data

Post by jasonl »

Make sure you've registered your HDHomeRun device with your account using the HDHomeRun app on a computer, phone, or tablet.


Highly recommend the HDHR2MXF program that garyan2 created. Basically just run the program and it finds your HDHomeRun gets the DeviceAuth and downloads the data and spits out an XMLTV file that you can point Plex at. Set up a scheduled task to run it once a day to download the latest data and that's all there is to it.

https://garyan2.github.io/hdhr2mxf.html ... lient=none
https://garyan2.github.io/download.html

Techtony
Posts: 2
Joined: Tue Mar 11, 2025 8:13 pm

Re: XMLTV guide data

Post by Techtony »

Thanks all

The directions i followed said to go to my.hdhomerun.com but the url is slightly different and device registration was my issue.

bitl3ss
Posts: 3
Joined: Sun Mar 16, 2025 8:29 am

Re: XMLTV guide data

Post by bitl3ss »

Hello,

Hoping someone can help me out. I am trying to pull down guide data but keep getting 403 forbidden.

I am on a linux server and have tried the following with and without quotes on my key and I get the same results each time.

curl --compressed https://api.hdhomerun.com/api/xmltv?DeviceAuth=mykey > tvlist.xml
wget https://api.hdhomerun.com/api/xmltv?DeviceAuth=mykey > tvlist.xml

Any help is greatly appreciated.

Thanks,
Dan

nickk
Silicondust
Posts: 20485
Joined: Tue Jan 13, 2004 9:39 am
x 314

Re: XMLTV guide data

Post by nickk »

bitl3ss wrote: Sun Mar 16, 2025 8:47 am Hoping someone can help me out. I am trying to pull down guide data but keep getting 403 forbidden.
I can check a few things - what is the Device ID of your HDHomeRun?

Post Reply