--- title: "Soccer Live" description: "Soccer Live is a Marketplace integration for Home Assistant. It has 124 installs sharing analytics, needs the vendor's cloud and was last updated October 26, 2026." canonical: "https://vulpo.app/integrations/marketplace/rononline-soccerlive" url: "https://vulpo.app/integrations/marketplace/rononline-soccerlive.md" last-updated: "2026-10-22" version: "1.4" --- # Soccer Live > Soccer Live is a Marketplace integration for Home Assistant. It has 124 installs sharing analytics, needs the vendor's cloud and was last updated October 26, 2026. 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](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=rononline&repository=soccerlive&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=rononline&repository=soccerlive&category=integration) ## 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. ## 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](https://github.com/rononline/soccerlive). ## Entities - **Binary sensors**: Match live, Match today, Match tomorrow, Lineup available, Data degraded - **Buttons**: Refresh now, Rebuild match archive, Play match replay - **Calendars**: Match calendar - **Events**: Match event - **Sensors**: Next 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 - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **Repair notices**: Notices 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 From the README of [rononline/soccerlive](https://github.com/rononline/soccerlive#readme), [GNU GPL v3.0](https://spdx.org/licenses/GPL-3.0.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Media and entertainment](https://vulpo.app/integrations/category/media-and-entertainment.md) - Number: 124 installs sharing analytics; 9 GitHub stars - Connection: Needs the vendor's cloud - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v3.23.18, last updated October 26, 2026 - Domain: `soccer_live` - Source: - Issues: In Vulpo: Button card, Calendar card, Chart card, Apple Watch Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-22. Source: https://vulpo.app/integrations/marketplace/rononline-soccerlive --- - HTML version of this page: https://vulpo.app/integrations/marketplace/rononline-soccerlive - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml