Tauri 2 shell with a React/TypeScript interface and libmpv playback composed beneath the web view (DirectComposition on Windows). Shared code with per-OS platform modules and configs so macOS and Linux can follow. - Plex sign-in (browser, plex.tv/link or manual), server selection, Plex Home - Home, Movies and TV Shows (Discover, Library, Collections), search, people - Title pages with logos, ratings, cast, extras, seasons and episodes - Direct play with Plex conversion fallback, tracks, markers, autoplay - Metadata editing, artwork, fix match, refresh, analyze and deletion - Resumable offline downloads - App settings and Plex server administration with a live dashboard - Signed updater feed and Forgejo CI Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1.4 KiB
1.4 KiB
Kaleido Desktop
Working rules
- This is a real desktop Plex client (Tauri 2 + React/TypeScript + libmpv), sibling of the Android TV app at git.elijahkuntz.com/Elijah/Kaleido. Preserve working Plex functionality; never substitute mock content or prototype playback.
- Design for mouse and keyboard first. Keep Kaleido's artwork-led look (clear logos, backdrop fading into the page, UltraBlur colour wash, neutral near-black chrome) but don't port remote-control patterns that feel wrong with a pointer.
- Keep the interface restrained: no redundant buttons or navigation.
.env(PLEX_SERVER_URL,PLEX_TOKEN) is for local testing only. Never print, commit or embed credentials..tools/updater.keysigns updates; never commit or replace it.- Shared code goes in
src/andsrc-tauri/src/; anything OS-specific goes insrc-tauri/src/platform/<os>.rsortauri.<os>.conf.json.
Testing
npm run typecheck,npm test,cargo check --manifest-path src-tauri/Cargo.toml.- UI:
npm run devand a browser at http://localhost:1420 (signs in from.env). - Native:
npm run tauri devwithWEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--remote-debugging-port=9333;window.__kaleidoexposes the stores in development. - Mute before playback tests (
__kaleido.useSettings.getState().set('volume', 0)). Playback changes real Plex progress and track selections; restore them.
See docs/architecture.md and docs/development.md.