mirror of
https://github.com/ChuckBuilds/LEDMatrix.git
synced 2026-04-10 13:02:59 +00:00
Fix NBA leaderboard team ID field for logo fetching (#116)
* Fix NBA leaderboard team ID field for logo fetching - Add missing 'id' field to NBA team standings data structure - Enables proper logo fetching from assets/sports/nba_logos/ - Fixes 'id' KeyError when creating NBA leaderboard images - Includes diagnostic and test scripts for verification * Add NBA logo downloader script and documentation - download_nba_logos.py: Script to download all 30 NBA team logos from ESPN API - README_NBA_LOGOS.md: Comprehensive documentation for the logo downloader - Supports force re-download and quiet modes - Downloads to assets/sports/nba_logos/ for leaderboard integration * replace NBA Logos * return NBA logo
This commit is contained in:
107
scripts/README_NBA_LOGOS.md
Normal file
107
scripts/README_NBA_LOGOS.md
Normal file
@@ -0,0 +1,107 @@
|
||||
# NBA Logo Downloader
|
||||
|
||||
This script downloads all NBA team logos from the ESPN API and saves them in the `assets/sports/nba_logos/` directory for use with the NBA leaderboard.
|
||||
|
||||
## Usage
|
||||
|
||||
### Basic Usage
|
||||
```bash
|
||||
python download_nba_logos.py
|
||||
```
|
||||
|
||||
### Force Re-download
|
||||
If you want to re-download all logos (even if they already exist):
|
||||
```bash
|
||||
python download_nba_logos.py --force
|
||||
```
|
||||
|
||||
### Quiet Mode
|
||||
Reduce logging output:
|
||||
```bash
|
||||
python download_nba_logos.py --quiet
|
||||
```
|
||||
|
||||
### Combined Options
|
||||
```bash
|
||||
python download_nba_logos.py --force --quiet
|
||||
```
|
||||
|
||||
## What It Does
|
||||
|
||||
1. **Fetches NBA Team Data**: Gets the complete list of NBA teams from ESPN API
|
||||
2. **Downloads Logos**: Downloads each team's logo from ESPN's servers
|
||||
3. **Saves Locally**: Saves logos as `{team_abbr}.png` in `assets/sports/nba_logos/`
|
||||
4. **Skips Existing**: By default, skips teams that already have logos
|
||||
5. **Rate Limiting**: Includes small delays between downloads to be respectful to the API
|
||||
|
||||
## Expected Output
|
||||
|
||||
```
|
||||
🏀 Starting NBA logo download...
|
||||
Target directory: assets/sports/nba_logos/
|
||||
Force download: False
|
||||
✅ NBA logo download complete!
|
||||
📊 Summary: 30 downloaded, 0 failed
|
||||
🎉 NBA logos are now ready for use in the leaderboard!
|
||||
```
|
||||
|
||||
## File Structure
|
||||
|
||||
After running the script, you'll have:
|
||||
```
|
||||
assets/sports/nba_logos/
|
||||
├── ATL.png # Atlanta Hawks
|
||||
├── BOS.png # Boston Celtics
|
||||
├── BKN.png # Brooklyn Nets
|
||||
├── CHA.png # Charlotte Hornets
|
||||
├── CHI.png # Chicago Bulls
|
||||
├── CLE.png # Cleveland Cavaliers
|
||||
├── DAL.png # Dallas Mavericks
|
||||
├── DEN.png # Denver Nuggets
|
||||
├── DET.png # Detroit Pistons
|
||||
├── GSW.png # Golden State Warriors
|
||||
├── HOU.png # Houston Rockets
|
||||
├── IND.png # Indiana Pacers
|
||||
├── LAC.png # LA Clippers
|
||||
├── LAL.png # Los Angeles Lakers
|
||||
├── MEM.png # Memphis Grizzlies
|
||||
├── MIA.png # Miami Heat
|
||||
├── MIL.png # Milwaukee Bucks
|
||||
├── MIN.png # Minnesota Timberwolves
|
||||
├── NOP.png # New Orleans Pelicans
|
||||
├── NYK.png # New York Knicks
|
||||
├── OKC.png # Oklahoma City Thunder
|
||||
├── ORL.png # Orlando Magic
|
||||
├── PHI.png # Philadelphia 76ers
|
||||
├── PHX.png # Phoenix Suns
|
||||
├── POR.png # Portland Trail Blazers
|
||||
├── SAC.png # Sacramento Kings
|
||||
├── SAS.png # San Antonio Spurs
|
||||
├── TOR.png # Toronto Raptors
|
||||
├── UTA.png # Utah Jazz
|
||||
└── WAS.png # Washington Wizards
|
||||
```
|
||||
|
||||
## Integration with NBA Leaderboard
|
||||
|
||||
Once the logos are downloaded, the NBA leaderboard will:
|
||||
- ✅ Use local logos instantly (no download delays)
|
||||
- ✅ Display team logos in the scrolling leaderboard
|
||||
- ✅ Show proper team branding for all 30 NBA teams
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### "Import error: No module named 'requests'"
|
||||
Make sure you're running this from the LEDMatrix project directory where all dependencies are installed.
|
||||
|
||||
### "Permission denied" errors
|
||||
Make sure the script has write permissions to the `assets/sports/nba_logos/` directory.
|
||||
|
||||
### Some logos fail to download
|
||||
This is normal - some teams might have temporary API issues or the ESPN API might be rate-limiting. The script will continue with the successful downloads.
|
||||
|
||||
## Requirements
|
||||
|
||||
- Python 3.7+
|
||||
- `requests` library (should be installed with the project)
|
||||
- Write access to `assets/sports/nba_logos/` directory
|
||||
Reference in New Issue
Block a user