Skip to content

[uk-sport-on-tv] Add UK Sport on TV - #546

Merged
sethwv merged 3 commits into
Dispatcharr:mainfrom
petebutty:uk-sport-on-tv
Nov 12, 2026
Merged

sethwv merged 3 commits into
Dispatcharr:mainfrom
petebutty:uk-sport-on-tv

Conversation

@petebutty

Copy link
Copy Markdown
Contributor

New external plugin: UK Sport on TV (0.1.0).

What it does: it keeps a list of which UK channel shows each televised football match, weeks ahead: Sky Sports, TNT Sports, Premier Sports, BBC, ITV, Amazon Prime Video, DAZN and others. Your EPG usually only reaches about a week ahead, so this lets a client say where a match is on before the guide lists it.

  • Source: one page from live-footballontv.com, whose robots.txt allows all agents.
    • Fetched at most every 6 hours, after an EPG refresh (the epg_refresh event), or by hand with the Refresh action.
    • The request identifies itself with a User-Agent that links to the repo.
  • Storage: the next 30 days of matches (configurable) go into the plugin's own PluginConfig.settings as compact JSON. Nothing else in Dispatcharr is touched: no channels, EPG sources or other plugins.
  • Safety: if the page can't be fetched or its layout isn't recognised, the previous listings are kept.
  • Requirements: no API key or account. Standard library only.
  • Actions:
    • Refresh listings now
    • Show status (the next few matches)
    • After EPG Refresh (automatic)

Repo: https://github.com/petebutty/uk-sport-on-tv
Release: https://github.com/petebutty/uk-sport-on-tv/releases/tag/v0.1.0

Tested on Dispatcharr: it found 769 televised matches over 30 days, and the event hook and status output work. The first client is Viewarr, an Android TV player for Dispatcharr, which shows the channels on its sports game cards.

🤖 Generated with Claude Code

https://claude.ai/code/session_01P5s3VtNas9Rf4cf5pKEWGX

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01P5s3VtNas9Rf4cf5pKEWGX
@dispatcharr-plugins-bot dispatcharr-plugins-bot Bot added the New Plugin A new plugin being contributed to the repository. label Nov 12, 2026
@dispatcharr-plugins-bot

This comment has been minimized.

@dispatcharr-plugins-bot dispatcharr-plugins-bot Bot added the Manual Review Required Security findings, suppressions, or new plugins require maintainer review label Nov 12, 2026
@petebutty

Copy link
Copy Markdown
Contributor Author

Updated to 0.2.0:

  • Guide entries: each match is added to the guide of the channel showing it, at the match's time. It only fills gaps: the provider's programmes are never changed or overlapped. The added entries are marked in custom_properties and re-added after every EPG refresh. There's a Remove added matches action and an on/off setting.
  • Polite fetching:
    • If-Modified-Since requests, so the source answers 304 with an empty body when nothing has changed.
    • Backs off on 429/503, honouring Retry-After and waiting at least an hour.
    • The manual Refresh runs at most every 10 minutes.

Release: https://github.com/petebutty/uk-sport-on-tv/releases/tag/v0.2.0

@dispatcharr-plugins-bot

This comment has been minimized.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01P5s3VtNas9Rf4cf5pKEWGX
@petebutty

Copy link
Copy Markdown
Contributor Author

Updated to 0.3.0: club channels.

  • Which games, which channel: league games that aren't on UK TV go on the home club's channel, if the user's lineup has it. Recognised channels are those named SPFL - <club> TV, SERIE A - <club> TV and so on, plus MUTV and LFC TV.
  • Premier League games are skipped, because club channels can't show them live.
  • Fixtures come from ESPN's public API, a request or two per club every 6 hours.
  • Club channels with no guide get an EPG entry from the plugin's own xmltv source. It has no URL, so Dispatcharr never fetches it, and only the plugin writes to it.

Release: https://github.com/petebutty/uk-sport-on-tv/releases/tag/v0.3.0

@dispatcharr-plugins-bot

Copy link
Copy Markdown
Contributor

Plugin Validation Results

Modified plugins: 1

Plugin: uk-sport-on-tv

Which channel shows each UK football match, weeks ahead: UK TV (Sky Sports, TNT Sports, Premier Sports, BBC, ITV…, from live-footballontv.com), and club channels (Celtic TV, Hearts TV…) for the home club's games UK TV doesn't show. Added to those channels' guides at each match's time (gaps only) and kept for players such as Viewarr. Polite, cached fetching.

Source Repository

Check Status Details
Required fields ✅ All required fields present
Release artifact ✅ Artifact reachable at resolved URL
Maintainers ✅ petebutty
License ✅ MIT - MIT License
Permission ✅ New plugin - petebutty listed in author/maintainers
Version ✅ 0.3.0
Version bump ✅ New plugin

View release v0.3.0 on GitHub


🎉 All validation checks passed!

This PR modifies 1 plugin(s) and all checks have passed.

@sethwv
sethwv merged commit b7fef30 into Dispatcharr:main Nov 12, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Manual Review Required Security findings, suppressions, or new plugins require maintainer review New Plugin A new plugin being contributed to the repository.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants