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