README
¶
Golazo
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
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
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 terminal user interface components for golazo.
|
Package ui provides terminal user interface components for golazo. |
|
ui/design
Package design provides reusable visual design components.
|
Package design provides reusable visual design components. |
|
ui/logo
Package logo renders a GOLAZO wordmark in a stylized way.
|
Package logo renders a GOLAZO wordmark in a stylized way. |