Table of Contents

HDHomeRun DVR XMLTV API access

Go back to all DVR topics

This is a mirror of the documentation from: https://github.com/Silicondust/documentation/wiki/XMLTV-Guide-Data

14 day XMLTV guide data is available for HDHomeRun customers to use with third party apps. At least one HDHomeRun tuner and a paid HDHomeRun DVR guide subscription is required to use this API.

API URL

GET 

https://api.hdhomerun.com/api/xmltv

API Parameters

Parameter Type Description
DeviceAuth string Concatenation of the DeviceAuth strings from all HDHomeRun tuners.

OR

Parameter Type Description
Email string Email address associated with the DVR account
DeviceIDs string Comma-separated list of DeviceIDs

Additional requirements

  • The HDHomeRun device(s) must be associated with a paid HDHomeRun DVR account to access XMLTV guide data.
  • The HTTP client must accept gzip encoding.
  • The DeviceAuth changes regularly and is valid for 16-24 hours. If using the DeviceAuth access approach the DeviceAuth must be read from the HDHomeRun tuner(s) to get the latest value each time this API is invoked.
  • Do not schedule the download for midnight or a fixed time each day - requests should be made at a random interval. For example, after downloading the xmltv guide, schedule the next download for 20 to 28 hours (randomized delay) in the future.

Example

curl --compressed "https://api.hdhomerun.com/api/xmltv?DeviceAuth=xxx" > guide.xml
curl --compressed "https://api.hdhomerun.com/api/xmltv?Email=xxx&DeviceIDs=xxx,xxx,xxx" > guide.xml

History

  • 20251026:
    • URL must be quoted in most shells.
  • 20251025:
    • New Email+DeviceIDs access approach.
    • Clarifications.
  • 20251023:
    • Add note regarding scheduling the download.
  • 20250928:
    • Initial documentation.

Copyright © 2016-2025 Silicondust USA Inc. <www.silicondust.com>.