Show HN: Courtside – TUI for NBA Games

Hacker News Top Tools
terminal-ui nba sports open-source go command-line tui

Summary

Courtside is a terminal UI for following NBA games, box scores, and standings, pulling data from public NBA endpoints and offering keyboard-driven navigation.

Hi HN, I made this after seeing a few similar projects on the front page. NBA API endpoints are public and there’s a pretty robust python package ( <a href="https:&#x2F;&#x2F;github.com&#x2F;swar&#x2F;nba_api" rel="nofollow">https:&#x2F;&#x2F;github.com&#x2F;swar&#x2F;nba_api</a> ) that I referenced for the endpoint structure to build an sdk in go. used BubbleTea and LipGloss for styling. It was a bit tricky to test the live endpoints but I watched Friday’s Final game with this and it worked pretty well<p>playball - <a href="https:&#x2F;&#x2F;news.ycombinator.com&#x2F;item?id=45451577">https:&#x2F;&#x2F;news.ycombinator.com&#x2F;item?id=45451577</a><p>faceoff - <a href="https:&#x2F;&#x2F;news.ycombinator.com&#x2F;item?id=47826104">https:&#x2F;&#x2F;news.ycombinator.com&#x2F;item?id=47826104</a>
Original Article
View Cached Full Text

Cached at: 06/08/26, 09:19 PM

NolanFogarty/courtside

Source: https://github.com/NolanFogarty/courtside

Courtside

A terminal UI for following NBA games, box scores, and standings.

Browse the day’s games, drill into a live or finished game for its full box score and play-by-play, jump to any date to see past results, and check the league standings. Games in progress refresh on their own while you watch.

Data

Courtside pulls directly from the NBA’s public JSON endpoints via nba-sdk:

  • cdn.nba.com — the live “today” scoreboard
  • stats.nba.com — scoreboard by date, traditional box scores, play-by-play, and league standings

These are unofficial, undocumented endpoints, so there’s no API key or account required but they can change or rate-limit without notice. Live games auto-refresh roughly every 15 seconds.

Installation

Install from source

git clone https://github.com/NolanFogarty/courtside.git
cd courtside
go build -o courtside
sudo mv courtside /usr/local/bin/

Install with go install

go install github.com/NolanFogarty/courtside@latest

Usage

courtside

The app opens on today’s games. Everything is keyboard-driven:

Game list

KeyAction
↑/k, ↓/jMove between games
enterOpen the selected game’s details
←/h, →/lPrevious / next day
dJump to a specific date
sLeague standings
/Filter games
qQuit

Game details

KeyAction
↑/k, ↓/jScroll the play-by-play feed
oToggle expanded stats
q/escBack to the game list

Standings

KeyAction
q/escBack to the game list

Screenshots

Game List

Game list view

Game Details

Detailed game view

Standings

Standings view

Similar Articles

Show HN: An 8-bit live gamecast for baseball

Hacker News Top

A website that converts live MLB data into near real-time 8-bit pixel art broadcasts of baseball games, with stadium details, day/night modes, and interstitials.