Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dylantientcheu/nbacli

🏀 The NBA in your terminal
https://github.com/dylantientcheu/nbacli

basketball cli console nba nba-schedule terminal tui

Last synced: 2 months ago
JSON representation

🏀 The NBA in your terminal

Awesome Lists containing this project

README

        


`nbacli` is an UNOFFICIAL command line interface for NBA games.





## ⚡ī¸ Features

🏀 Get the latest scores for NBA games

📊 Get the stats for a specific games

⛹ī¸ Much more is yet to come - stay tuned!

## ⚙ī¸ Installation

### Binaries

Binaries are available for Linux, macOS, and Windows. You can download the latest version from the [releases page](https://github.com/dylantientcheu/nbacli/releases).

### From source

```bash
git clone https://github.com/dylantientcheu/nbacli.git && cd nbacli

# insall
go install

# run
nbacli games
```

> **Note**
> When building from source, make sure that `$GOPATH/bin` is in your `PATH` environment variable

### Homebrew

```bash
brew tap dylantientcheu/dylantientcheu && brew install nbacli

# run
nbacli games
```

## 📖 Usage

### Get the latest scores

```bash
nbacli games
```

Navigate through the games using the ↑ arrow keys ↓ and press Enter to get the stats for a specific game.

```bash
# Get the stats for the day before
nbacli games --yesterday
# or the day after
nbacli games --tomorrow
# or a specific date
nbacli games --date YYYYMMDD
```

### Get the conference standings

```bash
nbacli standings
```

Highlight rows ↑ ↓ and press Tab to switch tabs.

![Alt text](screenshots/standings.png)

## ⌨ī¸ Under the hood

* Data is fetched from [stats.nba.com](https://stats.nba.com) using a [custom version](./nag/) of [nag](https://github.com/ronaudinho/nag)
* The CLI is built using [Cobra](https://github.com/spf13/cobra)
* TUI is sweetened with [Bubble Tea](https://github.com/charmbracelet/bubbletea) & [Lipgloss](https://github.com/charmbracelet/lipgloss)
* Logo is made from [Gopher Pack](https://www.sketchappsources.com/free-source/4864-gophers-pack-sketch-freebie-resource.html) with Figma.
* Screenshots are beautifully shot with [VHS](https://github.com/charmbracelet/vhs) 📸
* [Warp](https://www.warp.dev/) with dark theme is used on the Terminal

## 📝 License

Refer to [LICENSE.md](./LICENSE).