https://github.com/joypauls/league-dashboard
A command line tool for displaying live soccer scores and statistics
https://github.com/joypauls/league-dashboard
analytics cli python scores soccer statistics
Last synced: 5 months ago
JSON representation
A command line tool for displaying live soccer scores and statistics
- Host: GitHub
- URL: https://github.com/joypauls/league-dashboard
- Owner: joypauls
- License: mit
- Created: 2024-12-08T05:36:26.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-27T17:14:02.000Z (over 1 year ago)
- Last Synced: 2025-04-11T02:54:50.562Z (about 1 year ago)
- Topics: analytics, cli, python, scores, soccer, statistics
- Language: Python
- Homepage:
- Size: 124 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://www.python.org)
[](https://badge.fury.io/py/lgdash)
# League Dashboard (lgdash)
Soccer/football at the command line. ⚽
Under the hood the app is calling the [football-data.org](https://www.football-data.org/) API, so an API token from that service is required. Register [here](https://www.football-data.org/pricing) 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](https://www.football-data.org/pricing).
Then add this line with your token to `.zshrc` or another appropriate startup file.
```
export FOOTBALLDATA_API_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
- `-t, --team`: specify a team name
- `-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