mirror of
https://github.com/ChuckBuilds/LEDMatrix.git
synced 2026-04-12 13:42:59 +00:00
added more missing soccer logos
This commit is contained in:
96
test/README_soccer_logos.md
Normal file
96
test/README_soccer_logos.md
Normal file
@@ -0,0 +1,96 @@
|
||||
# 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
|
||||
|
||||
```bash
|
||||
cd test
|
||||
python check_soccer_logos.py
|
||||
```
|
||||
|
||||
## What It Does
|
||||
|
||||
1. **Checks Existing Logos**: Scans `assets/sports/soccer_logos/` for existing logo files
|
||||
2. **Identifies Missing Logos**: Compares against the list of major teams
|
||||
3. **Downloads from ESPN**: Automatically fetches missing logos from ESPN API
|
||||
4. **Creates Placeholders**: If download fails, creates colored placeholder logos
|
||||
5. **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:
|
||||
1. Check internet connectivity
|
||||
2. Verify ESPN API is accessible
|
||||
3. Some teams may not be in current league rosters
|
||||
4. 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.
|
||||
Reference in New Issue
Block a user