# 290 — Screenshot skin picker

Built and verified in Kodi 21.3 on 2026-10-28. Publishing awaits Standa's approval.

The same dialog is used for onboarding and Home settings → Choose skin, immediately
below Check for updates. The left-hand list takes one quarter of the content;
the right-hand side shows one large, uncropped screenshot of the highlighted
skin: Normal, Modern, Normal Horizont, Modern Horizont. Browsing updates the
preview without changing the active skin; OK applies it and Back cancels.
Previews use Kodi's 1920×1080 image cache; source PNG bytes match
`docs/design/progress-above-buttons/`.
`DialogBackgroundCommons` supplies the same materials, header and accent as the
update dialog. One generated row definition supplies both focus states.

The service waits for the skin installer and any library migration to finish,
then opens the picker on idle Home without video or another modal dialog.
Back postpones the offer until the next service start. Selecting a skin uses the
existing installer and Kodi's Keep skin confirmation. Only a successful choice
sets the profile's persistent text setting `skin_picker_completed=1`; subsequent
starts and updates do not offer again. The manual menu entry stays available.
This supersedes the original per-version yes/no switch offer in chapter 040.

Implementation: `wcs/skin/picker.py`, the existing local-action dispatcher,
`wcs/skin/service.py` and the migration completion notification in `main.py`.
The installer owns copying and switching; the picker does not duplicate either.
Translations are provided in Czech, Slovak and English.

Verification:

- Live automatic opening, four loaded previews, Back without a same-session repeat.
- Live menu placement and opening after onboarding was already completed.
- Live switch Modern Horizont → Normal Horizont → Modern Horizont with native
  confirmation; matching `skin_variant`/`skin_variant_applied` and completion flag.
- Selecting the current skin completes without a confirmation prompt.
- A second Kodi restart with completion set leaves Home open, no picker.
- Estuary renders the same dialog and all four previews (first-install context).
- 125 targeted tests: picker 13, refresh service 36, installer 26, update 11,
  Glass 14, shared styles 15, commands 10. Layout assertions prevent list/preview
  overlap and enforce a single 16:9 preview. Runtime ZIP includes the dialog,
  handler and exact PNGs. The list revision reran the 13 picker tests.

Current list revision: `docs/design/skin-picker/list/`, with all four highlighted
states and `navigation.json` verifying that only the preview changed.
Live list acceptance also covered automatic opening after restart, opening from
the settings menu, OK on the current skin, and Back preserving profile settings.
The four preview crops matched their approved source images within 0.5 mean RGB
levels after resampling to the same size.
Previous grid evidence: `docs/design/skin-picker/03-manual.png`, `02-settings-menu.png`,
`04-estuary.png`, `completed-restart.json`. `01-automatic.png` records the first
automatic opening before the focus-frame refinement. The test completion
flag was restored afterward so Standa can see onboarding on the next startup.
