About
Soccer Live is an integration that brings football match data into Home Assistant from ESPN or API-Football. ESPN needs no API key, while API-Football is optional and uses a key the user supplies, which also adds predictions, odds and injuries. It can follow a team, a league or news, and creates sensors for the next match, standings, top scorers, knockout bracket, live commentary and a match calendar. Binary sensors show whether a match is live, today or tomorrow, and buttons refresh data, rebuild the match archive or play a replay. Device triggers cover goals, lineups, kick-off, half-time, red cards, full-time, postponements and cancellations, so automations can start without templates. Options cover scan and live refresh intervals, date range, and shared card appearance, and repair notices flag authentication or rate limit problems.
Automatic summary of the README and code of rononline/soccerlive. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Uses the vendor's cloud Needs an internet connection and an account with the vendor.
Device triggers Its devices can start automations directly.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Sensors
- Calendars
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Soccer Live setup
- Data source
API-Football credentials
- API-Football API key
- Season (0 = current year)
- Include friendlies
What do you want to follow?
- What do you want to monitor?
News competition
- Competition
Also asked when at the select the league step and at the team — select league step.
API-Football team selection
- Team selection method
Re-enter API-Football key
- API-Football API key
After setup
- Scan interval (minutes)
- Live refresh interval (seconds)
- Start date (YYYY-MM-DD)
- End date (YYYY-MM-DD)
- Keep finished match visible for (hours)
- Fetch lineup, key events and H2H (summary enrichment)
- Combine matching fixtures from other Soccer Live entries
- External archive JSON URL (optional)
- External archive sync interval (hours)
- Shared card appearance (dark/light/HA)
- Shared card palette
- Shared compact mode for cards
- Shared card language
- Fetch club profile, coach, squad and transfers (API-Football)
- Fetch live in-play odds during a match (API-Football; polls often)
Texts from the code of rononline/soccerlive.
Entities
- Binary sensorsMatch live, Match today, Match tomorrow, Lineup available, Data degraded
- ButtonsRefresh now, Rebuild match archive, Play match replay
- CalendarsMatch calendar
- EventsMatch event
- SensorsNext match, All matches, All competitions, Standings, Top scorers, Knockout bracket, All matches today, News, Live commentary, Sync status, Setup status, Next kick-off, and 1 more
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
- Repair noticesNotices it can show in Settings, Repairs:Soccer Live authentication failed, Soccer Live is being rate limited, Soccer Live season needs attention
From the README
Real-time football data in Home Assistant via ESPN, with optional API-Football support for users who provide their own API key.
Built on ideas from Calcio Live by @Bobsilvio
Shows in Vulpo
Button card, Calendar card, Chart card, Apple Watch.Information
- Installs
- 124 sharing analytics
- GitHub stars
- 9
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- v3.23.18,
- Category
- Media and entertainment
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
soccer_live- Issues
- Report an issue
