# Episode continuation in the cinematic hero

Decision: Standa, 2026-10-29. This supersedes the earlier mockups showing a continuation card for films.

## Mandatory distinction

- **Film:** keep the existing progress bar and remaining time below the synopsis. Never show the right-hand
  continuation card. The film's title, synopsis and fanart already describe the playback target; duplicating that
  fanart in a card adds no useful information.
- **Series:** show a wide preview of the actual episode to resume or play next. The episode still conveys something
  different from the series fanart. Move the episode code, remaining time and progress into this card; do not repeat
  them below the synopsis.
- This distinction applies to every cinematic hero: mixed rows, movie/series sections, recommendations, genre pages,
  pinned Home details and MyTV. It must not depend on a widget's poster/landscape style or on a cold/warm cache.
- A card is informational and introduces no focus stop or second playback button. Its target must agree with the
  existing playback action and the library/MyTV continuation rules.

## The hero of an episode (Standa, 2026-11-01)

A focused episode is the hero itself, in every row and on the pinned detail while its episodes are the current row
(`hero.episode`, `gen_detail.pinned_or_episode`): the episode's name as the title, the series and its genre in the
kicker, the gold badge `S2 · E3` with the episode's TMDb rating, runtime and year, and the episode's own text. Never
the series' description: an episode without one says so (`#35747`). The backdrop stays the series'. A watched episode
under the cursor has its preview too (`ZHLÉDNUTO`).

## Episode states

| State | Card content |
| --- | --- |
| In progress | Exact episode still, season/episode, progress based on the saved stream duration, remaining time |
| Next available episode | Exact next episode still, season/episode, full runtime when known; no empty progress bar |
| Not yet released | Season/episode and premiere date when known; no fabricated progress or remaining time |
| Finished / caught up with no announced next episode | No continuation card |
| Missing still | Series backdrop, then poster, then the card's dark surface; retain the correct episode facts |
| Unknown duration | Keep the episode identity; omit unavailable progress and time |

The same episode selection must survive the display-only row snapshots and the service's row journals. A cached
series poster must carry the same continuation target as its episode row and pinned detail. Metadata reads remain
cache-only in widgets. The optional low-power artwork profile still applies.

## Presentation

The final size correction (Standa, 2026-10-29) reduces the oversized mockup by about a fifth: a rounded landscape
image fading into a navy foot. In 1080p skin coordinates it is **600 × 300**, top **152** within the content area,
48 from the screen's right edge. Its width matches the synopsis column and its bottom aligns with the hero buttons.
The existing
right-edge compensation keeps it anchored while the sidebar moves; horizontal navigation uses the same body.
Status, season/episode, progress and time share 32 px insets; season/episode and status share one line, so the upper
two thirds of the still stay readable (Standa, 2026-11-01). Text over the photograph must retain at least 7:1
contrast. Existing accent colours control progress; the card never acquires a focus highlight.

Film inline progress retains its existing 344 px vertical position, 420 px track and remaining-time caption.
Long titles, services and hero actions must remain legible and clear of an episode card. The space is taken only
while a card is there: the hero's button list exists in two copies with the same ids (1080 px beside a card, 1700 px
without one, `gen_cinema.button_widths`), and with the sidebar open a card makes way for a hero of many buttons. Row-thumbnail progress
indicators are unchanged.

## Implementation and verification

Shared presentation data: `wcs/skin/hero.py`; library row snapshots: `wcs/library2/rows.py`; pinned details:
`wcs/skin/detail.py`; MyTV episode data: `wcs/skin/widgets.py`. XML is generated through `gen_cinema.py`,
`gen_detail.py`, `gen_genre.py` and `gen_modular.py`. Card textures come from `gen_cinema_textures.py`.

Kodi 21 does not read custom Window properties numerically through progress `<info>` (they become booleans).
Pinned detail controls 41908/41909 therefore receive numeric `setPercent` updates; row heroes still read native
ListItem properties. The existing hero watcher restores detail progress after ReloadSkin and republishes the pinned
target after the library revision changes, including the transition to the next episode after playback.

Required checks: films never expose episode-card fields; film/episode switching leaves no stale UI; resume/next/
upcoming/finished episode states; season rollover; missing artwork and unknown duration; cold/warm poster rows and
journal replay; pinned details and MyTV; sidebar/horizontal × Normal/Glass composition; native Kodi screenshots and
D-pad navigation. Live checks must not change the household's watch history.
