If you get this you are probably being blocked by HDHomeRun. Little I can do other than suggest you only run this app a little as you can get away with and at differing times of day. (See Other Recommendations at the end of this page for an alternative to this app)
#5 - Many thanks to [@supitsmike] for fixing the bug where all episodes were showing as "New".
#7 - Add the to help with NEXTPVR intepretting a new show correctly.
#13 - Manys thanks to [@AcSlayter] for adding docker support.
#14 - Many thanks to [@Sujeom] for fixing the status handling bug.
#10 - The re-vamp in v2 has re-arranged all XMLTV elements to match the DTD more closely.
#11 - The re-vamp in v2 has allowed me to attempt the location timezone detection properly.
#12 - The re-vamp in v2 corrects the formatting of the XMLTV so it no longer is on a single line.
A Python program to download the current EPG from an HDHomeRun Quattro box for the next 7 days and convert this into an XMLTV formatted file. This should work with some other HDHomeRun models and you may possibly be able to get 14 days of EPG data, but I have only tested with the Quattro.
I developed this so I could easily update the EPG on a Jellyfin media server that was linked to an HDHomeRun Quattro. The HDHomeRun Quattro hardware automatically maintains the EPG for the channels it has tuned in, so it made sense to use this.
Version 2 Notes: This is a re-vamp of the original v1 code to fix a number of bugs, but primarily to produce a more professional piece of code now that I have more experience with Python.
NOTE 1: The Binaries I have generated are purely for those that are not comfortable running the Python application. All of the binaries run on my local hardware and virtual machines, but if you have any problems please send me a message and I will try my best to help out.
python HDHomeRunEPG_To_XmlTv.py [--help] [--host <HOST>] [--filename <FILENAME>] [--days <DAYS>] [--hours <HOURS>] [--debug <DEBUG>]
| Parameter | Description |
|---|---|
--help |
Show the command parameters available. |
--host <HOST> |
The host name or IP address of the HDHomeRun server if different from "hdhomerun.local". |
--filename <FILENAME> |
The file path and name of the EPG to be generated. Defaults to epg.xml in the current directory. |
--days <DAYS> |
The number of days in the future from now to obtain an EPG for. Defaults to 7 but will be restricted to the maximum number of days the HDHomeRun device will return. |
--hours <HOURS> |
The number of hours of guide interation to obtain. Defaults to 3 hours. This is an adavanced option which basically tells the app how many hours to increment for each query to the HDHomeRun device. Making this too large will mean gaps can appear int he guide, equally making it too small will make the app run longer. Note any duplicate programmes retrieved are ignored anyway. |
--debug <DEBUG> |
Switch debug log message on, options are "on", "full" or "off". Defaults to "on". This is usefuly to see the detail of all the programmes being retrieved, but will mak the app take longer to run. |
To run the Python application as described in the Usage section above, you will need the following elements set up:
Install Python 3.9 or above onto your platform if it is not already available and ensure you can execute the following from you terminal/command/Powershell window:
python --version
If this return the Python version you have it installed correctly.
With Python installed you should have the PIP utility to install Python packages. If not check instructions for your platform.
pip --version
OR
pip3 --version
Requirements are listed in the requirements.txt file. These can be installed using the following command:
pip -r requirements.txt
Simply run the HDHomeRunEPG_To_XmlTv app on your platform, e.g.
python HDHomeRunEPG_to_XmlTv.py --host 192.168.68.102
Please find a binaries directory in the repository root that contains a PyInstaller built distibution that can be run independently on the platform it is built for. Extract the relevant binary platform zip files onto your machine and run according to the instructions below:
To run the Debian Linux binary from a terminal window, put yourself in the binaries directory and run the following command with any parameters (as described above), e.g:
.\HDHomeRunEPG_To_XmlTv --host 192.168.1.100
If this fails and you need to make the HDHomeRunEPG_To_XmlTv runnable, type in the followwing before running it again:
chmod 755 HDHomeRunEPG_To_XmlTv
To run the Mac OS binary from a terminal window, put yourself in the binaries directory and run the following command with any parameters (as described above), e.g:
.\HDHomeRunEPG_To_XmlTv --host 192.168.1.100
If this fails and you need to make the HDHomeRunEPG_To_XmlTv runnable, type in the followwing before running it again:
chmod 755 HDHomeRunEPG_To_XmlTv
To run the Windows binary from a terminal window, put yourself in the binaries directory and run the following command with any parameters (as described above), e.g:
.\HDHomeRunEPG_To_XmlTv --host 192.168.1.100
You can run this project using Docker. Here are the steps:
-
Update the HDHomeRun host: Edit the
HOSTenvironment variable in yourdocker-compose.ymlfile or set it directly in your Docker command. Example:environment: - HOST=192.168.1.100
Or set it in your run command:
docker run --rm -e HOST=192.168.1.100 hdhomerun-epg
-
Build the Docker image:
docker compose build
-
Start the container:
docker compose up
-
Cron schedule: The script is scheduled to run every day at 1am using cron inside the container:
0 1 * * *
This will automatically update the EPG file as specified by the
FILENAMEenvironment variable.
A kind individual @thekoma has developed an API service that fetches and caches EPG from HDHomeRun devices the serves the data as an XMLTV output.