Golazo

<div align="center"> <img src="assets/golazo-logo.png" alt="Golazo demo" width="150"> <h1>Golazo</h1> </div> <div align="center">

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.

</div>

[!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!

<div align="center"> <img src="assets/golazo-demo-v0.18.0.gif" alt="Golazo demo" width="800"> </div> <div align="center">

Quick Install: brew install 0xjuanma/tap/golazo · Other options

</div>

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

# Install
brew install 0xjuanma/tap/golazo

# Update
brew upgrade 0xjuanma/tap/golazo

Install script

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/0xjuanma/golazo/main/scripts/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/0xjuanma/golazo/main/scripts/install.ps1 | iex

Build from source

git clone https://github.com/0xjuanma/golazo.git
cd golazo
go build 
./golazo

Usage

Run the application:

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: Full list of available leagues and competitions, customize your preferences in the Settings menu.
• Notifications: Desktop notification setup and configuration

---

<div align="center">

Built with Bubble Tea, Lip Gloss & Bubbles by Charm

Author: @0xjuanma

</div>