football

What it is

football keeps the match where your eyes already are. During games the bar shows a live score with the match clock; before them, a countdown to kick-off; in between, league tables and full fixture lists - including cup draws and European nights in the Champions League and Europa League. Underneath sits a terminal scorecard UI with keyboard navigation for the full picture.

Data comes from ESPN's public scoreboard - no API key to request, no account to leak. Smart rate-limiting keeps the polling polite, and results are cached so a bad network shows you the last known truth instead of a blank widget. Like the rest of the shelf: Python standard library only.

Highlights

• Live scores with match clock during games
• Countdown timers to upcoming kick-offs
• League tables and full fixture lists
• Cup competitions and European ties - FA Cup, League Cup, UCL, UEL
• Terminal scorecard UI with keyboard navigation
• Smart rate-limiting against API throttling
• Result caching for offline resilience - no API key, stdlib only

Install

omarchy plugin add https://github.com/niraj-envision/football.git --enable

Standalone: clone the repo and run ./install.sh.