EPG Update Failed - DeviceAuth expired

[trahajopro86]

I cannot seem to get this to download the EPG data.

Using Docker. It looks like it gets the info from my hdhomerun device, but gets "Got 403, DeviceAuth may be expired." when trying to pull the guide data. The following manual commands work from the Docker container console.

curl http://192.168.75.85/discover.json -o - (To get DeviceAuth Key)

{"FriendlyName":"HDHomeRun FLEX DUO","ModelNumber":"HDFX-2US","FirmwareName":"hdhomerun_dvr_atsc","FirmwareVersion":"20250815","DeviceID":"XXXXXX","DeviceAuth":"12345ABCDE","BaseURL":"http://192.168.75.85","LineupURL":"http://192.168.75.85/lineup.json","TunerCount":2,"StorageID":"XXXXXX","StorageURL":"http://192.168.75.85/recorded_files.json","TotalSpace":127972093952,"FreeSpace":127318532096}

curl https://api.hdhomerun.com/api/xmltv?DeviceAuth=12345ABCDE -o - (downloads the XML data successfully)

*Note: curl did not exist in the Docker container. I had to "apk add curl" to follow your troubleshooting steps (not sure if this matters).

Portainer env:

TZ=America/Chicago
HDHOMERUN_HOST=192.168.75.85
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
NODE_VERSION=20.19.5
YARN_VERSION=1.22.22
RUN_ON_START=true
ENABLE_DUMMY_PROGRAMMING=true
DUMMY_PROGRAM_TITLE=No Information
DUMMY_PROGRAM_DESC=No program information...
DAYS=7

========================================
HDHomeRun2XMLTV v2.0.0
========================================

Configuration:
  HDHomeRun Host: 192.168.75.85
  EPG Days: 7
  Update Schedule: 0 3 * * *
  Timezone: America/Chicago
  HTTP Port: 8083
  Output: ./output/epg.xml

EPG HTTP Server started on port 8083
Access EPG at: http://localhost:8083/epg.xml
Status page: http://localhost:8083/

========== Initial EPG Update ==========
========== EPG Update Started ==========
Time: 2025-11-01T11:38:15.483Z

[1/6] Initializing HDHomeRun client...
[2/6] Fetching DeviceAuth token...
Fetching DeviceAuth from http://192.168.75.85/discover.json
Starting cron scheduler: 0 3 * * *
Timezone: America/Chicago
Cron scheduler started successfully

========================================
Server is running
Press Ctrl+C to stop
========================================

DeviceAuth obtained successfully
[3/6] Fetching channel lineup...
Fetching lineup from http://192.168.75.85/lineup.json
Fetched 70 channels from lineup
Found 70 channels
[4/6] Fetching EPG data (7 days, 3 hour windows)...
Fetching initial EPG data...
Got 403, DeviceAuth may be expired. Refreshing...
Fetching DeviceAuth from http://192.168.75.85/discover.json
DeviceAuth obtained successfully

========== EPG Update Failed ==========
Duration: 0.31 seconds
Error: Error: DeviceAuth expired, please retry operation
    at HDHomeRunClient.fetchEPGChunk (/app/dist/api/hdhomerun-client.js:145:23)
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
    at async HDHomeRunClient.fetchEPGData (/app/dist/api/hdhomerun-client.js:92:27)
    at async EPGUpdater.update (/app/dist/scheduler/epg-updater.js:52:29)
Initial EPG update failed: Error: DeviceAuth expired, please retry operation
Server will continue running - EPG will update on schedule

[plerpsandplerps]

Running into same issue

[MikePaer]

I hit this issue too and was able to fix it on my end with a code update. I'm unable to publish a PR here with the fix, but you can find it at my fork here: fbde033

About the fix:

• Switched the HTTP request in fetchEPGChunk from POST to GET and updated the headers to simulate my web browser (since my web browser could fetch the guide info from that API no problem... whereas the request was being rejected in this app.
• Observed that after several EPG chunks were successfully fetched, eventually the API would reject requests with certain timestamps with HTTP 400. So, I added logic to treat 400 errors as "no more guide info available" and end the fetching operation rather than error out the whole thing.
  Seems to work on my end.

Not sure if this is the best approach, but it works for me.

@trahajopro86 and @plerpsandplerps, in the meantime until the fix lands in this repo, you can try updating your docker-compose to fetch my updated forked image here which contains my fix: ghcr.io/mikepaer/hdhomerun2xmltv:latest.

[deardsy]

@metaColin I'm having the same issue.

========== Scheduled EPG Update Triggered ==========

========== EPG Update Started ==========

Time: 2025-12-17T08:00:00.379Z

[1/6] Initializing HDHomeRun client...

[2/6] Fetching DeviceAuth token...

Fetching DeviceAuth from http://192.168.1.155/discover.json

DeviceAuth obtained successfully

[3/6] Fetching channel lineup...

Fetching lineup from http://192.168.1.155/lineup.json

Fetched 44 channels from lineup

Found 44 channels

[4/6] Fetching EPG data (14 days, 3 hour windows)...

Fetching initial EPG data...

Got 403, DeviceAuth may be expired. Refreshing...

Fetching DeviceAuth from http://192.168.1.155/discover.json

DeviceAuth obtained successfully

========== EPG Update Failed ==========

Duration: 0.39 seconds

Error: Error: DeviceAuth expired, please retry operation

    at HDHomeRunClient.fetchEPGChunk (/app/dist/api/hdhomerun-client.js:145:23)

    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)

    at async HDHomeRunClient.fetchEPGData (/app/dist/api/hdhomerun-client.js:92:27)

    at async EPGUpdater.update (/app/dist/scheduler/epg-updater.js:52:29)

    at async task.cron.schedule.timezone [as _execution] (/app/dist/scheduler/cron-scheduler.js:62:28)

Scheduled update failed: Error: DeviceAuth expired, please retry operation

Served EPG successfully

[MikePaer]

@deardsy try using my fixed fork described above at: ghcr.io/mikepaer/hdhomerun2xmltv:latest

[deardsy]

@MikePaer i have been using your fork since my previous post and its been working well. Thanks!