fix: tidy the card status row and text shading
Problem and reproduction
Episode and movie cards put the runtime in a pill on the bottom left, the watched tick inside it, and the season and episode number in the caption under the series name (S3 E7 – These Fragile Lives). The time left only showed as loose text after the resume bar.
Text shading on the Home spotlight and the detail pages had also drifted. The same role used different brightness in different places: a synopsis was 92% on the Apple TV detail hero, 80% on iPhone, 75% on the spotlight and 72% on the loading page, and on the hero the synopsis, genres, year and runtime were close enough to read as one block. On episode cards the synopsis and air date were nearly the same grey.
Implementation and impact
Cards (Home Continue Watching and Next Up, and the episode cards on series, season and episode pages, on iPhone, iPad and Apple TV):
- One status row on the artwork, drawn by a single shared view (
MediaRuntimeStatusOverlay) in place of three copies. - The resume bar runs along the bottom edge of the artwork at full width, clipped by the card's corners, so it is the same length on episodes and movies. The loose "23m left" text after the bar is gone from these cards.
- One pill on the bottom right: minutes left, which is the full runtime before the title is started. A watched title shows the tick on its own. A rewatch in progress shows its minutes left.
- The season and episode number stays in the caption. Home's second line is
S3 E7 · These Fragile Liveson every episode card with the status row, the Apple TV series page keeps "3 · Name" and iPhone and iPad keep the "EPISODE n" line. - An episode with no title of its own takes its number as the title, so iPhone and iPad leave the "EPISODE n" line out rather than repeating it. A blank title from the server counts as none.
- An episode with neither a number nor a title of its own falls back to the year on Home, as it did before.
- The older Apple TV episode rail uses the same row in place of its caption runtime, green tick badge and watched dim.
- On iPhone and iPad Home stills, the downloaded mark moves to the bottom left on these cards so it doesn't sit on the pill.
- Minutes left now round the same way as the Resume button on whole-minute positions.
Text shading:
- Five text levels in
VividColours.swift: Primary (titles, the Movie or Series label, now semibold), Strong 92% (names, scores, values), Body 72% (every synopsis), Secondary 60% (credit lines, cast roles, small labels) and Tertiary 50% (genres, year, runtime, a season's facts line, air dates). - A synopsis is always a clear step apart from the name above it and the facts beside it, on the spotlight, the detail hero, the season header and episode cards. The loading page uses the same levels as the loaded page, so nothing changes brightness when a title loads.
- Poster and card captions across the app moved onto the same levels so they match the cards beside them.
Unchanged: font sizes, layout, focus behaviour, posters' top-right watched pill, wide stills that are neither episodes nor Continue Watching movies, and the iPhone Home spotlight, which still has no type label or synopsis. Silo, Emby and Jellyfin all go through the same cards.
The small thumbnails in the iPad episode list use a smaller pill (10 points against 12).
Validation
xcodebuild buildforVividTV(Apple TV 4K simulator) andVivid(iPhone 18 Pro simulator) both succeed atabce69d9.scripts/l10n/sync-string-catalog.shrun: no String Catalog changes.python3 scripts/ci/check-docs.pypasses.- New unit tests in
MediaRuntimeStatusOverlayTestscover the right pill (not started, in progress, watched, rewatch, nothing known), and Home's episode caption line. Not run locally; CI runs them.
Performance
Not applicable, no performance claim. No benchmark was run.
Testing status
- Tested? Partly.
- Environment: Apple TV 4K (3rd generation) simulator, tvOS 27.0, and iPhone 18 Pro simulator, against my Silo server.
- Revision:
abce69d9. - Checks and results: blurbery checked iOS on the iPhone 18 Pro simulator at
730f9c3aand it looks right. I checked Home's Continue Watching on the Apple TV 4K simulator at1057937d: the bar sits on the bottom edge, the pill is bottom right and the captions carry the episode number. The spotlight, series page and an earlier iPhone pass were on earlier revisions, before the bar and number moved. - Limitations: No physical device. The caption fixes in
d9efe911,730f9c3aandabce69d9were compiled but not looked at in a simulator, and neither were the iPad layouts, a watched or part-watched episode on each card type, Emby and Jellyfin, or VoiceOver.
Design impact and approval
- Design impact: The card status row, captions and text shading change as described above.
- Approval from blurbery: My own design change.
Documentation impact
Updated docs/app-design.md (card status row, captions and the text scale), docs/apple-tv-browsing.md (spotlight heading and overview, season synopsis, episode cards and rail) and docs/cores/emby.md (Continue Watching caption).
- I checked the docs this change affects and updated them in this PR, or explained above why none needed changes.
AI disclosure
I implemented these changes and used Claude Opus as a tool.