README
¶
Golazo
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, Goal Notifications & Replay Links: Desktop notifications & clickable links for goal replays and official highlights
- 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:
golazo --updateThe command automatically detects whether you installed via Homebrew or the install script.
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
Supported Leagues
Many leagues and competitions across Europe, South America, North America, Middle East, and more. View full list
Customize your leagues and competitions preferences in the Settings menu.
Notification Setup
Goal notifications require one-time setup depending on your operating system.
macOS
Notifications use AppleScript, which requires enabling notifications for Script Editor:
- Open Script Editor (
/Applications/Utilities/Script Editor.app) - Paste and run:
display notification "test" with title "test" - Open System Settings → Notifications → Script Editor
- Enable/Allow notifications and set alert style to "Banners"
Linux
Notifications require libnotify. Install if not present:
# Debian/Ubuntu
sudo apt install libnotify-bin
# Fedora
sudo dnf install libnotify
# Arch
sudo pacman -S libnotify
Windows
Notifications should work out-of-box on Windows 10/11.
Powered by Cobra & the glamorous Charmbracelet.
Author: @0xjuanma
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
internal
|
|
|
app
Package app implements the main application model and view navigation logic.
|
Package app implements the main application model and view navigation logic. |
|
assets
Package assets provides embedded static assets for the golazo application.
|
Package assets provides embedded static assets for the golazo application. |
|
data
Package data provides utilities for loading mock football match data.
|
Package data provides utilities for loading mock football match data. |
|
debug
Package debug provides utilities for debugging and inspecting API data.
|
Package debug provides utilities for debugging and inspecting API data. |
|
fotmob
Package fotmob provides a client for the FotMob API.
|
Package fotmob provides a client for the FotMob API. |
|
notify
Package notify provides desktop notification functionality for match events.
|
Package notify provides desktop notification functionality for match events. |
|
reddit
Package reddit provides functionality to fetch goal replay links from r/soccer.
|
Package reddit provides functionality to fetch goal replay links from r/soccer. |
|
ui
Package ui provides rendering functions for the terminal user interface.
|
Package ui provides rendering functions for the terminal user interface. |