scrbrd
| Crates.io | scrbrd |
| lib.rs | scrbrd |
| version | 0.2.0 |
| created_at | 2025-06-10 21:28:01.262486+00 |
| updated_at | 2025-06-12 23:54:25.946377+00 |
| description | a tui sports tracker for real-time scores and status |
| homepage | https://github.com/chuckswung/scrbrd |
| repository | https://github.com/chuckswung/scrbrd |
| max_upload_size | |
| id | 1707780 |
| size | 79,898 |
Chuck Swung (chuckswung)
documentation
README
_ _
___ ___ ___| |_ ___ _| |
|_ -| _| _| . | _| . |
|___|___|_| |___|_| |___|
a tui sports tracker for real-time scores and status.
written in rust with ratatui.
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
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:
- fork the repo
- create a new branch (
git checkout -b feature-name) - commit your changes (
git commit -m 'add new feature') - push to the branch (
git push origin feature-name) - 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