Kaleido/docs/audit-2026-10-27.md
Elijah 64ad7b55cd
All checks were successful
Validate and publish Kaleido / android (push) Successful in 2m44s
Release Kaleido 0.2.0 with remote-ready search, quick actions, extras and playback settings
Fix the 0.1.11 audit findings: Search results were unreachable from the
text field, Back exited from Home rows, only the first version/part played,
a moved server was never re-discovered, chapter names were off by one,
menus opened away from the current choice, and focus restoration misfired.

Add long-press/Menu title actions, trailers and extras, voice and system
search, View all rows, a per-destination library choice, autoplay and
auto-skip settings, a separate remote quality, and subtitle size/style.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 16:10:34 -07:00

12 KiB
Raw Blame History

Kaleido 0.1.11 polish audit — 2026-10-27

Status: the bugs and polish items below, and the missing features marked in section 4, were addressed in 0.2.0. See runtime verification for what was and wasn't verified on a device.

Scope: a full read of app/src/main plus hands-on D-pad testing of the installed release 0.1.11 on the onn (192.168.50.195). No code was changed and nothing was installed. Screenshots are in the ignored evidence/private/audit-2026-10-27/ folder; file names are cited as (shot: name).

Side effect: playing Hazbin Hotel S2·E2 for about three minutes moved its Plex resume point from 15 to 18 minutes. The app was left on Home.

Labels: Verified = reproduced on the TV. Code = confirmed by reading the source but not exercised on the TV.


1. Major bugs

# Area Finding Evidence
M1 Search You can't reach search results with the D-pad. Once the search field has focus, Down, Right and the keyboard's Done key all leave focus in the field. Back is the only way out, and it leaves Search for Home. On a remote, Search is effectively unusable. SearchScreen has no focus link from the OutlinedTextField to the grid, and the field consumes the arrow keys. No UI script covers Search (verify_ui.py has no search step). Verified with uiautomator focus dumps after Down/Down/Right (shots: search4, search5, ime)
M2 Home One Back press from anywhere in the Home rows exits the app. Pressing Back with focus four rows down went straight to the launcher. Most TV apps first return focus to the top (hero/tabs) and only exit from there. KaleidoViewModel.back() returns false on Home regardless of scroll position. Verified (shots: rows → back1)
M3 Playback Only the first media version and the first part are ever used. Everything uses item.media.first() / parts.first() (Playback.kt, PlexApi.transcodeParams with mediaIndex=0/partIndex=0). A movie with 4K and 1080p versions can't be switched, and a stacked multi-part movie (CD1/CD2) stops after part 1. Code
M4 Connection The stored server address is never re-discovered. initialize() only validates the saved session.server URL. If the server's LAN IP changes, the TV leaves the LAN, or a plex.direct address rotates, startup shows "Cannot load this server" until the user opens Settings → Choose server. The official app retries every connection from plex.tv/api/v2/resources. Code

2. Functional bugs

# Area Finding Evidence
F1 Player Chapter names are off by one. The first chapter appears as "Chapter 2 · 0:00". Models.kt builds the fallback title as Chapter ${index+1}, but Plex chapter index is already 1-based. Verified (shot: chapters)
F2 Player Track lists don't open at the current item. In the Chapters list at 18:35, focus opened on the first chapter. TrackOption gives initial focus only to the selected row, which LazyColumn hasn't composed while it's off-screen, so the list never scrolls to it. The same applies to long subtitle lists (this episode has more than 7 languages). Verified (shot: chapters)
F3 Player "Playback options" shows a checkmark on its first row ("✓ Quality · Original quality"), as if it were a selected choice. PlaybackOptions passes selected=0 to TrackPanel. Verified (shot: opts)
F4 Player "Chapters" is always listed, even for titles with no chapters. It then opens a panel that says "No tracks available". Code
F5 Details After playback, focus returns to the Back arrow instead of Resume/Play. Verified (shot: afterplay)
F6 Home Season items in "Recently Added TV" are labelled only "Season 1", with no show name or subtitle. BrowseCard uses displayTitle, which equals title for seasons. (recentSeasons adds the show name for the TV tab, but Home's /hubs items don't get it.) Verified (shot: rows)
F7 Movies/TV A second movie or TV library is only half supported. The library switcher appears only in the A–Z view, and Discover always shows the first library. chooseSection doesn't reset unwatched, doesn't build the "New seasons" row and isn't cached. Changing tabs drops back to the first library. Code
F8 Player (movies) A finished movie sits on its last frame. Post-play only runs for episodes, and auto-hide requires isPlaying, so the player stays open with its controls showing. The official app returns to the details page. Code
F9 Errors "Try again" doesn't retry what failed. ErrorDialog calls vm.retry(), which reloads the page. After a failed play() or Mark watched, it reloads instead of retrying the action. Code
F10 Movie details Down from Play lands on the second cast member (Jessica Biel), not the first. Geometric focus search picks the nearest card. Verified (shot: mdetail2)
F11 Details Restoring focus to Cast doesn't work on movie pages. When returning from an actor page to a movie, the scroll target for cast: is only computed when vm.children is non-empty (shows). Code
F12 Playback Every conversion request says location=lan, and Original quality always tries the source file first. On a remote or relay connection, that means a full-bitrate direct play with no remote-quality limit. Code
F13 Misc selectServerStream catches Exception without rethrowing CancellationException, unlike the rest of the codebase. Code

3. Polish and UX

