_         _ 
 ___ ___ ___| |_ ___ _| |
|_ -|  _|  _| . |  _| . |
|___|___|_| |___|_| |___|

a tui sports tracker for real-time scores and status.

written in rust with ratatui.

install | bmac

^{_{screenshot also features cbonsai by john allbritten.}}

About

scrbrd is a fast, minimal, cli application for tracking live sports events in your terminal. it fetches data from espn's unofficial api and renders the information using ratatui for a visually clean interface.

scrbrd parses and presents details such as current scores, inning/quarter/period, team records, schedules, and live status — all within a compact, readable tui format.

Features

• live score display with real-time game data
• league and team filtering
• game status: period, inning, record
• auto-refresh and manual refresh support
• clean, minimal terminal interface

Built with

• rust
• ratatui
• crossterm
• serde
• tokio

Installation

scrbrd requires rust with cargo to run.

using crates.io

cargo install scrbrd

from source

cargo install --git https://github.com/chuckswung/scrbrd

Usage

Commands

# show league scores
scrbrd -l <league>

# filter by team
scrbrd -l <league> -t <team>

# supported leagues 
mlb, nba, wnba, nfl, nhl, mls, nwsl, prem

# supported teams
all of them! you can filter by team name (guardians) or city abbreviation (cle)

Controls

Key	Action
↓	scroll down
↑	scroll up
r	force refresh
q	quit

Upcoming

• add nicknames
• enhance current display (add outs, downs, yardage, etc)
• add game day data (win %, weather, venue)
• add advanced statistics (box score, up to bat)

Contributing

contributions are more than welcome! i'm still a rookie dev and would love to collaborate with other developers.

to contribute:

1. fork the repo
2. create a new branch (git checkout -b feature-name)
3. commit your changes (git commit -m 'add new feature')
4. push to the branch (git push origin feature-name)
5. open a pr! :D

bug reports, feature ideas, and feedback are appreciated via issues or discussions.

License

this project is licensed under the MIT license. see the LICENSE file for details.

Author

Chuck Swung - @chuckswung

discord: chuckswung | email: chuckswung@gmail.com