Release Kaleido 0.1.8 with cast browsing and refreshed title pages
All checks were successful
Validate and publish Kaleido / android (push) Successful in 2m8s
|
|
@ -10,7 +10,11 @@ The interface gives artwork priority. App chrome uses neutral near-black, charco
|
|||
- Library: title and discovery/full-library navigation share a 64 dp header. A 43 dp filter row sits immediately above the six-column poster grid.
|
||||
- Browsing card widths: landscape 214 dp, TV episodes 264 dp, posters 120 dp. Landscape artwork uses 16:9; posters use 2:3. The full grid scales six columns to available width. Captions reserve a fixed height.
|
||||
- Search uses three columns of landscape results. Episodes use their actual stills, preserving their native proportions instead of cropping them into posters.
|
||||
- Features use original Plex clear-logo artwork within 264 × 80 dp, falling back to title text. Detail title: 34/37 sp. Library title: 29/34 sp. Discovery rail heading: 17/22 sp. Supporting information: 10/14 sp.
|
||||
- Movie and episode information pages place a horizontal Cast row beneath the description and actions, using Plex portraits, names and character roles. TV show pages place Seasons first, then Cast, then server-provided Related shows; season pages likewise keep Episodes ahead of Cast. Missing portraits use a neutral person placeholder. Actor cards open a six-column filmography of available movies and shows across the connected server's libraries, using Plex actor identifiers and pagination.
|
||||
- TV show information uses a full-screen backdrop behind a fitted 128 × 192 dp poster and a top-aligned text block. The Back control stays in the safe area; focus only scrolls controls that are out of view. A dark backdrop fade and soft text shadows preserve contrast for descriptions, metadata and audience ratings.
|
||||
- Movie, episode, show and season information pages expose labelled Mark watched / Mark unwatched actions. Changes are sent to Plex and reflected in the title, descendant episodes/seasons, library cards, actor results and recommendations. An in-flight write survives navigation and prevents duplicate submissions. Partial episode-list records update watch fields without replacing full cast/detail metadata.
|
||||
- Settings uses a fixed category rail (Connection, Playback, Interface, Updates) beside compact value/action rows. Focus selects categories; Right enters their controls and Left returns to the rail. Neutral surfaces, white focus, existing typography and restrained motion match the browsing destinations. Existing account, quality, watched-threshold, navigation-sound and updater preferences keep their behavior.
|
||||
- Features use original Plex clear-logo artwork within 264 × 80 dp, falling back to title text. Detail title: 32/36 sp. Library title: 29/34 sp. Discovery rail heading: 17/22 sp. Supporting information: 10/14 sp.
|
||||
- Poster and thumbnail corners: 6 dp. Compact action corners: 5 dp. Cards have no idle border; a compact bottom-right check marks watched titles, or a number shows remaining episodes for a show/season when Plex provides counts. Unwatched movies have no badge. Resumed movies/episodes only show a check after the configured playback threshold (80 percent by default), even if Plex retains a historical watched flag. Completed titles with no resume position retain Plex's watched state. Progress uses a two-dp inset line.
|
||||
- The abstract six-facet aperture mark is shared by the header, sign-in, app icon, TV banner, and the cold-start aperture sequence. It uses muted sea-glass and warm ivory facets around a dark center, with no letterform or sparkle. The launcher banner and app icon place it on a diagonal light, deep sea-glass at the top right through near-black to a warm tan glow at the bottom left, with a soft vignette and nothing over the aperture; `scripts/generate_brand_tiles.py` regenerates both from `brand_mark.xml`.
|
||||
- Audience ratings display Rotten Tomatoes as a percentage beside its official Popcornmeter artwork, and IMDb on its native ten-point scale beside the gold IMDb logo. Both appear when Plex exposes both; TVDB is retained as a fallback when neither is available. Critic scores and unsupported providers are omitted. Stable preview focus hydrates detail metadata, where Plex exposes the full provider list. The official red Hot mark appears at 60 percent or above and the green Stale mark below 60 percent; each fits a stable, font-scaled square without recoloring or distortion. Verified Hot is not inferred from a percentage. Asset provenance is in [brand-assets.md](brand-assets.md). The IMDb vector uses the official gold primary mark and supplied clear space from the [IMDb brand toolkit](https://brand.imdb.com/imdb).
|
||||
|
|
|
|||
43
docs/development.md
Normal file
|
|
@ -0,0 +1,43 @@
|
|||
# Kaleido development
|
||||
|
||||
Build setup, release packaging and implementation notes. For app features and installation, see the [README](../README.md).
|
||||
|
||||
## Build on Windows
|
||||
|
||||
1. Run `scripts/bootstrap.py` with Python 3 to download an isolated JDK 17, Gradle 8.13, and Android command-line tools under `.tools/`.
|
||||
2. Set `JAVA_HOME` to the extracted JDK directory and run `.tools/sdk/cmdline-tools/latest/bin/sdkmanager.bat --sdk_root=<absolute .tools/sdk path> "platforms;android-36" "build-tools;35.0.0"`. Accept the SDK license when prompted.
|
||||
3. Run `./Build.ps1 -Test` for the debug APK, unit tests, and lint. Run `./Build.ps1 -Release` for the optimized release APK.
|
||||
|
||||
Open the project root in Android Studio to use an existing local Android SDK instead. Set `ANDROID_HOME` and use the bundled Gradle distribution or the wrapper.
|
||||
|
||||
The first local build creates `.tools/kaleido-signing.jks`. **Keep a private backup of this file and its credentials. Every app update must use the same signing key.** Debug and release builds share this local key so the test installation can receive the release through the updater. CI uses an ephemeral validation key and publishes only the locally signed distribution APK. For alternate signing, set `KALEIDO_KEYSTORE`, `KALEIDO_STORE_PASSWORD`, `KALEIDO_KEY_ALIAS`, and `KALEIDO_KEY_PASSWORD`.
|
||||
|
||||
## Connect
|
||||
|
||||
Open Kaleido and enter its code at [plex.tv/link](https://plex.tv/link). Settings → Sign in with Plex can link an account while keeping the current connection until successful server selection; Back cancels linking. Choose a server if more than one is available. The client tests the discovered server connections and prefers TLS. A manual server URL / token connection is also available. The credentials are AES-GCM encrypted with an Android Keystore key, never backed up, and removed on sign-out. Local HTTP servers remain supported. Account tokens are sent only to Plex account endpoints; server tokens are sent to the selected Plex server.
|
||||
|
||||
`.env` and signing keys are ignored by Git. No test credentials are included in source code, BuildConfig, resources, or APKs. `scripts/device.py seed` is an optional debug-only provisioning helper: it sends `.env` credentials to private app data over the already-authorized ADB connection. Kaleido immediately encrypts them and deletes the staging file. Release builds never read this staging file.
|
||||
|
||||
## Remote and playback
|
||||
|
||||
D-pad moves focus, OK activates, and Back returns through details and seasons. In the player, OK shows controls; Left/Right while controls are hidden seeks; dedicated media keys control playback. The on-screen controls provide pause, seeking, audio, subtitles, next episode, and exit. Back first hides controls, then exits playback. Stopping or leaving the app reports the latest position to Plex.
|
||||
|
||||
Original quality is the default, requesting the source video and remuxing where supported, with a 1080p conversion fallback. The player gear exposes the same quality preference as Settings, along with audio, subtitles, speed and chapters. Media3's SurfaceView preserves supported HDR. Actual HDR, Dolby Vision, codecs, and audio passthrough depend on the device, connected display/receiver, source profile, and server. Plex owns transcoding capability and any account entitlements. Unsupported subtitle formats use server conversion. Intro and credit buttons appear when the server supplies markers. Scrubbing displays server-generated video previews or chapter thumbnails when available; the timeline also shows buffered progress. Episode endings and Skip credits show a cancellable five-second next-episode countdown, season episodes, and related shows.
|
||||
|
||||
## Updates and releases
|
||||
|
||||
Kaleido checks [the public repository releases](https://git.elijahkuntz.com/Elijah/Kaleido/releases) on launch and foreground entry, at most once per six hours. Settings offers an immediate check. It downloads the release APK over HTTPS, checks its supplied SHA-256 when available, and verifies the package name, increasing Android version code, and installed signing certificate before opening Android's package installer. Android requires a one-time “allow from this source” permission and confirmation for each installation.
|
||||
|
||||
To publish a version:
|
||||
|
||||
1. Increment **both** fields in `version.properties` and update `CHANGELOG.md`.
|
||||
2. Run `./Build.ps1 -Release -Test`, then `python scripts/package_release.py`.
|
||||
3. Commit the source and `distribution/`, push `main`, and push the matching `v<versionName>` tag.
|
||||
|
||||
The Forgejo workflow builds, tests, and lints the source, verifies the prebuilt signed distribution, then publishes its APK and checksum using Forgejo's repository-scoped token. The private production signing key never leaves the developer machine. The checked-in APK also provides a repository-file update channel, with an immutable tag URL in `distribution/latest.json`, for installations before the first Forgejo release is ready.
|
||||
|
||||
## Structure and references
|
||||
|
||||
`PlexApi.kt` owns Plex transport and server-relative API calls; `SecureSession.kt` owns credential encryption; `KaleidoViewModel.kt` owns navigation and async screen data; `Screens.kt` and `Theme.kt` implement the TV UI; `Playback.kt` owns Media3, stream negotiation, track selection, lifecycle, and timeline reporting; `AppUpdater.kt` verifies updates. Artwork has bounded memory and disk caches. Library data is paged in batches of 100.
|
||||
|
||||
Implementation follows the [official Plex Media Server API](https://developer.plex.tv/pms/), [Android Compose guidance](https://developer.android.com/compose), and [Media3 documentation](https://developer.android.com/media/media3). This is an independent client, unaffiliated with Plex. No existing Plex client source is copied.
|
||||
|
|
@ -118,3 +118,15 @@ Verified on the Fire Stick with a build labelled 0.1.3 against published 0.1.4:
|
|||
Playback mode and transcode quality are now one `StreamQuality` preference: Original quality (direct stream of the source video, falling back to a 1080p conversion) and 4K/1080p/720p/480p conversions, in Settings and the player gear. Earlier `playbackModeV2`/`quality` preferences migrate on first read. With the controls hidden, a Left/Right tap now only moves a pending seek (350 ms settle, so quick taps add up); a key repeat reveals the controls with the timeline focused. Play's initial focus no longer takes focus back after a timeline reveal.
|
||||
|
||||
On the onn, `verify_ui.py player` passed all seven checks, including two new ones: a Right tap skipped at least 9 s (projected from the Android media-session position) with no controls, and `input keyevent --longpress 22` revealed the focused timeline. `repro_runtime.py controls` passed. While video plays with controls visible, their clock updates keep `uiautomator` from dumping and it silently returns the previous hierarchy; the player checks now wait for the `READY` log line before pausing and inspect the screen while paused. A focus-loss theory based on those stale dumps was ruled out with a temporary focus log.
|
||||
|
||||
## Title information, cast and Settings - 2026-10-25
|
||||
|
||||
Cast cards use real Plex Role portraits, names, roles and server-local actor identifiers. Selecting an actor queries every accessible movie/show section with pagination. Series information keeps Seasons ahead of Cast and Plex's related-show hubs. The labelled watched actions use Plex scrobble/unscrobble, refresh descendants and preserve full metadata when merging summary records. Writes survive navigation and repeated submissions are ignored until the refresh completes.
|
||||
|
||||
`verify_details.py` passed on the optimized release on the onn: movie watched/unwatched persisted in Plex; John Cena's 13 titles matched results from both libraries; actor/title/cast return focus restored; marking the eight-episode series updated every episode; related shows opened and returned to the selected card. The harness validated initially unwatched, zero-resume fixtures (Matchbox `36486`, 3 Body Problem `16413`), then restored and rechecked both. It did not play content or alter existing resume points.
|
||||
|
||||
The TV show header initially moved its title to y=21 px when Compose's default TV bring-into-view pinned the focused action higher on screen. `verify_details_layout.py` reproduced that failure. The revised header uses a full-screen backdrop, fitted poster and top-aligned information; scrolling only reveals controls outside the viewport. The regression check passed with title bounds `[392,136,849,212]`, Back visible and Seasons first. Text shadows and a dark fade improve description/rating contrast; filled action buttons retain crisp text without that shadow.
|
||||
|
||||
Settings now uses Connection / Playback / Interface / Updates categories. The underlying account, preferences and signed-updater behavior are preserved. Raw captures and server-specific verification results remain in ignored `evidence/private/`; the README gallery contains reviewed screenshots from the release build.
|
||||
|
||||
Final 0.1.8 verification: `Build.ps1 -Release -Test` passed; `verify_settings.py` passed category focus, Original quality / 80% dialog cancellation, live update checking and sign-out cancellation. `verify_navigation_sounds.py` passed Off and On persistence across cold starts, leaving sounds On. All six `verify_ui.py browse` checks passed, including real Plex PIN cancellation. The final signed APK (version code 9) was installed in place and profile compiled; the encrypted session and playback preferences were retained. The app was returned to Home. The release gallery includes nine new 1920 × 1080 captures, encoded as lossless WebP and checked for pixel equality with their source PNGs.
|
||||
|
|
|
|||
BIN
docs/screenshots/actors.webp
Normal file
|
After Width: | Height: | Size: 1.4 MiB |
|
Before Width: | Height: | Size: 1.1 MiB After Width: | Height: | Size: 1 MiB |
|
Before Width: | Height: | Size: 1.2 MiB After Width: | Height: | Size: 1.1 MiB |
BIN
docs/screenshots/related.webp
Normal file
|
After Width: | Height: | Size: 1.4 MiB |
BIN
docs/screenshots/settings.webp
Normal file
|
After Width: | Height: | Size: 24 KiB |
BIN
docs/screenshots/show.webp
Normal file
|
After Width: | Height: | Size: 1.1 MiB |