⚠️ This project is currently under active development and considered experimental (all 0.1.x releases).

League Dashboard (lgdash)

Soccer/football at the command line. ⚽

Under the hood the app is calling the football-data.org API, so an API token from that service is required. Register here to get one.

Features

• live scores
• league standings
• league schedules

Currently Supported Leagues

• Premier League (England 🏴󠁧󠁢󠁥󠁮󠁧󠁿)
• La Liga (Spain 🇪🇸)
• Serie A (Italy 🇮🇹)
• Bundesliga (Germany 🇩🇪)
• Ligue 1 (France 🇫🇷)
• UEFA Champions League (Europe)

Quick Start

Get API Token

If you don't have one, register for an API token here.

Then add this line with your token to .zshrc or another appropriate startup file.

export FOOTBALLDATA_API_TOKEN=<token>

Install

Available on PyPI.

pip install lgdash

How to Use

Today's Slate of Matches

Live scores and start times in local system time.

Example: Premier League (Default)
lgdash, or lgdash -l PL

Example: Serie A
lgdash -l SA

Standings

Current state of a league's standings with some statistics for each team.

Example: Premier League (Default)
lgdash standings

Example: Serie A
lgdash standings -l SA

Help

Each command and subcommand supports the --help option, for example:

lgdash --help and lgdash --help

Commands

lgdash

• get live scores and today's scheduled matches
• -l, --league: specify a league code

lgdash schedule

• get upcoming matches
• -l, --league: specify a league code
• -d, --days: specify number of days in future

lgdash standings

• get league standings
• -l, --league: specify a league code

lgdash leagues

• get all supported league codes