sports-ticker

# Sports Ticker Track your favorite teams across **multiple sports** with **FREE live alerts**! Supports: ⚽ Soccer • 🏈 NFL • 🏀 NBA • 🏒 NHL • ⚾ MLB • 🏎️ F1 ## Quick Start ```bash # Setup cp config.example.json config.json python3 scripts/setup.py # Interactive setup # Find team IDs (any sport) python3 scripts/setup.py find "Lakers" basketball python3 scripts/setup.py find "Chiefs" football python3 scripts/setup.py find "Barcelona" soccer # Test python3 scripts/ticker.py ``` ## Config Example ```json { "teams": [ { "name": "Barcelona", "emoji": "🔵🔴", "sport": "soccer", "espn_id": "83", "espn_leagues": ["esp.1", "uefa.champions"] }, { "name": "Lakers", "emoji": "🏀💜💛", "sport": "basketball", "espn_id": "13", "espn_leagues": ["nba"] } ] } ``` ## Commands ```bash # Ticker for all teams python3 scripts/ticker.py # Live monitor (for cron) python3 scripts/live_monitor.py # League scoreboard python3 scripts/ticker.py league nba basketball python3 scripts/ticker.py league nfl football python3 scripts/ticker.py league eng.1 soccer # ESPN direct python3 scripts/espn.py leagues python3 scripts/espn.py scoreboard nba basketball python3 scripts/espn.py search "Chiefs" football ``` ## Alert Types - 🏟️ Game start (kick-off / tip-off) - ⚽🏈🏀⚾ Scoring plays (goals, touchdowns, 3-pointers, home runs) - 🟥 Red cards / Ejections - ⏸️ Halftime / Period breaks - 🏁 Final results (WIN/LOSS/DRAW) ## ESPN API (Free!) No key needed. Covers all major sports and 50+ leagues worldwide. **Supported Sports:** - Soccer: Premier League, La Liga, Champions League, MLS, and 30+ more - Football: NFL - Basketball: NBA, WNBA, NCAA - Hockey: NHL - Baseball: MLB - Racing: Formula 1