Live sports win probability visualized on your LED strip.

Scoreline polls ESPN for real-time game data and translates win probability into a dynamic light display on WLED-controlled LEDs. Watch the "battle line" shift as momentum swings.

• Real-time win probability - Polls ESPN every 30 seconds, updates LED segments proportionally
• 5 leagues supported - NFL, NBA, MLB, NHL, MLS (153 teams total)
• Multi-instance - Run different games on different LED strips simultaneously
• Battle line visualization - Home/away team colors chase inward toward an animated divider

• Favorite teams - Configure teams to watch per WLED instance (e.g., nfl:GB, nba:MIL)
• Auto-start - When your team's game goes live, lights turn on automatically
• Priority ordering - Drag-and-drop to set priority; #1 wins when multiple games start
• Game cascade - When a game ends, automatically starts next priority game if available
• Per-instance - Each strip can watch different teams

Two-phase system when a game ends:

Phase 1 - Celebration (in winner colors):

• Chase - Full strip chase effect (default)
• Twinkle - Sparkle/twinkle effect
• Flash - Strobe effect
• Solid - Static winner colors
• Freeze - Keep final win probability display

Configurable duration: 30 seconds to 10+ minutes

Phase 2 - After Celebration:

• Fade off - Graceful fade to black (default)
• Off - Immediate off
• Restore - Return to whatever preset was playing before the game
• Preset - Switch to a specific WLED preset

• Minimum dignity - Losing team always keeps at least X% of the strip
• Dark buffer - Black pixels separating teams from the battle line
• Divider size - Width of the animated center divider
• Divider style - Preset animations: default (orange scanner), intense (red fire), ice (blue scanner), pulse (white breathe), chaos (orange strobe)
• Chase speed & intensity - Control the team color chase effect

• Test without live games - Drag a slider to preview any win percentage
• Live preview - See exactly how your LED strip will look before game day
• Team picker - Select any two teams from any league
• Auto-play mode - Watch it cycle through scenarios automatically

Explicit UI states with visual feedback:

• Idle - No game, no watch teams configured
• Armed - Watch teams configured, waiting for game to start
• Watching (Auto) - Game started automatically from watch list
• Watching (Manual) - Game started manually
• Override - Manually watching a different game than auto-watch would choose
• Final - Game ended, celebration playing
• Simulating - Simulator mode active

• Connectivity status - Healthy / Stale / Unreachable indicators per instance
• Automatic detection - Tracks successful/failed WLED communications
• Non-blocking - Warnings don't interrupt operation

• Preset preservation - Saves your current WLED state before taking over, can restore after
• Sync-on-load - Detects if WLED was changed externally and reflects reality
• Mini scoreboard - Live game scores displayed in the web UI per instance
• Blackout mode - Pixels outside your configured range go dark during games
• mDNS discovery - Auto-find WLED devices on your network
• Hot-reload config - YAML changes detected automatically, state preserved
• Instant settings - Display changes push to WLED immediately

services:
  scoreline:
    image: ghcr.io/jasondostal/scoreline:latest
    container_name: scoreline
    restart: unless-stopped
    ports:
      - "8084:8080"
    volumes:
      - ./config:/app/config
    environment:
      - TZ=America/Chicago

docker compose up -d
# Edit config/settings.yaml with your WLED IP
# Container auto-creates defaults on first run

Open http://localhost:8084 and pick a game.

mkdir scoreline && cd scoreline
docker run -d --name scoreline \
  -p 8084:8080 \
  -v ./config:/app/config \
  ghcr.io/jasondostal/scoreline:latest

Edit config/settings.yaml:

wled_instances:
  - host: 192.168.1.100         # Your WLED IP
    start: 0                     # First LED index
    end: 300                     # Last LED index
    watch_teams:                 # Auto-watch these teams (optional)
      - nfl:KC
      - nba:LAL
    display:                     # Per-instance overrides (optional)
      chase_speed: 185
    post_game:                   # What happens when game ends (optional)
      celebration: chase         # freeze | chase | twinkle | flash | solid
      celebration_duration_s: 300  # 5 minutes
      after_action: restore      # off | fade_off | restore | preset

poll_interval: 30
auto_watch_interval: 300         # Seconds between auto-watch scans

# Global defaults (all optional - sensible defaults built in)
display:
  divider_preset: classic        # classic | intense | ice | pulse | chaos
  min_team_pct: 0.05
  contested_zone_pixels: 6
  dark_buffer_pixels: 4

post_game:
  celebration: chase
  celebration_duration_s: 60
  after_action: fade_off

First run auto-populates with defaults:

config/
├── settings.yaml      # WLED instances, preferences, watch teams
└── leagues/           # League definitions (team colors, ESPN mappings)
    ├── nfl.yaml
    ├── nba.yaml
    ├── mlb.yaml
    ├── nhl.yaml
    └── mls.yaml

• NFL (32 teams)
• NBA (30 teams)
• MLB (30 teams)
• NHL (32 teams)
• MLS (29 teams)

League files are YAML - drop in your own to add a league.

• WLED-controlled LED strip
• Network access to WLED device
• Docker or Python 3.11+

GPL-3.0 - See LICENSE for details.

• WLED - the LED firmware that makes this possible
• ESPN's scoreboard data (unofficial API)