Plugins
Ranked Matchups (Top Games)
Version: 1.36.0 |
Author: Jacob-Lasky | Last Updated: Oct 16 2026, 14:29 UTC |
Never miss a good game. Scores every upcoming game across 39 leagues, tours and competitions (22 of them soccer, plus NFL, NBA, MLB, NHL, NCAA D1 football and basketball, UFC, boxing, tennis, golf and motorsport), then builds a Top Matchups group holding only the ones worth watching and shows why each game ranked where it did in its EPG description. Finished games can clear themselves out and be replaced from a bench of the next-best fixtures.
Downloads
Latest Release
- Download:
dispatcharr-ranked-matchups-latest.zip - Built: Oct 16 2026, 14:29 UTC
- Source Commit:
aaac7b4
Checksums:
MD5: 10f714d203c969838e1e0b4fa5fae8bd
SHA256: 4d3aa5843174a8cc708d8b3846af52e3f1c1dda968af71138ad21ee6e3f0a61a
All Versions
| Version | Download | Built | Commit | MD5 | SHA256 |
|---|---|---|---|---|---|
1.36.0 |
Download | Oct 16 2026, 14:29 UTC | aaac7b4 |
10f714d203c969838e1e0b4fa5fae8bd | 4d3aa5843174a8cc708d8b3846af52e3f1c1dda968af71138ad21ee6e3f0a61a |
1.35.0 |
Download | Oct 15 2026, 17:09 UTC | cd25137 |
b3614d3934c2ecadc09bf756a349659e | f1d1d5980fcdeff90c93834c1b7e8ff2c71808a2f3aae30346041568ead92deb |
1.34.0 |
Download | Oct 12 2026, 14:11 UTC | 2540667 |
2cac55e1733c8d1b3fab8e242db345a2 | 2779703405fddba3e0f7edd2b49213900da2e20634c6140ec081a90d33169c61 |
1.33.2 |
Download | Oct 11 2026, 13:50 UTC | 6b10ecd |
8b048f48d9393ac96f82b286aa3d5d86 | c25b1bef40ce17a86bac9e372b1c1e7cdee46e5e82b06938c436fb4be55dd05f |
1.33.1 |
Download | Oct 11 2026, 03:09 UTC | f2f8177 |
64ee9cfeb3abf712c8097da3d6d8569f | 3e244317f44b627c28d36ca520a226280c3ac6950c589ad46c9ca28878b133ba |
1.33.0 |
Download | Oct 10 2026, 19:38 UTC | d5c31f0 |
5bc57f6587c45a572c5b5ad0cdfd788d | 8b757f3e4c10d55034248062296552bb7a290bbf28f724c60eec7f206b3ad2f7 |
1.32.0 |
Download | Oct 10 2026, 16:01 UTC | 9283c81 |
d39c392d4ce595ce8cb9fa8f753ff60b | ca270268b60d9acda4be32d0be21ee3a2ebe7403025c5c7ce88e25bc3b39d14f |
1.31.0 |
Download | Sep 27 2026, 02:40 UTC | f74211b |
fe611737e47fa661ea2dd7ddeb9e7866 | 145e69a12c8a143659a89251d1a6d6b2ba6ae317b64cf627d60f0d4ac8055361 |
1.30.1 |
Download | Sep 27 2026, 02:00 UTC | a724fe9 |
53c53386af54ade9341ac06913ca3c8a | c7800ea15be50666181f06870941a6f8d2cfe7add7a5752dae09dc837ce03687 |
1.29.0 |
Download | Sep 26 2026, 22:23 UTC | f8580d2 |
876c7451dfbaf40e3b541eb635c47731 | a10f6a436de43bd9619fe4667f14102677c527901421b9eeaf4f63fee272fa25 |
Source: Browse Plugin
Metadata: View full manifest
Plugin README
Ranked Matchups (Top Games)
A cross-sport “interestingness” curator for Dispatcharr. It pulls upcoming games for each sport you enable, scores every matchup on how interesting it is (rankings, standings, rivalries, betting lines, playoff/knockout stakes), matches the worthwhile games against your lineup, and renames + groups them into a dedicated !Top Matchups channel group. Your guide ends up showing the games worth watching instead of the full firehose.
What it does
- Per-sport adapters (college football/basketball, NFL, NBA, MLB, NHL, WNBA, NWSL, MLS, top-flight soccer leagues, internationals/friendlies, World Cup, and more), each toggleable.
- Scores matchups with a transparent model (see
SCORING.mdin the source repo): ranked-vs-ranked, standings importance, rivalries, and betting-line signal where available. - Matches scored games against your lineup and builds a curated !Top Matchups channel group with clean, renamed entries.
- Runs on demand from the plugin UI or on a schedule.
How games are matched
Three independent paths, all of which can contribute (results merge and stack as fallback streams):
- EPG programme title, sub-title or description inside the game’s window.
- Channel name, for providers that name the fixture on the channel.
- Stream name, whether or not that stream is attached to a channel. This is what lets a large M3U produce per-match feeds without curating them into channels first, and it is why a matchup channel can pick up feeds you never added yourself.
Because that third path sweeps your whole M3U, three settings decide what
happens to feeds you did not curate, and none of them removes a stream unless
you say so: Preferred languages (an ordered list like en or de, en),
Demote stream groups (used only as a last resort, still playable), and
Exclude stream groups (never attached at all). Streams you have attached to
a channel of your own always sort ahead of ones found only by the sweep.
Requirements
- Most sources need a free API key (e.g. CollegeFootballData / CollegeBasketballData, Football-Data.org, The Odds API). Each sport’s setting documents which key it needs; sports you do not enable need no key.
- Off-season sports simply produce no rows.
Source, docs, and issues
Full source, scoring methodology, changelog, and issue tracker live in the upstream repository:
https://github.com/Jacob-Lasky/dispatcharr_ranked_matchups
License
MIT