[Bug]: Sports don't have episode/show-type information and get parsed as movies by Plex

[jrmclaugh]

What happened?

Looking at the raw listings pulled I can see that there is episode information for TV shows, but none for sports (checked NHL and NBA). The plex-based listing sources handled this properly, but had its own separate issues (hence the switch to zap2xml).

The web listing on tvtv for each seem to display a little differently, although the URL for both has an "EPnnnnnnnnnnnn" type format, indicating SOME info should be available (vs the movie format of "MVnnnnnnnnnnnn").

Relevant log output

Examples of a TV show and an NHL game on the same channel, as shown in the xmltv:

  <programme start="20260326013000 +0000" stop="20260326020200 +0000" channel="45874">
    <title>Abbott Elementary</title>
    <sub-title>No Homework</sub-title>
    <desc>Ava implements a no-homework policy at Abbott, sparking debate amongst the teachers.</desc>
    <rating system="MPAA"><value>TV-14</value></rating>
    <new />
    <audio type="stereo" />
    <subtitles type="teletext" />
    <episode-num system="onscreen">S05E17</episode-num>
    <episode-num system="common">S05E17</episode-num>
    <episode-num system="dd_progid">EP038712170091</episode-num>
    <episode-num system="xmltv_ns">5 . 17.</episode-num>
    <icon src="https://zap2it.tmsimg.com/assets/p20001974_b_v13_ap.jpg" />
  </programme>

  <programme start="20260322000000 +0000" stop="20260322030000 +0000" channel="45874">
    <title>NHL Hockey</title>
    <sub-title>Boston Bruins at Detroit Red Wings</sub-title>
    <desc>From Little Caesars Arena in Detroit, Mich.</desc>
    <new />
    <live />
    <audio type="stereo" />
    <subtitles type="teletext" />
    <icon src="https://zap2it.tmsimg.com/assets/GNLZZGG002YWKZB.jpg" />
  </programme>

Equivalent listings on tvtv:
https://tvtv.us/co/denver/80204/luUSA-OTA80204/search/show/EP038712170090
https://tvtv.us/co/denver/80204/luUSA-OTA80204/search/show/EP051892152655

[jrmclaugh]

Separately trying to debug by printing the URLs to compare against the source seems to show that my lineupID reverts to default for some reason. Similarly, timezone seems to be ignored (even when I specify it).

Print of "url" was added here: https://github.com/jef/zap2xml/blob/main/src/tvlistings.ts#L118 (it's possible I just don't understand the code enough and those get set later).

--lineupID=USA-OTA80204
--timezone=America/Denver

Actual URLs:
https://tvlistings.gracenote.com/api/grid?lineupId=USA-lineupId-DEFAULT&timespan=6&headendId=lineupId&country=USA&timezone=America%2FNew_York&postalCode=80204&isOverride=true&pref=16%2C128&aid=orbebb&languagecode=en-us&time=1773416028&device=X&userId=-!

[jrmclaugh]

Manually forming the URL's to see what info is available for similar entries (not the exact same one's, but similar showings): https://imgur.com/a/2y5uYcI

[jrmclaugh]

Experimenting with other providers seems to show Plex just expects an episode-num in a particular format, e.g.:
EP05189215.2763

Where the first 10 of the program.id (EP05189215) is the series ID and the last 4 of the program.id are the "episode" number.