ftbl

A football/soccer CLI tool written in Rust, powered by the football-data.org API.

Installation

git clone https://github.com/sakihet/ftbl
cd ftbl
cargo build --release

Setup

Get a free API key from football-data.org and set it as an environment variable:

export FOOTBALL_DATA_API_KEY=your_api_key_here

Usage

ftbl <COMMAND>

Commands

Command	Description
competitions	List available competitions
standings <competition>	Show league standings
matches <competition>	List matches for a competition
today	List today's matches across all competitions
teams <competition>	List teams in a competition
squad <team_id>	Show squad for a team
scorers <competition>	Show top scorers
player <player_id>	Show player profile
player-matches <player_id>	Show matches for a player

Examples

# List all available competitions
ftbl competitions

# Show Premier League standings
ftbl standings PL

# List Champions League matches
ftbl matches CL

# Today's matches
ftbl today

# List Premier League teams
ftbl teams PL

# Show Netherlands national team squad (team ID: 8601)
ftbl squad 8601

# Show top scorers in the Bundesliga
ftbl scorers BL1

# Show player profile (player ID: 44)
ftbl player 44

# Show matches for a player
ftbl player-matches 44

Competition codes

Code	Competition
PL	Premier League (England)
CL	UEFA Champions League
BL1	Bundesliga (Germany)
SA	Serie A (Italy)
PD	Primera Division (Spain)
FL1	Ligue 1 (France)
DED	Eredivisie (Netherlands)
PPL	Primeira Liga (Portugal)
EC	European Championship
WC	FIFA World Cup

Run ftbl competitions for the full list.

Development

cargo build    # build
cargo run -- standings PL  # run
cargo test     # run tests
cargo clippy   # lint
cargo fmt      # format