Screenshots updated

@@ -7,14 +7,7 @@ teams, browse standings and full team schedules, and open any game into a live
 detail view with box scores, scoring plays, team-stat bars, and a breathing LIVE
 indicator.
 
-```
- SPORTSBALL!  live scores                                    ● 3 live
- ALL │ ⚽ WC │ ⚾ MLB │ 🏀 NBA │ 🏀 WNBA │ 🏒 NHL │ 🏈 NFL
- All │ ● Live │ ◼ Recent │ ○ Upcoming
- …
-```
-
-> _Screenshot / asciicast: TODO_
+![sportsball demo](docs/demo.gif)
 
 ## Features
 
@@ -25,6 +18,14 @@ - **Team schedules** — any team's full season, past results + upcoming fixtures.
 - **Live detail** — box scores, scoring plays, soccer team-stat comparison bars, and a ticker of other games.
 - **Configurable leagues** — show/hide/reorder; off-season leagues auto-hide and return when in season.
 - **Six themes** — Flexoki / Uchu / Humdrum, light + dark.
+
+## Screenshots
+
+| Dashboard | Game detail | Standings |
+|---|---|---|
+| ![Dashboard](docs/dashboard.png) | ![Game detail](docs/detail.png) | ![Standings](docs/standings.png) |
+
+_Regenerate with `vhs docs/demo.tape` (needs an in-season slate for live data)._
 
 ## Install
 

@@ -0,0 +1,69 @@
+# VHS tape for sportsball — regenerate with: vhs docs/demo.tape
+# Produces docs/demo.gif plus stills (dashboard/detail/standings PNGs).
+# Needs live ESPN data at record time; run during an in-season slate.
+
+Output docs/demo.gif
+
+Require go
+
+Set Shell zsh
+Set FontSize 13
+Set Width 1500
+Set Height 950
+Set Padding 20
+Set Framerate 24
+
+# --- hidden setup: build a throwaway binary so the demo opens on the dashboard
+Hide
+Type "go build -o /tmp/sportsball-demo . && clear"
+Enter
+Sleep 10s
+Show
+
+# --- launch + let the poll loop fill the slate
+Type "/tmp/sportsball-demo"
+Enter
+Sleep 6s
+Screenshot docs/dashboard.png
+
+# --- nudge the grid cursor around
+Right
+Sleep 800ms
+Down
+Sleep 800ms
+Right
+Sleep 1s
+
+# --- filter to Recent (All -> Live -> Recent) so we open a played game
+Type "v"
+Sleep 1s
+Type "v"
+Sleep 1500ms
+
+# --- open a finished game into the detail view (box score / scoring timeline)
+Enter
+Sleep 5s
+Screenshot docs/detail.png
+Sleep 2s
+
+# --- back to dashboard, reset filter, then standings
+Escape
+Sleep 1s
+Type "VV"
+Sleep 1500ms
+Type "S"
+Sleep 3s
+Screenshot docs/standings.png
+Sleep 1500ms
+Escape
+Sleep 1s
+
+# --- show theming
+Type "t"
+Sleep 1500ms
+Type "t"
+Sleep 1500ms
+
+# --- quit
+Type "q"
+Sleep 1s