Schedule & scoreboard

Season schedule, results, and live scores

Schedule & scoreboard

Schedule

Job: NFL: season schedule and results — 0:00 and 7:00 ET daily. Command: football_sync schedule [--season YYYY]

Reads the all-seasons games.csv from nflverse and keeps the rows for the current season (ESPN per-team schedules as the fallback when nflverse has no rows yet). Each row carries the ESPN game id, so both sources write the same Game. nflverse also supplies the spread, total, coaches, starting QBs, referee, roof and surface.

A game with a final score is marked post / completed. A game without one is left alone if the scoreboard already marked it live — a schedule re-run never regresses an in-progress game or clears scores the scoreboard set.

Scoreboard

Job: NFL: live scoreboard — every 30 minutes. Command: football_sync scoreboard

One ESPN /scoreboard call: scores, quarter linescores, clock, period, status detail, game leaders, attendance and the teams' records, written onto games already in the database. When no game is within a day of today the job returns without calling ESPN, so the off-season costs nothing. The manual command always calls.