Skip to content

fix(soccer-scoreboard): correct TEAMS.md codes, explain why a league is empty #233

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ChuckBuilds merged 3 commits into from
Jul 31, 2026
+595 −75
Merged

fix(soccer-scoreboard): correct TEAMS.md codes, explain why a league is empty #233

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4d96dc2
fix(soccer-scoreboard): correct TEAMS.md codes, explain why a league …
claude Jul 30, 2026
831e8f2
Merge origin/main, sequencing the TEAMS.md fix after the UTC start-ti…
claude Jul 30, 2026
78630f0
Merge branch 'main' into fix/soccer-team-codes
ChuckBuilds Jul 31, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion plugins.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -735,7 +735,7 @@
"last_updated": "2026-07-31",
"verified": true,
"screenshot": "",
"latest_version": "2.4.1"
"latest_version": "2.5.0"
},
{
"id": "static-image",
Expand Down
25 changes: 25 additions & 0 deletions plugins/soccer-scoreboard/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Changelog

## [2.5.0] - 2026-07-29

### Fixed
- **TEAMS.md listed wrong team codes**: the documented abbreviations had drifted
from ESPN's, so following the docs produced a silently empty display. Manchester
United was listed as `MUN` (ESPN uses `MAN`), Manchester City as `MCI` (`MNC`),
Real Madrid as `RM` (`RMA`), and Ligue 1 had eight wrong codes including Lyon
and Marseille. Several rosters were also a season out of date. Every table is
now generated from ESPN's live team endpoints and verified against them.

### Added
- **A reason when a league shows nothing.** An empty screen had two very
different causes that looked identical in the logs. Now, once per league:
an unrecognised favorite team logs a warning naming the closest match
(`favorite team 'MUN' is not a Premier League team code. Closest match is
'MAN' (Manchester United).`), while codes that are correct but have no
fixtures yet log the date the season starts, stating that an empty display
until then is expected rather than a misconfiguration.
- **Cross-league code clashes documented.** Favourites match by abbreviation
across every enabled league, and `MUN` is Bayern Munich in the Bundesliga —
so the old docs could have matched the wrong club entirely. TEAMS.md now
lists the codes that mean different clubs in different leagues.

180 changes: 107 additions & 73 deletions plugins/soccer-scoreboard/TEAMS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,57 +9,81 @@ This file lists the team abbreviations used by the ESPN API for each supported l

Abbreviations are shown as uppercase 2–4 character codes. If you don't see your team listed or the abbreviation doesn't seem to work, check the plugin's debug logs — the plugin logs `home_abbr` and `away_abbr` for every game it processes.

The tables below are generated from ESPN's live team endpoints, so they are the
codes the plugin actually compares against. **They are not always the code you
would guess:** ESPN uses `MAN` for Manchester United (not `MUN`), `MNC` for
Manchester City (not `MCI`), `RMA` for Real Madrid (not `RM`), and `LYON` /
`OLM` for Lyon and Marseille (not `OL` / `OM`).

### Codes that mean different clubs in different leagues

@coderabbitai coderabbitai Bot Jul 30, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Use an H2 heading here.

### skips directly from the document title to H3, breaking heading hierarchy and generated navigation.

🧰 Tools
🪛 markdownlint-cli2 (0.23.1)

[warning] 18-18: Heading levels should only increment by one level at a time
Expected: h2; Actual: h3

(MD001, heading-increment)

🤖 Prompt for AI Agents 
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/soccer-scoreboard/TEAMS.md` at line 18, Update the heading in
TEAMS.md from H3 to H2 so it follows the document title and preserves heading
hierarchy and generated navigation.

Source: Linters/SAST tools


Favourites are matched by abbreviation across every league you have enabled, so
if two of your enabled leagues share a code you will match both. The one to
watch is `MUN`, which is **Bayern Munich** in the Bundesliga — not Manchester
United.
Comment on lines +20 to +23

@coderabbitai coderabbitai Bot Jul 30, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Clarify that favorites are configured per league.

Each manager receives favorite_teams from its own league config. A code only matches multiple leagues when it is configured under each of those leagues; merely enabling both leagues does not make an eng.1 favorite select a Bundesliga team.

🤖 Prompt for AI Agents 
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/soccer-scoreboard/TEAMS.md` around lines 20 - 23, Update the
favorites-matching explanation in TEAMS.md to state that each manager’s
favorite_teams comes from its own league configuration. Clarify that
abbreviation matching is scoped to configured favorites per league, so enabling
multiple leagues alone does not make an eng.1 favorite select a Bundesliga team;
duplicate codes match across leagues only when configured in each league.


| Code | Could be |
|------|----------|
| `MUN` | Bayern Munich (Bundesliga) — Manchester United is `MAN` |
| `BRE` | Brentford (Premier League) or Brest (Ligue 1) |
| `MON` | Monza (Serie A) or AS Monaco (Ligue 1) |
| `PAR` | Parma (Serie A) or Paris FC (Ligue 1) |
| `SCP` | SC Paderborn (Bundesliga) or Sporting CP (Liga Portugal) |
| `FCA` | FC Augsburg (Bundesliga) or Arouca (Liga Portugal) |
| `TOR` | Torino (Serie A) or Toronto FC (MLS) |

---

## Premier League (eng.1)

| Club | Abbreviation |
|------|-------------|
| AFC Bournemouth | BOU |
| Arsenal | ARS |
| Aston Villa | AVL |
| Bournemouth | BOU |
| Brentford | BRE |
| Brighton & Hove Albion | BHA |
| Chelsea | CHE |
| Coventry City | COV |
| Crystal Palace | CRY |
| Everton | EVE |
| Fulham | FUL |
| Hull City | HUL |
| Ipswich Town | IPS |
| Leicester City | LEI |
| Leeds United | LEE |
| Liverpool | LIV |
| Manchester City | MCI |
| Manchester United | MUN |
| Manchester City | MNC |
| Manchester United | MAN |
| Newcastle United | NEW |
| Nottingham Forest | NFO |
| Southampton | SOU |
| Sunderland | SUN |
| Tottenham Hotspur | TOT |
| West Ham United | WHU |
| Wolverhampton Wanderers | WOL |

---

## La Liga (esp.1)

| Club | Abbreviation |
|------|-------------|
| Athletic Club (Bilbao) | ATH |
| Atletico Madrid | ATM |
| Alavés | ALA |
| Athletic Club | ATH |
| Atlético Madrid | ATM |
| Barcelona | BAR |
| Celta Vigo | CEL |
| Deportivo La Coruña | DEP |
| Elche | ELC |
| Espanyol | ESP |
| Getafe | GET |
| Girona | GIR |
| Las Palmas | LPA |
| Leganes | LEG |
| Mallorca | MAL |
| Levante | LEV |
| Málaga | MCF |
| Osasuna | OSA |
| Racing Santander | RAC |
| Rayo Vallecano | RAY |
| Real Betis | BET |
| Real Madrid | RM |
| Real Madrid | RMA |
| Real Sociedad | RSO |
| Sevilla | SEV |
| Valencia | VAL |
| Valladolid | VLL |
| Villarreal | VIL |

---
Expand All @@ -68,24 +92,24 @@ Abbreviations are shown as uppercase 2–4 character codes. If you don't see you

| Club | Abbreviation |
|------|-------------|
| Augsburg | AUG |
| 1. FC Union Berlin | FCU |
| Bayer Leverkusen | B04 |
| Bayern Munich | BAY |
| Borussia Dortmund | BVB |
| Borussia Monchengladbach | BMG |
| Bayern Munich | MUN |
| Borussia Dortmund | DOR |
| Borussia Mönchengladbach | BMG |
| Eintracht Frankfurt | SGE |
| Freiburg | SCF |
| Heidenheim | HDH |
| Hoffenheim | TSG |
| Holstein Kiel | KIE |
| Mainz | MNZ |
| FC Augsburg | FCA |
| FC Cologne | KOE |
| Hamburg SV | HSV |
| Mainz | M05 |
| RB Leipzig | RBL |
| St. Pauli | STP |
| Stuttgart | VFB |
| Union Berlin | FCU |
| SC Freiburg | SCF |
| SC Paderborn 07 | SCP |
| Schalke 04 | S04 |
| SV Elversberg | ELV |
| TSG Hoffenheim | TSG |
| VfB Stuttgart | VFB |
| Werder Bremen | SVW |
| Wolfsburg | WOB |
| Bochum | BOC |

---

Expand All @@ -94,22 +118,22 @@ Abbreviations are shown as uppercase 2–4 character codes. If you don't see you
| Club | Abbreviation |
|------|-------------|
| AC Milan | MIL |
| AS Roma | ROM |
| AS Roma | ROMA |
| Atalanta | ATA |
| Bologna | BOL |
| Cagliari | CAG |
| Como | COM |
| Empoli | EMP |
| Como | COMO |
| Fiorentina | FIO |
| Frosinone | FRO |
| Genoa | GEN |
| Hellas Verona | VER |
| Inter Milan | INT |
| Internazionale | INT |
| Juventus | JUV |
| Lazio | LAZ |
| Lecce | LEC |
| Monza | MON |
| Napoli | NAP |
| Parma | PAR |
| Sassuolo | SAS |
| Torino | TOR |
| Udinese | UDI |
| Venezia | VEN |
Expand All @@ -120,59 +144,59 @@ Abbreviations are shown as uppercase 2–4 character codes. If you don't see you

| Club | Abbreviation |
|------|-------------|
| AJ Auxerre | AUX |
| Angers | ANG |
| Auxerre | AUX |
| AS Monaco | MON |
| Brest | BRE |
| Le Havre | HAV |
| Le Havre AC | HAC |
| Le Mans | MNS |
| Lens | RCL |
| Lille | LIL |
| Lyon | OL |
| Marseille | OM |
| Monaco | ASM |
| Montpellier | MHSC |
| Nantes | FCN |
| Nice | OGC |
| Lille | LILL |
| Lorient | LOR |
| Lyon | LYON |
| Marseille | OLM |
| Nice | NICE |
| Paris FC | PAR |
| Paris Saint-Germain | PSG |
| Reims | SDR |
| Rennes | SRFC |
| Saint-Etienne | ASSE |
| Strasbourg | RCSA |
| Toulouse | TFC |
| Stade Rennais | REN |
| Strasbourg | STR |
| Toulouse | TOU |
| Troyes | TRY |

---

## MLS (usa.1)

| Club | Abbreviation |
|------|-------------|
| Atlanta United | ATL |
| Atlanta United FC | ATL |
| Austin FC | ATX |
| CF Montréal | MTL |
| Charlotte FC | CLT |
| Chicago Fire | CHI |
| FC Cincinnati | CIN |
| Chicago Fire FC | CHI |
| Colorado Rapids | COL |
| Columbus Crew | CLB |
| D.C. United | DC |
| FC Cincinnati | CIN |
| FC Dallas | DAL |
| Houston Dynamo | HOU |
| Inter Miami | MIA |
| Houston Dynamo FC | HOU |
| Inter Miami CF | MIA |
| LA Galaxy | LA |
| Los Angeles FC | LAFC |
| Minnesota United | MIN |
| CF Montréal | MTL |
| LAFC | LAFC |
| Minnesota United FC | MIN |
| Nashville SC | NSH |
| New England Revolution | NE |
| New York City FC | NYC |
| New York Red Bulls | RBNY |
| Orlando City | ORL |
| Orlando City SC | ORL |
| Philadelphia Union | PHI |
| Portland Timbers | POR |
| Real Salt Lake | RSL |
| Red Bull New York | RBNY |
| San Diego FC | SD |
| San Jose Earthquakes | SJ |
| Seattle Sounders | SEA |
| Seattle Sounders FC | SEA |
| Sporting Kansas City | SKC |
| St. Louis City SC | STL |
| St. Louis CITY SC | STL |
| Toronto FC | TOR |
| Vancouver Whitecaps | VAN |

Expand All @@ -182,27 +206,30 @@ Abbreviations are shown as uppercase 2–4 character codes. If you don't see you

| Club | Abbreviation |
|------|-------------|
| Arouca | ARO |
| Académico de Viseu | AVF |
| Alverca | ALV |
| Arouca | FCA |
| Benfica | SLB |
| Boavista | BOA |
| Braga | SCB |
| Casa Pia | CPA |
| Estoril | EST |
| Famalicao | FAM |
| Farense | FAR |
| Gil Vicente | GIL |
| Moreirense | MOR |
| Nacional | NAC |
| Porto | FCP |
| Rio Ave | RAV |
| C.D. Nacional | CDN |
| Casa Pia | CPAC |
| Estoril | EPF |
| Estrela | EST |
| FC Famalicao | FCF |
| FC Porto | FCP |
| Gil Vicente | GVFC |
| Maritimo | MAR |
| Moreirense | MFC |
| Rio Ave | RAFC |
| Santa Clara | CDSC |
| Sporting CP | SCP |
| Vitoria SC (Guimaraes) | VIT |
| Vitória de Guimaraes | VSC |

---

## UEFA Champions League (uefa.champions)

Teams change each season. Use the club's abbreviation from its domestic league table above. For example, Real Madrid is `RM`, Liverpool is `LIV`.
Teams change each season. Use the club's abbreviation from its domestic league table above. For example, Real Madrid is `RMA`, Liverpool is `LIV`.

---

Expand Down Expand Up @@ -285,3 +312,10 @@ downloads its flag on demand from ESPN into the same `national/` directory.
- **Abbreviations are case-sensitive** — use uppercase as shown (e.g. `"LIV"` not `"liv"`)
- **Season rosters change** — promoted/relegated teams join or leave; if a team isn't listed here, check the debug logs for the abbreviation the API returns
- **Custom leagues** — for any ESPN-supported league not listed here (e.g., `mex.1`, `arg.1`), run the plugin with debug logging and look for `home_abbr`/`away_abbr` log lines to find the correct codes
- **Nothing showing up?** The plugin now tells you which it is at startup. An
unrecognised code logs a warning naming the closest match; a code that is
valid but has no fixtures yet logs the date the season starts. Check the logs
before assuming the code is wrong — between seasons an empty screen is normal
- **Re-checking a code yourself** — ESPN's team list for a league is at
`https://site.api.espn.com/apis/site/v2/sports/soccer/<league>/teams`, e.g.
`.../soccer/eng.1/teams`
Loading
Loading