Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
dvr:xmltv [2026/02/14 08:27] – nedsdvr:xmltv [2026/10/01 21:50] (current) – [Additional requirements] neds
Line 6: Line 6:
 </WRAP> </WRAP>
  
-<lead>If you have a [[:DVR:activation|Full Guide subscription]] you can use the 14-day HDHomeRun guide data via an XMLTV file.</lead>+<lead>XMLTV guide data is available for HDHomeRun customers to use with third party apps.</lead>
  
-===== API ===== +  * No account is required for access to 3 days of 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 [[:DVR:activation|HDHomeRun DVR guide subscription]] is required to use this API.+ 
 +  * A paid [[:DVR:activation|HDHomeRun DVR guide subscription]] is required to access 14 days of guide data.
  
 ====API URL==== ====API URL====
Line 16: Line 17:
 GET<code>https://api.hdhomerun.com/api/xmltv</code> GET<code>https://api.hdhomerun.com/api/xmltv</code>
  
 +</WRAP>
 ====API Parameters==== ====API Parameters====
 <WRAP indent> <WRAP indent>
  
 ^ Parameter ^ Type ^ Description ^ ^ Parameter ^ Type ^ Description ^
-| DeviceAuth | string | Concatenation of the DeviceAuth strings from all HDHomeRun tuners. |+| DeviceAuth | string | Concatenation of the DeviceAuth strings from all HDHomeRun tuners. This can be found from http://hdhomerun.local/discover.json and changes every 8 hours. |
  
 OR OR
Line 32: Line 34:
 <WRAP indent> <WRAP indent>
  
-  * 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 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.   * 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.
Line 40: Line 41:
 ==== Example ==== ==== Example ====
 <WRAP indent> <WRAP indent>
- 
-<code>curl --compressed "https://api.hdhomerun.com/api/xmltv?DeviceAuth=xxx" > guide.xml</code> 
  
 <code>curl --compressed "https://api.hdhomerun.com/api/xmltv?Email=xxx&DeviceIDs=xxx,xxx,xxx" > guide.xml</code> <code>curl --compressed "https://api.hdhomerun.com/api/xmltv?Email=xxx&DeviceIDs=xxx,xxx,xxx" > guide.xml</code>
  
-</WRAP>+<code>curl --compressed "https://api.hdhomerun.com/api/xmltv?DeviceAuth=xxx" > guide.xml</code>
  
 </WRAP> </WRAP>
  
 +====History====
 +<WRAP indent>
 +  * 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>.
 +
 +</WRAP>
  
 {{tag>DVR}} {{tag>DVR}}
 {{tag>development}} {{tag>development}}
  • Last modified: 2026/02/14 08:27