Golazo
[](https://github.com/0xjuanma/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)
[](https://github.com/0xjuanma/golazo/releases)
A minimalist terminal user interface (TUI) for following football (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.
*Perfect for developers and terminal enthusiasts who want match updates without leaving their workflow.*
> [!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!
**Quick Install:** `brew install 0xjuanma/tap/golazo` · [Other options](#installation--update)
## Features
- **Live Match Tracking**: Timeline & Real-time updates for goals, cards, and substitutions with automatic polling
- **Match Statistics & Details**: Possession, shots, passes, standings, formations with player ratings, and more in focused dialogs
- **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**: Organized by region (Europe, Americas, Global) with tab navigation in Settings
## Installation & Update
**Self-update:** Run `golazo --update` anytime to get the latest version.
### 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, `Tab` to focus view, `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
---
**Built with** [Bubble Tea](https://github.com/charmbracelet/bubbletea), [Lip Gloss](https://github.com/charmbracelet/lipgloss) & [Bubbles](https://github.com/charmbracelet/bubbles) by [Charm](https://charm.sh)
Author: [@0xjuanma](https://github.com/0xjuanma)