# Area Finding Evidence
P1 Browse The focus ring is nearly invisible on light posters. Discover/Home poster cards show focus only as a 2 dp white border and a slight text-colour change, with no scale. On Toy Story 5, focus couldn't be seen; a dump confirmed it was there. (MediaTile in the A–Z grid does scale; BrowseCard doesn't.) Verified (shot: s8)
P2 Home Card captions are hard to read over bright backdrops. Row captions sit directly on the full-bleed backdrop (e.g. "Fire Country S5 · E3"). Verified (shot: rows)
P3 Season page The season page doesn't show the show name. The header says only "Season 1". Verified (shot: season)
P4 Season page Season episodes are hard to scan. Each episode card repeats the show name ("The 4400") as its title and puts the episode name in small subtitle text. There are no synopses, runtimes or air dates, and episodes sit in a horizontal row. Verified (shot: season)
P5 Episode page The episode page is a dead end. It has no link to its show or season and no list of neighbouring episodes. Verified (shot: epdetail)
P6 Search Results aren't grouped or ranked by type. "silo" returned 32 results, mostly Silo episodes in server order. There are no Movies/Shows/Episodes groups and no actor results. Verified (shot: search4)
P7 Skip intro Skip intro/credits takes several presses. OK while it's showing reveals the controls instead of skipping. Reaching the button takes Up→timeline→Up, and there's no auto-skip option. Code + repro_runtime.py credits key path
P8 Settings The Connection page says "Sign in with Plex" while already signed in. "Switch account" would be clearer. It also doesn't show the server address or connection type (local/remote/relay). Verified (shot: settings)
P9 Navigation Back from Search or Settings always goes to Home, not the tab you came from. Verified
P10 Details "Resume · 15 min" reads like "15 minutes left". "Resume from 15:02" or "13 min left" would be unambiguous. Verified (shot: epdetail)
P11 Details The media line is thin. It shows "4K · AV1 · EAC3", with no HDR/Dolby Vision, channel layout (5.1/Atmos), file size or bitrate. Verified (shot: mdetail)
P12 Player The player shows no clock or "Ends at" time. The episode name is in very small (10 sp) text. Verified (shot: play3)
P13 Player The Options menu repeats the Audio and Subtitles buttons, and speed reads "1.0×". Verified (shot: opts)
P14 Browse Partly watched movies show no progress bar on poster cards. BrowseCard draws progress only for landscape cards. Code
P15 Browse Hub rows can't be expanded. They're capped at 18 items (count=18) and have no "View all". Code

4. Missing features compared with the official Plex Android TV app

Music is excluded, since it's deliberately left out. Items marked † may also be intentional omissions; I've listed them so you can decide.

Browsing and library

  • An A–Z jump bar or letter picker. 272 TV titles and the movie library page in 100 at a time with no shortcut.
  • Collections and playlists. PlexApi.collections() exists but nothing calls it. There are no collection or playlist tabs.
  • Richer filters and sorts: year/decade, resolution, content rating, critic rating, last viewed, date added (oldest first).
  • (Added in 0.2.0) Card context actions (long-press / Menu): Mark watched, Remove from Continue Watching, Go to show/season.
  • (Added in 0.2.0) Extras and trailers. details() requests includeExtras=1, but nothing displays them, and there's no Trailer button.
  • Director, writer and studio credits on detail pages.
  • Theme music on show pages.†
  • Photo libraries. sections() filters to movie/show only.†
  • Watchlist and Plex's online "Discover" content, Live TV/DVR.†

Playback

  • (Added in 0.2.0) A version picker for multiple media versions (see M3).
  • Choosing audio and subtitles before playback, on the details page.
  • Refresh-rate and resolution matching. Nothing sets the frame-rate strategy or display mode; Media3's default only switches when the change is seamless. This onn exposes a single 4K59.94 mode, so it couldn't be tested here.
  • (Size and style added in 0.2.0) Subtitle appearance (size, colour, background, position) and subtitle sync offset; audio boost and night mode.
  • Preferences for default audio/subtitle language and automatic subtitle selection.
  • (Added in 0.2.0) Autoplay-next on/off and countdown length. The post-play countdown is fixed at 5 seconds and can only be cancelled each time.
  • (Added in 0.2.0) Auto-skip intros and credits.
  • (Added in 0.2.0) A separate quality limit for remote connections (see F12).

Accounts and the platform

  • Plex Home / managed-user switching, with PIN entry.
  • (Voice and system search added in 0.2.0) Android TV home integration: Watch Next / Continue Watching channel, recommendation channels, and voice or global search (SEARCH intent). The manifest has only the launcher intent.
  • Deep links into titles (from other apps or the system search).

5. Areas that held up well

  • Hero, Continue Watching, Movies/TV Discover and the A–Z grid rendered correctly with stable card bounds, and focus came back correctly from details pages.
  • Direct-play H.264/EAC3 started quickly. Resume position, timeline sync, ±10 s taps, and the subtitle, audio, options and chapter panels all opened and closed with Back as expected.
  • Mark watched/unwatched, cast → actor pages, related titles, the Synopsis dialog, the update flow, and settings categories behaved as designed.
  • The updater checks the host and checksum and compares signing certificates, and the session is encrypted with Android Keystore.

6. Suggested priority

  1. M1 (Search unreachable), M2 (Back exits), F6/P3/P4 (missing show names), F1–F3 (player menus).
  2. M4 (reconnect), M3 (versions/parts), F7 (multiple libraries), F8 (movie end), P1 (focus visibility).
  3. Missing features, starting with an A–Z jump bar, card context actions, Watch Next integration, collections, and subtitle/autoplay preferences.
  4. Add a Search step to verify_ui.py browse, since nothing currently exercises it.