Faceoff brings live NHL scores and play-by-play to your terminal

April 19, 2026
A close-up of a Canon lens cap placed on a laptop keyboard, showcasing modern technology.
Photo by jano gepiga on Pexels

What it does

Faceoff is a terminal user interface (TUI) for following NHL games in real time. Want live scores, play-by-play, box scores and scoring summaries without opening a browser? This does that — schedules by date, pre-game previews with goalie comparisons and skater leaders, team rosters, player profiles and career stats. It has been reported that the app auto-refreshes scores for live games and adapts its layout to your terminal width, showing game times in your local timezone with abbreviations. Nostalgia for the command line never felt so up-to-the-minute.

How to try it

Installation is straightforward: run uvx faceoff or pip install faceoff and then type faceoff. The UI is built with Textual, the modern Python TUI framework, and pulls data via an nhl-stats-api-client. It has been reported that the project was inspired by Playball, a similar terminal app for MLB — a nice bit of cross-sports sibling rivalry in code form.

Faceoff also surfaces league standings (wild card, division, conference, league views) and player stat leaders for skaters and goalies, so you can stalk trends as well as box scores. Who needs push notifications when you can have the whole rink in a few terminal panels? For fans who live in tmux panes and terminal color schemes, this is a little delight.

A quick caveat: the project is not affiliated with or endorsed by the NHL and uses publicly available NHL API data for informational and educational purposes. Try it, poke at the layout, and maybe boot up a game night in the terminal — old-school charm with modern data.

Sources: vincentgregoire.com, Hacker News