https://github.com/0xjuanma/golazo
The beautiful game in your terminal. Minimal TUI app to keep up with live football/soccer written in Go.
https://github.com/0xjuanma/golazo
bubbletea charmbracelet cli football football-data go golang interactive soccer sports terminal tui
Last synced: 4 months ago
JSON representation
The beautiful game in your terminal. Minimal TUI app to keep up with live football/soccer written in Go.
- Host: GitHub
- URL: https://github.com/0xjuanma/golazo
- Owner: 0xjuanma
- License: mit
- Created: 2025-12-12T17:52:29.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-24T16:37:52.000Z (5 months ago)
- Last Synced: 2026-01-25T05:51:28.012Z (5 months ago)
- Topics: bubbletea, charmbracelet, cli, football, football-data, go, golang, interactive, soccer, sports, terminal, tui
- Language: Go
- Homepage:
- Size: 7.06 MB
- Stars: 184
- Watchers: 3
- Forks: 11
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Support: docs/SUPPORTED_LEAGUES.md
Awesome Lists containing this project
- fucking-awesome-cli-apps - golazo - Soccer matches. (Entertainment)
- awesome-tuis - golazo - by-minute updates and finished match stats in your terminal (Table of Contents)
- awesome-cli-apps - golazo - Soccer matches. (Entertainment)
README
Golazo
[](https://opensource.org/licenses/MIT)
[](https://goreportcard.com/report/github.com/0xjuanma/golazo)
[](https://github.com/0xjuanma/golazo/releases/latest)
[](https://github.com/0xjuanma/golazo/actions/workflows/build.yml)
A minimalist terminal user interface (TUI) for following football(i.e, soccer) matches in real-time. Get live match updates, finished match statistics, and minute-by-minute events directly in your terminal.
Golazo was created for those moments when you can't stream or watch matches live. It gives you a handy, non-intrusive, and minimalist way to keep up with your favourite football leagues.
> [!NOTE]
> If you enjoy Golazo, give it a star and share it with your friends. That helps others find it and keeps the project going!
## Features
- **Live Match Tracking**: Timeline & Real-time updates for goals, cards, and substitutions with automatic polling
- **Match Statistics**: Detailed stats including possession, shots, and passes
- **Official Highlights & Replay Links**: Clickable links for official highlights and instant goal replays
- **Goal Notifications**: Desktop notifications for goals as they happen
- **Finished Matches**: View results from today, last 3 days, or last 5 days
- **50+ Leagues**: Support for major leagues across Europe, Americas, Asia, and more. Select your favorite leagues in Settings
## Installation & Update
> [!IMPORTANT]
> As of v0.6.0, you can update golazo to the latest version by running:
> ```bash
> golazo --update
> ```
> The command automatically detects whether you installed via Homebrew or the install script.
### Homebrew
```bash
# Install
brew install 0xjuanma/tap/golazo
# Update
brew upgrade 0xjuanma/tap/golazo
```
### Install script
**macOS / Linux:**
```bash
curl -fsSL https://raw.githubusercontent.com/0xjuanma/golazo/main/scripts/install.sh | bash
```
**Windows (PowerShell):**
```powershell
irm https://raw.githubusercontent.com/0xjuanma/golazo/main/scripts/install.ps1 | iex
```
### Build from source
```bash
git clone https://github.com/0xjuanma/golazo.git
cd golazo
go build
./golazo
```
## Usage
Run the application:
```bash
golazo
```
**Navigation:** `↑`/`↓` or `j`/`k` to move, `Enter` to select, `/` to filter, `Esc` to go back, `q` to quit.
## Docs
- [Supported Leagues](docs/SUPPORTED_LEAGUES.md): Full list of available leagues and competitions, customize your preferences in the **Settings** menu.
- [Notifications](docs/NOTIFICATIONS.md): Desktop notification setup and configuration
---
Powered by [Cobra](https://github.com/spf13/cobra) & the glamorous [Charmbracelet](https://github.com/charmbracelet).
**Author:** [@0xjuanma](https://github.com/0xjuanma)