mirror of
https://github.com/ChuckBuilds/LEDMatrix.git
synced 2026-04-10 21:03:01 +00:00
98d3ed7d91
* 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
108 lines
3.3 KiB
Markdown
108 lines
3.3 KiB
Markdown
# 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
|