Skip to content

0xjuanma/golazo

Repository files navigation

Golazo demo

Golazo

GitHub Stars License: MIT Go Report Card GitHub Release Build Status

GitHub Downloads macOS Linux Windows

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!

Golazo demo

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

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

Built with Bubble Tea, Lip Gloss & Bubbles by Charm

Author: @0xjuanma

About

The beautiful game in your terminal. Minimal TUI app to keep up with live & recent football/soccer matches written in Go.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors

Languages