Work already pending in the tree before the bug-fix pass, committed on its own: - Remove Volume boost (it degraded audio) and its setting; keep passthrough. - Leave playback with the server's reason when Plex stops a session (timeline terminationCode/terminationText); never fall back or reconnect after. - Genre filtering lives in Categories; the Library grid lists the whole section. - Update UI verification scripts and AGENTS.md accordingly. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
80 lines
5.9 KiB
Markdown
80 lines
5.9 KiB
Markdown
# Kaleido
|
||
|
||
A Plex client for Android TV, designed for browsing from the couch. Kaleido puts your movies, shows and next episodes up front, with large artwork and controls that work with a remote.
|
||
|
||
**[Download the latest release](https://git.elijahkuntz.com/Elijah/Kaleido/releases/latest)** · Android TV 9 or newer · Requires a Plex Media Server
|
||
|
||
## What's in the app
|
||
|
||
### Find something to watch
|
||
|
||
- **Home** brings together featured titles, Plex recommendations and Continue Watching. Resume a movie or get back to your current series without digging through your library.
|
||
- **Movies** starts with recent releases and recommendations. **TV Shows** leads with your next episodes, new seasons and newly added episodes.
|
||
- **Library** gives you an A–Z poster grid with watched-status and sorting controls; **Categories** browses by genre. If you have more than one movie or TV library, choose which one each section shows.
|
||
- **Search** finds movies, shows, episodes and people across your libraries. Type with the remote or search by voice.
|
||
- **Title pages** include ratings, a synopsis, trailers and extras, and cast portraits with character names. Select an actor to see their available movies and shows. Series pages put seasons first. Season and episode pages show the episode you move to in the season row; select it, or Play, to watch.
|
||
- **Quick actions**: hold OK (or press Menu) on any title to play, start over, mark it watched, remove it from Continue Watching, or jump to its season or show.
|
||
|
||
### Watch the way you want
|
||
|
||
Original quality plays the source video where your TV supports it. You can also ask Plex to convert to 4K, 1080p, 720p or 480p, with a separate limit for remote connections away from home. Titles with several versions let you pick one.
|
||
|
||
Choose audio tracks, subtitles, playback speed and chapters from the player. Tap Left or Right to skip ten seconds, or hold to scrub through the timeline with thumbnail previews. Skip intros and credits with a button or automatically, and let the next episode start after a countdown you choose. Subtitle size and style are adjustable. Previews and skip markers appear when Plex supplies them; HDR and format support depend on your TV and server.
|
||
|
||
### Keep your place
|
||
|
||
Playback progress and watched status sync with Plex, so your place carries across clients. Mark a movie, episode, season or whole show watched or unwatched from its page or its quick actions. You can set the playback percentage that counts as watched, too.
|
||
|
||
Settings groups connection, playback, subtitles, interface and updates in one place. Navigation tap sounds can be turned on or off. The built-in updater checks for releases and downloads new versions without another manual sideload.
|
||
|
||
## Install
|
||
|
||
1. Download **Kaleido.apk** from the [latest release](https://git.elijahkuntz.com/Elijah/Kaleido/releases/latest) and install it on your Android TV.
|
||
2. Open Kaleido and enter the code at [plex.tv/link](https://plex.tv/link).
|
||
3. Choose your Plex server and start browsing.
|
||
|
||
A manual server URL and token connection is also available. For future updates, use **Settings → Updates**. Android will ask you to confirm the installation.
|
||
|
||
## Screenshots
|
||
|
||
Captured from Kaleido **0.6.0** running on Android TV with a live Plex library. Select a screenshot to view it at full resolution.
|
||
|
||
**Home** — a cinematic feature with playback actions and integrated Continue Watching.
|
||
|
||
[](docs/screenshots/home.webp)
|
||
|
||
Moving into the rows compacts the feature into a preview of the focused card, with its artwork, ratings, cast and formats.
|
||
|
||
[](docs/screenshots/home-rows.webp)
|
||
|
||
| Movie discovery | TV discovery |
|
||
| --- | --- |
|
||
| [](docs/screenshots/movies.webp) | [](docs/screenshots/tv.webp) |
|
||
|
||
| Movie information and cast | TV show information and seasons |
|
||
| --- | --- |
|
||
| [](docs/screenshots/details.webp) | [](docs/screenshots/show.webp) |
|
||
|
||
| Season episodes | Cast and related shows |
|
||
| --- | --- |
|
||
| [](docs/screenshots/season.webp) | [](docs/screenshots/related.webp) |
|
||
|
||
| A–Z library | Categories |
|
||
| --- | --- |
|
||
| [](docs/screenshots/library.webp) | [](docs/screenshots/categories.webp) |
|
||
|
||
| Actor filmography | Settings |
|
||
| --- | --- |
|
||
| [](docs/screenshots/actors.webp) | [](docs/screenshots/settings.webp) |
|
||
|
||
## Build from source
|
||
|
||
Kaleido is written in Kotlin with Jetpack Compose and Media3. On Windows, the local toolchain can be set up with `scripts/bootstrap.py`, then built with:
|
||
|
||
```powershell
|
||
.\Build.ps1 -Release -Test
|
||
```
|
||
|
||
See the [development guide](docs/development.md) for setup and releases, the [design notes](docs/design-system.md), and [device testing](docs/runtime-verification.md).
|
||
|
||
Kaleido is in active development. It is an independent project and is not affiliated with Plex.
|