Soccer Logo Checker and Downloader

Overview

The check_soccer_logos.py script automatically checks for missing logos of major teams from supported soccer leagues and downloads them from ESPN API if missing.

Supported Leagues

Premier League (eng.1) - 20 teams
La Liga (esp.1) - 15 teams
Bundesliga (ger.1) - 15 teams
Serie A (ita.1) - 14 teams
Ligue 1 (fra.1) - 12 teams
Liga Portugal (por.1) - 15 teams
Champions League (uefa.champions) - 13 major teams
Europa League (uefa.europa) - 11 major teams
MLS (usa.1) - 25 teams

Total: 140 major teams across 9 leagues

Usage

cd test
python check_soccer_logos.py

What It Does

Checks Existing Logos: Scans assets/sports/soccer_logos/ for existing logo files
Identifies Missing Logos: Compares against the list of major teams
Downloads from ESPN: Automatically fetches missing logos from ESPN API
Creates Placeholders: If download fails, creates colored placeholder logos
Provides Summary: Shows detailed statistics of the process

Output

The script provides detailed logging showing:

✅ Existing logos found
⬇️ Successfully downloaded logos
❌ Failed downloads (with placeholders created)
📊 Summary statistics

Example Output

🔍 Checking por.1 (Liga Portugal)
📊 Found 2 existing logos, 13 missing
✅ Existing: BEN, POR
❌ Missing: ARO (Arouca), BRA (SC Braga), CHA (Chaves), ...

Downloading ARO (Arouca) from por.1
✅ Successfully downloaded ARO (Arouca)
...

📈 SUMMARY
✅ Existing logos: 25
⬇️ Downloaded: 115  
❌ Failed downloads: 0
📊 Total teams checked: 140

Logo Storage

All logos are stored in: assets/sports/soccer_logos/

Format: {TEAM_ABBREVIATION}.png (e.g., BEN.png, POR.png, LIV.png)

Integration with LEDMatrix

These logos are automatically used by the soccer manager when displaying:

Live games
Recent games
Upcoming games
Odds ticker
Leaderboards

The system will automatically download missing logos on-demand during normal operation, but this script ensures all major teams have logos available upfront.

Notes

Real Logos: Downloaded from ESPN's official API
Placeholders: Created for teams not found in ESPN data
Caching: Logos are cached locally to avoid repeated downloads
Format: All logos converted to RGBA PNG format for LEDMatrix compatibility
Size: Logos are optimized for LED matrix display (typically 36x36 pixels)

Troubleshooting

If downloads fail:

Check internet connectivity
Verify ESPN API is accessible
Some teams may not be in current league rosters
Placeholder logos will be created as fallback

The script is designed to be robust and will always provide some form of logo for every team.

2.8 KiB Raw Blame History