From be491b9bce7841b129c65236b6746be87f3d2398 Mon Sep 17 00:00:00 2001 From: Donavan Fritz Date: Thu, 4 Jun 2026 21:30:36 -0500 Subject: [PATCH] =?UTF-8?q?kiosk:=20document=20live=20weather=20scene=20?= =?UTF-8?q?=E2=80=94=20moon=20phase,=20time-of-day=20motion,=20regional=20?= =?UTF-8?q?patterns?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The kiosk page is now an iOS-Weather-style animated sky (sun/moon arc by time-of-day, accurate moon phase, dawn/dusk glow) reflecting Open-Meteo weather_code + wind: clear/partly/cloudy/fog/drizzle/rain/sleet-ice/snow/ blizzard/storm/hail + stars + lightning. Refresh the reference summary + keywords (index entry was also pending). Co-Authored-By: Claude Opus 4.8 (1M context) --- SKILL.md | 4 +-- reference/kiosk.md | 61 +++++++++++++++++++++++++++++++++++++++++----- 2 files changed, 57 insertions(+), 8 deletions(-) diff --git a/SKILL.md b/SKILL.md index db09525..f80943b 100644 --- a/SKILL.md +++ b/SKILL.md @@ -35,7 +35,7 @@ user-invocable: true categories=["food", "services"] keywords=["Mealie", "meals.vino.network", "recipe", "recipes", "meal", "meal planning", "ingredient parser", "PATCH recipe", "MEALIE_TOKEN", "household Family"] /> + keywords=["kiosk", "update the kiosk page", "kiosk.vino.network", "screen", "display", "wall panel", "TV", "monitor", "webpage", "Chromium", "KIOSK_URL", "host101", "host102", "signage", "dashboard"] /> diff --git a/reference/kiosk.md b/reference/kiosk.md index 182bf43..a4e0ed5 100644 --- a/reference/kiosk.md +++ b/reference/kiosk.md @@ -5,17 +5,66 @@ | Node | Pod (ns `kiosk`) | Output | Showing | |---|---|---|---| -| host101 | `kiosk-host101` | card0-DP-1 (4K) | google.com (validation default) | -| host102 | `kiosk-host102` | card0-DP-1 (4K) | netflix.com (validation default) | +| host101 | `kiosk-host101` | card0-DP-1 (4K) | kiosk.vino.network | +| host102 | `kiosk-host102` | card0-DP-1 (4K) | kiosk.vino.network | Each node drives one screen; multi-screen would need host100's GT 730 (see KIOSK-DESIGN.md). + +Design target = **3840×2160 (4K UHD), devicePixelRatio 1, 24-bit color, +landscape-primary**. Both displays render at native 4K; the Chromium kiosk +has no toolbar/taskbar, so viewport == screen == avail.screen == 3840×2160 +(no CSS px scaling — 1 CSS px = 1 device px). Layout for the kiosk page should +look right at full 4K landscape. (Confirmed on-screen 2026-06-01.) + + + +The default page both screens show is `https://kiosk.vino.network` — an +editorial wall-art homepage: a **live iOS-Weather-style animated sky** + +live local-time clock (pinned `America/Chicago`) + current weather for +55331 (Minnetrista) from `api.open-meteo.com` (the one external call). The +sky is driven by the Open-Meteo `weather_code` (+ `wind_speed`) + +`sunrise`/`sunset`: sun (clear/partly days) and moon (clear/partly nights) +**arc across the sky by real time-of-day**, with a warm dawn/dusk horizon +glow. Conditions rendered: clear, partly, cloudy, fog, drizzle, rain, +**sleet/freezing-rain (ice)**, snow (**blizzard/blowing-snow when wind +≥24 mph**), thunderstorm (**hail on codes 96/99**), plus stars on clear +nights and lightning in storms. The **moon mirrors its +actual phase** (lit fraction + waxing/waning terminator, computed locally +from the date — NOT an extra API call). Weather fetches on load then every +10m, with **fast retry-with-backoff (15s→5m) while failing** so a fetch that +fails at pod start doesn't sit on "Weather unavailable" for the full 10m +(fixed 2026-06-04; live weather scene 2026-06-04). A frozen clock/stale weather on one screen = +that node's Chromium (or the whole node) is wedged, NOT a page bug — the +display holds the last-good frame; recover by graceful pod restart (and see +fritzlab `msp001.md` if the node itself is unreachable). +Source repo: `websites/kiosk.vino.network` (clone at `~/code/git/code.fritzlab.net/websites/kiosk.vino.network/`), +content in `html/`, served from Garage S3 via the standard site-publish flow +(fritzlab `gitops.md` ). + +**"Update the kiosk page" = edit the page content**, NOT the KIOSK_URL: edit +`html/index.html` (or `404.html`) in that repo, commit + push to main → the +`Publish` Gitea Action (site-publish) syncs to the bucket in ~30s. Verify with +`curl -s https://kiosk.vino.network/`. + +**How screens actually pick up a new deploy:** the Chromium kiosk fetches the +URL ONCE at pod start and never re-polls on its own (`entrypoint.sh` only +re-fetches if cage/chromium exits or the pod restarts) — `Cache-Control: +must-revalidate` alone does NOT update a running screen. So the PAGE must +self-reload. `index.html` polls its own ETag every 5m and `location.reload()`s +only when it changes (no periodic flashing). Any new kiosk page MUST carry that +ETag-poll snippet, else the screens stay on the old content until a pod restart. + + -The displayed URL is the `KIOSK_URL` env per pod. -**Permanent (GitOps, preferred):** edit `KIOSK_URL` in `fritzlab/apps/msp001/kiosk/kiosk/manifests/deployments.yaml` (block `kiosk-host101` or `kiosk-host102`), commit + push to `apps` main → msp001 ArgoCD syncs (~3 min poll) → pod recreates on the new page. -**Temporary (now, reverts on next ArgoCD sync):** `kubectl --context msp001 set env deploy/kiosk-host101 -n kiosk KIOSK_URL=https://example.com` — pod recreates immediately; ArgoCD selfHeal puts it back to the git value, so use git for anything lasting. +This changes WHICH URL a screen loads (different site), distinct from updating +the kiosk page content above. The displayed URL is the `KIOSK_URL` env per pod. +**GitOps (only reliable way):** edit `KIOSK_URL` in `fritzlab/apps/msp001/kiosk/kiosk/manifests/deployments.yaml` (block `kiosk-host101` or `kiosk-host102`), commit + push to `apps` main, then force the sync now instead of waiting ~3min for the poll: `kubectl --context msp001 -n argocd annotate application kiosk --overwrite argocd.argoproj.io/refresh=hard`. Pod recreates on the new page. +**Do NOT use `kubectl set env` for this:** ArgoCD selfHeal reverts it to the *stale* git target (the value from the last commit it polled, not your new one) within seconds — the pod recreates but on the old URL. Push to git + hard-refresh instead. (Verified 2026-06-01.) -`kubectl --context msp001 get pods -n kiosk` (want 1/1 Running). On-screen page check needs a screenshot via Chromium CDP (localhost-only) — see fritzlab `msp001.md` . A blank screen usually means `getty@tty1` re-took DRM master (re-mask on the node) or the page is down (Chromium shows last-good frame). +`kubectl --context msp001 get pods -n kiosk` (want 1/1 Running). On-screen page check needs a screenshot via Chromium CDP (localhost-only) — see fritzlab `msp001.md` . Blank-screen causes: (1) cage logs `Swapchain for output ... failed test` on repeat → dirty DRM/GBM state from an UNCLEAN prior exit; (2) `getty@tty1` re-took DRM master (re-mask on the node); (3) page down (Chromium holds last-good frame). + +**Restart kiosk pods GRACEFULLY — never `--force`/`--grace-period=0`.** A hard kill stops cage from dropping DRM master, leaving the next cage with a dirty swapchain → black. Use `kubectl --context msp001 delete pod -n kiosk -l node=host101` (or `rollout restart deploy -n kiosk`). The image self-heals a wedged swapchain in-pod (entrypoint kills+relaunches cage after 5 swapchain failures) and a `tcpSocket:9222` liveness probe restarts a dead Chromium — but a clean shutdown is still the first line of defense. Recovery for an already-black screen = one graceful delete. (Diagnosed + hardened 2026-06-01.) Want a dashboard, photo slideshow, or Home Assistant wall panel instead of a website — just point `KIOSK_URL` at it (e.g. `https://home.vino.network`). [[home-assistant]] for HA URLs.