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