Skip to content

Football

Displays Football statistics about the specific league. This widget uses football-data.org.

Standings

Standings is the ranking or table for specific league. By default it shows top 5 teams in the league but which can be customized using configuration.

Matches Played

Shows recent matches played in the specific league. By default it shows matches played in last 5 days.

Upcoming Matches

Shows upcoming matches or fixtuers in the specific league. By default it shows upcoming matches for next 5 days.

Supported Leagues

Currently this widget only support below mentioned league/competition, You should use below shortname of the league in your configuration:

Competition Short Name
Brazil Série A BSA
Campeonato Brasileiro da Série A EL2
English Championship EC
English Premier League PL
European Championship EUC
FIFA World Cup WC
French Ligue 1 FL1
German Bundesliga GB
Italy Serie A ISA
Netherlands Eredivisie NE
Portugal Primeira Liga PPL
Spain Primera Division SPD
UEFA Champions League CL

Configuration

football:
  enabled: true
  apiKey: "*************"
  league: "PL"
  favTeam: "Liverpool FC"
  standingCount: 5
  matchesFrom: 5
  matchesTo: 5
  position:
    top: 1
    left: 0
    height: 4
    width: 3
  refreshInterval: 1000
  title: "⚽"

Screenshots

football screenshot

Attributes

Name Value
apiKey
API key to get the football stats from football-data.org. You can get your Free tier key on football-data.org. Leave it empty to use the WTF_FOOTBALL_API_KEY environment variable.
league
Short name of the league or competition (as listed above in Supported Leagues).
favTeam
Optional Name of the favorite team from specific league. Leave it empty to use the WTF_FOOTBALL_TEAM environment variable.
matchesFrom
Optional List all matches played in last (N) number of days. Default 5.
Any positive integer.
matchesTo
Optional List all upcoming matches coming in next (N) number of days. Default 5 .
Any positive integer.
standingCount
Optional List top number (N) of teams in the league. Default 5.
Any positive integer.

Source Code

https://github.com/wtfutil/wtf/tree/master/modules/football