Docker recipe for a proxy to api.hdhomerun.com with the ability to override the lineup.
The old HDHR3-US DUAL device stores its channel lineup on the hdhomerun servers at:
http://api.hdhomerun.com/api/lineup?DeviceAuth={DEVICE_AUTH}
(Note: it used to be ipv4-api.hdhomerun.com)
The lineup is created and uploaded when using the Windows application. If you're no longer using the Windows application, you can't refresh the file on the hdhomerun.com servers, which can leave your channel list old and outdated.
This is consequential if you're using Emby (or possibly other DVR software like Plex or JellyFin) which will only load the outdated lineup fine.
Instead, if you run this on the same server as your DVR software (and configure it as shown below) then you can load an updateable lineup instead.
There are at least two steps:
- Run the docker image.
- Modify
/etc/hoststo load lineup from docker
Most basically, you can start the container like this:
docker run -d -e HDHR_IP_ADDR=${IP_ADDR_TO_HDHR_DEVICE} --name hdhr-lineup-proxy pearmaster/hdhr-lineup-proxyOn startup, it will connect to your HDHomerun Device and scan for channels, saving the channel list and providing it over HTTP.
The next step is to convince your computer (the one running DVR software) that it needs to load the lineup from docker instead of the hdhomerun.com servers.
You need to determine the IP address of the container. This command will show it to you:
docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' hdhr-lineup-proxyThe result should be something like: 172.17.0.3
You need to modify the /etc/hosts file on the system that is trying to obtain the lineup information from the server.
Add this line, where the provided IP address it the IP address of your docker container:
172.17.0.3 api.hdhomerun.com
172.17.0.3 ipv4-api.hdhomerun.com # May be needed if your HDHR3 firmware is old.
On 2023+ firmware, they've put the lineup on https which thwarts the mechanisms so far. But by inserting an IpTables rule, we can redirect attempts to get the discover.json file from the docker image instead of the device:
export PROXY_IP_ADDR=$(docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' hdhr-lineup-proxy)
sudo iptables -t nat -I OUTPUT -p tcp ! --source ${PROXY_IP_ADDR} --dest ${IP_ADDR_TO_HDHR_DEVICE} --dport 80 -j DNAT --to-destination ${PROXY_IP_ADDR}:80Your HDHR client, like Emby, will get 172.17.0.3 as the IP address for ipv4-api.hdhomerun.com instead of the actual public IP address. Emby will then ask the docker image for the lineup.json file, and will receive any modifications you've made to the file.
It is a little bit like a man-in-the-middle hack.
Apache License.