LivingKioskUse now
← All displays

Scoreboard

Whichever of your teams is playing, live — score, clock or inning, and a brief quiet highlight when the score changes, the one deliberate exception to an otherwise calm display. With nothing live it counts down to the next game and shows the last result underneath. TheSportsDB and MLB’s own StatsAPI supply four leagues between them; ESPN is left out on purpose, since its terms don’t clearly license this kind of always-on automated use.

Scoreboard showing a live MLB game: Los Angeles Dodgers 2, San Francisco Giants 2, bottom of the 5th with 0 outs, and a today panel listing the same game.
LiveA game in progress, plus today’s slate alongside it.
Scoreboard with no game live: a countdown to the next Seahawks at 49ers kickoff, the matchup and kickoff time, and the last result, 20–27, beneath it.
CountdownNothing live: next game, and the last result underneath.

Where the scores come from

TheSportsDB covers all four leagues out of the box. MLB’s own public StatsAPI adds inning, outs, and the ball-strike count for baseball specifically. ESPN’s richer endpoints are deliberately not used — undocumented, unsupported, and not clearly licensed for this kind of unattended use.

Where it runs

Self-hosted, server-side cache — a wall of screens all following the same team costs one upstream request, not one per screen. With no teams configured at all, it runs a realistic six-minute demo loop from the wall clock, watermarked, with no network calls.

What it wants

Teams as league:slug — mlb, nba, nfl, or nhl — picked from a bundled directory of 124 teams, plus a time zone and, if the screen sits somewhere people sleep, a quiet hours window.

Setup

Put Scoreboard on a screen.

A browser is genuinely enough — Plash and Fully Kiosk below are conveniences, not requirements.

Any screen

nothing to install
  1. Open the display in whatever browser the screen already has.
  2. Go full screen: F11 on Windows and Linux, ⌃⌘F on macOS.
  3. Or give it a browser of its own, which is what a dedicated panel wants: chrome --kiosk <url> — on macOS, open -a "Google Chrome" --args --kiosk <url>.
  4. Turn off display sleep in the machine’s power settings and walk away.

Mac desktop

via Plash
  1. Install Plash from the Mac App Store — it renders any web page as your desktop wallpaper.
  2. Menu bar icon → Open URL… and paste the display’s address.
  3. Leave Browsing Mode off so clicks pass through to your desktop as normal.
  4. Plash reloads on wake, so it recovers on its own after sleep.
sindresorhus.com/plash →

Wall tablet

via Fully Kiosk
  1. On any Android tablet, install Fully Kiosk Browser.
  2. Settings → Web Content → Start URL: the display’s address.
  3. Under Device Management, keep the screen on and set a dim schedule so it isn’t glaring at 3am.
  4. Turn on Start on Boot so a power blip brings the display back by itself.
fully-kiosk.com →

Displays are ordinary web pages, so anything that can hold one open works: a Raspberry Pi on a monitor, a retired iPad, a Fire tablet, the browser built into a TV.

Configuration

URL parameters.

Everything below, plus a live preview and a URL builder that writes the link for you, is at scores.livingkiosk.com/setup.

ParameterDefaultMeaning
teamsnone (demo)Comma-separated league:slug — e.g. mlb:giants,nba:warriors,nfl:49ers,nhl:sharks.
tzAmerica/Los_AngelesControls every on-screen time and the quiet window.
quietHH:MM-HH:MM, local to tz. Stops polling and dims the screen.
dim0Flat black overlay, 0–0.8 (fleet-wide convention).
bgdarklight or #hex.
demoautoon forces the demo slate even with real teams; off never shows it.

Scoreboard is open source under the MIT licence. Run it yourself with one command — the repositories go public at launch.