Faceoff is a terminal UI application for following NHL hockey games in real-time, featuring live scores, game details, standings, player stats, and team information with a responsive layout.
Faceoff is a TUI app written in Python to follow live NHL games and browse standings and stats. I got the inspiration from Playball, a similar TUI app for MLB games that was featured on HN.<p>The app was mostly vibe-coded with Claude Code, but not one-shot. I added features and fixed bugs by using it, as I spent way too much time in the terminal over the last few months.<p>Try it out with `uvx faceoff` (requires uv).
# faceoff
Source: [https://www.vincentgregoire.com/faceoff/](https://www.vincentgregoire.com/faceoff/)
A terminal user interface \(TUI\) application for following NHL hockey games in real\-time\.
## Features[¶](https://www.vincentgregoire.com/faceoff/#features)
- **Live Game Schedule**: Browse NHL games by date with easy navigation \(previous/next day\)
- **Real\-time Updates**: Auto\-refreshing scores for live games
- **Game Details**: View play\-by\-play, box scores, and scoring summaries for in\-progress and completed games
- **Pre\-Game Preview**: View matchup data including goalie comparison and skater leaders for upcoming games
- **League Standings**: View current NHL standings with multiple views \(Wild Card, Division, Conference, League\)
- **Player Stats Leaders**: View top players in various statistical categories for skaters and goalies
- **Team Browser**: Browse all NHL teams, view rosters, and team schedules
- **Player Profiles**: View detailed player information, career stats, and game logs
- **Responsive Layout**: Game cards and standings automatically arrange based on terminal width
- **Local Time Display**: Game times shown in your local timezone with timezone abbreviation
## Screenshots[¶](https://www.vincentgregoire.com/faceoff/#screenshots)
Game detail view \(shown with different terminal color schemes\):
League standings:
## Quick Start[¶](https://www.vincentgregoire.com/faceoff/#quick-start)
### Installation[¶](https://www.vincentgregoire.com/faceoff/#installation)
The easiest way to run Faceoff is with`uvx`:
```
uvx faceoff
```
Or install with pip:
```
pip install faceoff
faceoff
```
## Acknowledgments[¶](https://www.vincentgregoire.com/faceoff/#acknowledgments)
This project was inspired by[Playball](https://github.com/paaatrick/playball), a similar terminal application for following MLB baseball games\.
### Built With[¶](https://www.vincentgregoire.com/faceoff/#built-with)
- **[Textual](https://github.com/Textualize/textual)**\- The modern TUI framework for Python that powers the user interface
- **[nhl\-stats\-api\-client](https://github.com/liahimratman/nhl-api-client)**\- Python client for accessing NHL API data
## Disclaimer[¶](https://www.vincentgregoire.com/faceoff/#disclaimer)
This project is not affiliated with, endorsed by, or in any way officially connected with the National Hockey League \(NHL\), any of its teams, or any of its affiliates\. All NHL logos, trademarks, and data are the property of the NHL and its teams\.
This application uses publicly available NHL API data for informational and educational purposes only\.
Courtside is a terminal UI for following NBA games, box scores, and standings, pulling data from public NBA endpoints and offering keyboard-driven navigation.
A website that converts live MLB data into near real-time 8-bit pixel art broadcasts of baseball games, with stadium details, day/night modes, and interstitials.
NMLinux is a free, open-source Linux adaptation of NETworkManager, providing a unified GUI for common network tools. Built with Python and PySide6, it includes modules for SSH, RDP, VNC, Wi-Fi, traceroute, speed test, and more, aimed at sysadmins and power users.
Hugo-Flow is a web-based front-end interface for Hugo static sites, featuring GitHub integration, dual WYSIWYG/Markdown editor, and image uploads via base64.