josh 6c098850f5
All checks were successful
CI / Lint (push) Successful in 7s
CI / Test (push) Successful in 6s
CI / Build & Push (push) Successful in 19s
fix: use truthy check for intermission filter, add route test
`is True` strict identity fails if the NHL API returns an integer 1
instead of a JSON boolean. A truthy check is safe here since the
Intermission field is always False/0 for non-intermission live games.

Also adds a test that verifies intermission games are separated from
live games in the /scoreboard response.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-29 19:57:00 -04:00
2026-03-29 09:20:21 -04:00

NHL Scoreboard Web App

A web application that displays live NHL game scores, team statistics, and game states in real-time. Retrieves data from the NHL API and surfaces the most interesting games first using a hype scoring algorithm.

Features

  • Live NHL game scores, shots on goal, and game state
  • Power play indicators with live countdown clock
  • Smooth period and intermission countdown clocks
  • Hype Meter — ranks games by how exciting they are right now, factoring in:
    • Period, time remaining, and score differential
    • Late-game urgency and comeback bonuses
    • Power play situations
    • Game importance — boosts standings-relevant matchups late in the season, with extra weight for division and conference rivals fighting for playoff spots

Hype Scoring

Games are sorted by a priority score combining in-game excitement and contextual importance:

Factor Description
Period & time Later period and deeper into it = higher base score
Score differential Close games rank higher; blowouts are penalized
Late urgency Bonus for ties and 1-goal games in the final 12 minutes
Comeback One-time spike when the trailing team scores to pull within 2
Power play Bonus for an active man advantage, scaling with game situation
Game importance Season-progress × playoff-bubble proximity × rivalry multiplier (max +150 pts)

Game importance ramps up sharply after ~game 55 of 82, peaks for teams fighting for the last wildcard spot, and applies a 1.4× bonus for division games and 1.2× for conference games.

Technologies Used

  • Python / Flask — backend and API polling
  • SQLite — standings cache (refreshed every 10 minutes)
  • HTML / CSS / JavaScript — frontend with auto-refresh every 10 seconds

Installation

  1. Clone the repository:

    git clone https://github.com/your-username/nhl-scoreboard.git
    
  2. Install dependencies:

    pip install -r requirements.txt
    
  3. Run the application:

    python run.py
    
  4. Open http://localhost:2897 in your browser.

Credits

Data provided by the NHL via their public API.

License

MIT License

Description
NHL Scoreboard Without Fluff
Readme 332 KiB
Languages
Python 79.5%
JavaScript 11.1%
CSS 7.2%
HTML 1.7%
Dockerfile 0.5%