Sports Ticker
Track your favorite teams across multiple sports with FREE live alerts!
Supports: ⚽ Soccer • 🏈 NFL • 🏀 NBA • 🏒 NHL • ⚾ MLB • 🏎 F1
First Run (Onboarding)
When no
config.json
exists, running the setup script launches an interactive wizard:
python3 scripts/setup.py
The wizard asks:
- 📺 Which sports? — Pick from Soccer, NFL, NBA, NHL, MLB, F1
- 🏆 Which teams? — Choose from popular teams or search for any team
- 🔔 Alert style? — Live scores, final only, or daily digest
- ⏰ Game-day reminders? — Get a heads-up 30 mins before kick-off
- 🌙 Quiet hours? — Pause alerts while you sleep
After setup, your
config.json
is ready and you can start tracking!
Re-run setup anytime:
python3 scripts/setup.py --force # Overwrites existing config
Quick Start
# First time? Just run setup!
python3 scripts/setup.py # Interactive wizard
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
{
"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
# 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
📅 Schedule - View upcoming fixtures (NEW in v3!)
python3 scripts/schedule.py # All teams, next 14 days
python3 scripts/schedule.py --days 30 # Look further ahead
python3 scripts/schedule.py --team spurs # Specific team
python3 scripts/schedule.py --compact # One-liner format
python3 scripts/schedule.py --json # JSON output
🤖 Auto Setup Crons - Generate match-day crons (NEW in v3!)
python3 scripts/auto_setup_crons.py # All teams, next 7 days
python3 scripts/auto_setup_crons.py --team spurs --days 14
python3 scripts/auto_setup_crons.py --json # Machine-readable
python3 scripts/auto_setup_crons.py --commands # OpenClaw CLI commands
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
