GitHub - perryraskin/world-cup-tui: Terminal live scoreboard and match timeline for the FIFA World Cup · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
perryraskin
world-cup-tui
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>4 Commits<br>4 Commits
src
src
.gitignore
.gitignore
README.md
README.md
package-lock.json
package-lock.json
package.json
package.json
tsconfig.json
tsconfig.json
View all files
Repository files navigation
world-cup-tui
Terminal live scoreboard and match timeline for the FIFA World Cup.
The default data source is ESPN's public World Cup scoreboard and match summary endpoints. It works without an API key and can show live scores, match status, team stats, key events, and commentary when ESPN exposes those fields.
Features
Live World Cup match list with score, status, kickoff time, and venue
Match detail screen with scoreline, venue, team stats, and play-by-play
Auto-refreshing terminal UI with manual refresh
Keyboard controls modeled after lightweight sports TUIs
Opens the selected ESPN match page in your browser
No API key required for the default ESPN source
Install
npm install
Run
Development mode:
npm run dev
Build and run:
npm run build<br>npm start
After build, you can also run the binary directly:
node dist/index.js
If installed globally or linked locally, the binary is:
world-cup-tui
Controls
j / down: move down or scroll timeline
k / up: move up or scroll timeline
enter: open selected match
b / esc: back to match list
r: refresh now
o: open selected match on ESPN
q: quit
Options
npm run dev -- --refresh 10<br>npm run dev -- --date 20260615<br>npm run dev -- --limit 20
--refresh : auto-refresh interval, default 15
--date : request a specific ESPN scoreboard date
--limit : scoreboard event limit, default 100
Data Source
The CLI currently uses:
Scoreboard: https://site.api.espn.com/apis/site/v2/sports/soccer/fifa.world/scoreboard
Match detail: https://site.web.api.espn.com/apis/site/v2/sports/soccer/fifa.world/summary
These endpoints returned live FIFA World Cup match data during development, including commentary for active matches. They are not a formal ESPN public API contract, so the adapter is kept small and isolated in src/espn.ts.
Development
npm run typecheck<br>npm test<br>npm run build
Notes
Paid sports data providers can be added as additional source adapters if richer or contract-backed live data is needed.
About
Terminal live scoreboard and match timeline for the FIFA World Cup
Resources
Readme
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
stars
Watchers
watching
Forks
forks
Report repository
Releases
No releases published
Packages
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
TypeScript<br>94.4%
JavaScript<br>5.6%
You can’t perform that action at this time.