diff --git a/.forgejo/workflows/build-installers.yml b/.forgejo/workflows/build-installers.yml index 135517d..2c8d973 100644 --- a/.forgejo/workflows/build-installers.yml +++ b/.forgejo/workflows/build-installers.yml @@ -1,8 +1,8 @@ name: Build Kaleido Desktop installers # Started by hand (Actions, then this workflow, then Run). Each platform needs a runner # with its label; without one the job would wait indefinitely, so this never runs on -# push. Releases can instead be built with scripts/build.ps1 (Windows) or -# scripts/build.sh (macOS) and published with scripts/publish-release.mjs. +# push. Releases can instead be built with scripts/build.ps1 and published with +# scripts/publish-release.mjs. on: workflow_dispatch: @@ -29,14 +29,11 @@ jobs: TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }} TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }} run: ./scripts/build.ps1 - - name: Build (macOS) - if: matrix.os == 'macos' + - name: Build (macOS / Linux) + if: matrix.os != 'windows' env: TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }} TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }} - run: sh scripts/build.sh - - name: Build (Linux) - if: matrix.os == 'linux' run: | sh scripts/fetch-libmpv.sh npm ci diff --git a/.gitignore b/.gitignore index 4b74645..71072a7 100644 --- a/.gitignore +++ b/.gitignore @@ -10,6 +10,5 @@ vendor/mpv/*/ .env .env.* evidence/ -.DS_Store *.log .claude/ diff --git a/AGENTS.md b/AGENTS.md index cf3a139..0ebe3a8 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -11,7 +11,7 @@ - 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.key` signs updates; never commit or - replace it. `.tools/macos-signing.*` backs up the macOS signing certificate; same rules. + replace it. - Shared code goes in `src/` and `src-tauri/src/`; anything OS-specific goes in `src-tauri/src/platform/.rs` or `tauri..conf.json`. @@ -19,20 +19,19 @@ - `npm run typecheck`, `npm test`, `cargo check --manifest-path src-tauri/Cargo.toml`. - UI: `npm run dev` and a browser at http://localhost:1420 (signs in from `.env`). -- Native: `npm run tauri dev` (on Windows with `WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--remote-debugging-port=9333`); - `window.__kaleido` exposes the stores in development. On macOS the Rust toolchain is - Homebrew's keg-only `rustup` (`export PATH=/opt/homebrew/opt/rustup/bin:$PATH`). +- Native: `npm run tauri dev` with `WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--remote-debugging-port=9333`; + `window.__kaleido` exposes the stores in development. - Mute before playback tests (`__kaleido.useSettings.getState().set('volume', 0)`). Playback changes real Plex progress and track selections; restore them. ## Releases -Built and published locally, Windows and macOS each on their own machine, into one -release (CI only validates). In short: bump the version in `package.json`, -`src-tauri/Cargo.toml`, `src-tauri/tauri.conf.json` (+ lockfile), add a `CHANGELOG.md` -section, commit + tag `vX.Y.Z` + push; on each OS build (`.\scripts\build.ps1` / -`sh scripts/build.sh`) and `node scripts/publish-release.mjs X.Y.Z [--prerelease]`; then -`node scripts/update-manifest.mjs X.Y.Z` and commit/push `updates/latest.json`. Full checklist: `docs/development.md` → Releases. Only push or +Built and published locally (CI only validates). In short: bump the version in +`package.json`, `src-tauri/Cargo.toml`, `src-tauri/tauri.conf.json` (+ lockfile), add a +`CHANGELOG.md` section, `.\scripts\build.ps1`, commit + tag `vX.Y.Z` + push, +`node scripts/publish-release.mjs X.Y.Z [--prerelease]`, then +`node scripts/update-manifest.mjs X.Y.Z ` and commit/push +`updates/latest.json`. Full checklist: `docs/development.md` → Releases. Only push or publish when the user asks. `FORGEJO_TOKEN` lives in the ignored `.env`. See `docs/architecture.md` and `docs/development.md`. diff --git a/CHANGELOG.md b/CHANGELOG.md index 89d5b1c..9cdd8c1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,145 +1,5 @@ # Changelog -## 1.0.1 - -A quicker start, a Stop button, and recovery when the server drops out mid-video. - -- Kaleido starts faster: the opening animation is shorter, so you reach your library in about a second. -- The player has a Stop button, next to the forward controls, which closes the player completely instead of moving it to the miniplayer. -- If your Plex server goes down while you're watching, the player waits for it once the buffered video runs out, then carries on from the same spot when the server is back. Before, it treated the video as finished and Play started it again from the beginning. Pressing Play while it waits tries to reconnect straight away. - -## 1.0.0 - -Kaleido is out of beta. This release reworks the show and season pages and smooths out watching a series. - -- Season pages show their episodes as a grid of cards, each with its still, description and watched state, in place of the long episode list. -- Click the season's name under the show's logo to switch to another season. -- Show pages list seasons once, as a row of posters. A show with only one season shows its episodes directly. -- Episodes you've watched stay marked as watched when you rewatch them and stop partway through. The leftover position only shows on the episode you're up to. -- When the next episode plays, whether automatically or with Next, it starts from the beginning instead of near the end of an earlier viewing. -- Click a show's name under a Continue Watching card to go to the show. -- Continue Watching starts at the first title when something new is added, instead of scrolling it off the left edge. -- Season posters outside their show's page, such as New Seasons, are labelled with the show's name. -- Season pages show the year the season aired, and their Play button agrees with the show page about which episode is next. -- Movie and episode pages show the runtime in their details, with the time left on the Resume button. - -## 0.1.0-beta.19 - -Up Next fixes. - -- Up Next now opens every time the credits start: going back to the credits and seeking into the episode brings it back when they come round again, and it always opens when an episode reaches the end. -- The back arrow and a full-screen button are back at the top of Up Next, so you can return to browsing (playback continues in the miniplayer) or leave full screen. -- Click the show's logo to go to its page, with playback moving to the miniplayer. -- The Play next episode countdown fills smoothly. -- The episode rows are sized to fill the screen instead of leaving a gap at the bottom. -- The backdrop now shows the next episode, and its description is easier to read over bright artwork. - -## 0.1.0-beta.18 - -A rebuilt Up Next screen that looks and works like the rest of Kaleido. - -- Up Next now uses the same artwork backdrop, colour wash, buttons and cards as the title pages. The credits keep playing in the top-left corner beside the next episode, and the Play next episode button fills as the countdown runs. -- The Season and Related shows rows scroll with the side arrows, like every other row, instead of scrollbars. The season row starts at the episode you just watched. -- Click the video or press Esc to go back to the credits; at the end of an episode this no longer restarts it from the beginning. -- Up Next fits smaller windows, and the window buttons stay visible on Mac while it's open. -- Playback settings are a simple list again: Skip intros, Skip movie credits, Automatic skip delay and Autoplay next episode. - -## 0.1.0-beta.17 - -- Fix the Up Next countdown stalling when the native video has keyboard focus instead of the webview. Count elapsed time accurately through delayed timer callbacks, and keep the countdown independent of the video's pause state, as on Android TV. -- Open Up Next at the first episode credit marker, including after seeking into credits, independently of movie-credit skip preferences. Open the screen immediately while episode context loads, and start autoplay once the next episode is known. Without markers, use the end of the episode as a fallback. -- Cancel autoplay on mouse movement, clicks, scrolling or keypresses. A stationary pointer does not cancel it; cancelled autoplay stays cancelled when delayed metadata arrives. -- Match the Android TV screen more closely: remove the extra toolbar actions, Cancel autoplay button and autoplay-status text; show only a white video outline on hover or keyboard focus. Use compact episode metadata, full runtime, landscape related shows and captions beneath the artwork. - -## 0.1.0-beta.16 - -- Simplify playback settings: group intro, credits and skip-delay choices together, show the delay only when automatic skipping is enabled, and combine the next-episode switch and countdown into one Off / After … seconds selection. Existing preferences are preserved. -- Make Up Next readable over bright artwork with a dark backdrop across the page, brighter secondary text and larger synopsis and autoplay hints. The playing video stays at its original brightness. - -## 0.1.0-beta.15 - -A new Up Next screen, adapted from Kaleido for Android TV for mouse and keyboard. - -- Replace the corner countdown with a full Up Next screen. Credits keep playing in the top-left corner beside the next episode’s artwork, title, rating and synopsis, with the season and related shows below. The Play next episode button fills during the single countdown. -- Click the video or Return to video, or press Esc, to return to the credits. Click Play next episode to start immediately, choose any season episode, or open a related show. Tab and Shift+Tab move between controls with visible keyboard focus. -- Click, scroll or press any key to cancel autoplay while keeping Up Next open. Moving the mouse alone leaves the countdown running. The timer pauses while Kaleido is hidden, unfocused or paused, and never restarts after cancellation or returning to the credits. -- Respect the credits preference: Skip automatically opens Up Next as episode credits begin; Show button opens it when clicked; Off waits for the episode to end. Episode credits use only the Up Next countdown, independent of the intro/movie skip delay. A series finale shows More to watch without autoplay. - -## 0.1.0-beta.14 - -Full screen stays on with the miniplayer, a smoother colour wash, and a round of playback and download fixes. - -- Going back from the full-screen player to the miniplayer now keeps Kaleido in full screen, so you can browse full screen while the video plays in the corner. Press Esc to go back to a window, or on Windows use the new Exit full screen button beside the window controls. Closing the miniplayer leaves the window as it is. -- The colour wash behind the featured titles and title pages now blends into the next title's colours instead of jumping when the artwork changes. Clicking quickly through featured titles no longer blanks the background for a moment. -- Playback stays with the server it started on: progress and watched marks never go to a server you switch to later, and switching account, profile or server ends playback from the old one. Downloads report only to their own server. -- When Plex converts a video, the audio and subtitle tracks you chose (and your language preferences) are now applied, and kept when you change quality. -- Watching a download offline now saves where you stopped and marks it watched. -- Fixed: playing something offline could crash the player. -- Fixed: closing or switching titles while a video was still starting could start it anyway. -- Fixed: Home and the libraries could still show the previous account's or profile's titles after switching. -- Fixed: titles split into several files were downloaded only in part; Kaleido now picks a single-file version, or says it can't download the title. -- Fixed: episodes downloaded into the same season folder could overwrite or delete each other's artwork, and pause or remove could stop working after a download restarted. -- Library grids refresh fully when something changes, slow server responses time out properly, and the featured titles start rotating again when you scroll back to them. - -## 0.1.0-beta.13 - -A gentler automatic intro skip, and home screens that keep up with your other Plex apps. - -- "Skip automatically" for intros (and credits) now waits a moment first: the Skip button reads "Skipping intro" and fills as it counts down, then skips. Pause, seek or press any key before then to keep watching; the button stays as a regular Skip intro for the rest of the intro. Click it to skip straight away. -- Choose how long it waits in Settings → Playback → Automatic skip delay (3, 5 or 10 seconds, or straight away as before). It's 5 seconds by default. -- Jumping into the middle of an intro yourself no longer skips it automatically. -- Fixed: Continue Watching, a show's next episode, and watched marks didn't update after watching something on another device (a TV, a phone) while Kaleido stayed open. They now refresh when you switch back to Kaleido, and Continue Watching also refreshes every minute while it's on screen. - -## 0.1.0-beta.12 - -A smoother miniplayer on Windows. - -- The miniplayer is now a small window of its own, so dragging it moves the video and its controls together: the video keeps playing smoothly as you move it, with no flicker around its edges. -- Letting go snaps it to the nearest corner of the window, or the corner you flick it towards, and it remembers that corner. It stays in place as the window moves or resizes. -- Using its buttons no longer takes focus from the main window, so keyboard shortcuts keep working. -- On Mac the miniplayer is unchanged for now. - -## 0.1.0-beta.11 - -Fixes the app freezing when leaving full screen for the miniplayer, and adds local hang and crash reports. - -- Fixed: going back from the full-screen player to the miniplayer (or moving or resizing the miniplayer) could freeze the window — it turned see-through and "Not Responding" while the video kept playing. Two parts of the player were each waiting for the other when the window resized at the wrong moment. -- When the window stops responding for 5 seconds, or the app crashes, Kaleido now saves a report of what each part of the app was doing in its log folder (`%LOCALAPPDATA%\tv.kaleido.desktop\logs`), so a rare problem can be traced the first time it happens. Reports stay on your computer. - -## 0.1.0-beta.10 - -A redesigned player control bar, previous episode, and a movable miniplayer. - -- The player's controls are rearranged the way most media players lay them out: play/pause sits in the centre under the timeline, with 10-second skips either side and previous/next episode beyond those. Volume and the time are on the left; subtitles, settings and full screen stay on the right. -- New previous-episode button (and Shift+P) to go back an episode. For episodes both buttons always show, dimmed at the start or end of a show, so play/pause stays put. -- The miniplayer can be dragged anywhere in the window. It stays inside the window when it's resized, and remembers where you left it. -- Fixed: the Play now and Cancel buttons on the next-episode card during the credits couldn't be clicked (the player's title row covered them). The Skip intro/credits button had the same problem with tall show logos. -- Fixed: clicking Skip intro or Skip credits also paused the video. -- The featured titles at the top of Home, Movies and TV Shows no longer carry a "Highly rated" / "Recommended" label, and their logo has room above the details line instead of touching it. - -## 0.1.0-beta.9 - -Fixes for the Mac version. - -- Regular (SDR) video no longer looks washed out on Mac; HDR was unaffected. -- Downloaded titles show their artwork again on Mac. - -## 0.1.0-beta.8 - -Kaleido for Mac. - -- Kaleido now runs on Macs with Apple silicon (macOS 26 or later), with the same interface and features as on Windows: browsing, playback with hardware decoding, the miniplayer, downloads, server management and in-app updates. The window uses the Mac's own close, minimize and zoom buttons, which fade with the player's controls, and shortcuts use ⌘ (⌘K to search, ⌘[ to go back, ⌃⌘F for full screen). -- HDR passthrough works on Mac too: HDR titles play in the display's extended dynamic range instead of being converted to SDR. -- Each release now includes both the Windows and Mac versions. -- Updates are signed with a new key, so the Windows version needs to be reinstalled once from this release; later updates install in the app as before. - -## 0.1.0-beta.7 - -A new startup animation and a bolder app icon. - -- New startup animation: a kaleidoscope of shards turns and gathers into the Kaleido mark, then the view flies through its centre into the app. If the server is slow to answer, small shards keep circling the mark instead of the animation freezing. -- The app icon's mark is much larger, so it reads clearly on the taskbar and in the Start menu. - ## 0.1.0-beta.6 RTX Video upscaling, stopped streams and a live bandwidth graph. diff --git a/README.md b/README.md index e0fcfb4..65ea395 100644 --- a/README.md +++ b/README.md @@ -4,10 +4,9 @@ A cinematic Plex client for the desktop, built in the same artwork-led style as [Kaleido for Android TV](https://git.elijahkuntz.com/Elijah/Kaleido), and designed for mouse and keyboard. -Kaleido runs on Windows and macOS (Apple silicon) with the same interface and features; -each release carries both, and installed copies update themselves. The interface and -nearly all of the native core are shared, and each platform's differences live in one -place (see [Architecture](docs/architecture.md)). Linux builds browse but don't play yet. +Windows is supported today. The repository is structured for Windows, macOS and Linux: +the interface and nearly all of the native core are shared, and each platform's +differences live in one place (see [Architecture](docs/architecture.md)). ## What's in the app @@ -62,20 +61,18 @@ place (see [Architecture](docs/architecture.md)). Linux builds browse but don't | Browsing | | Player | | | --- | --- | --- | --- | -| Ctrl+K (⌘K) | Search | Space / K | Play/pause | +| Ctrl+K | Search | Space / K | Play/pause | | Arrow keys | Move between titles | ← / → | Seek (Shift: 1 min) | | Enter / Space | Open / play | ↑ / ↓, wheel | Volume | | Menu or Shift+F10 | Title actions | F, double-click | Full screen | -| Alt+← (⌘[) / mouse back | Back | C | Next subtitle | -| / | Focus search | Shift+P / N | Previous / next episode | -| F11 (⌃⌘F) | Full screen | Esc | Exit full screen, then player | - -Keys in brackets are the macOS equivalents. +| Alt+← / mouse back | Back | C | Next subtitle | +| / | Focus search | Shift+N | Next episode | +| F11 | Full screen | Esc | Exit full screen, then player | ## Build from source -Requirements: Node 22+, Rust (stable); on Windows the Visual Studio C++ build tools and -7-Zip, on macOS the Xcode command line tools and Homebrew. +Requirements: Node 22+, Rust (stable), and on Windows the Visual Studio C++ build tools +and 7-Zip. ```powershell npm ci @@ -84,13 +81,6 @@ npm run tauri dev # development app .\scripts\build.ps1 # signed release installer (NSIS) ``` -```bash -npm ci -sh scripts/fetch-libmpv.sh # libmpv and its libraries into vendor/mpv/macos -npm run tauri dev # development app -sh scripts/build.sh # .app, .dmg and the signed update archive -``` - During development the app signs in automatically from an ignored `.env` in the repository root (`PLEX_SERVER_URL`, `PLEX_TOKEN`). Release builds never read it. `npm run dev` serves the interface alone in a browser for UI work (no playback or diff --git a/docs/architecture.md b/docs/architecture.md index bd36c49..bf61031 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -35,34 +35,21 @@ updates/latest.json Signed update feed for every platform `src-tauri/src/platform/mod.rs` selects one of `windows.rs`, `macos.rs` or `linux.rs`. Each exposes the same items: -| Item | Windows | macOS | -| --- | --- | --- | -| `VideoSurface` | mpv renders with `d3d11-output-mode=composition`; its swapchain (`display-swapchain`) is set as the content of a DirectComposition visual targeted at the window with `topmost = false`, i.e. behind the web view's child windows. For the miniplayer the visual is offset and mpv's composition size shrunk to a corner rectangle (`player_rect`). | mpv's render API (`vo=libmpv`, OpenGL) draws into a `CAOpenGLLayer` hosted by a view inserted beneath the WKWebView, whose background is turned off (`drawsBackground`). `start` creates the render context once mpv is initialized; a render thread redraws the layer whenever mpv reports a new frame. For the miniplayer the view is moved to the corner rectangle. | -| `MPV_LIBRARIES` | `libmpv-2.dll` | `libmpv.2.dylib` (in `Contents/Frameworks` with the libraries it links) | -| `hold_awake` | `SetThreadExecutionState` | an IOKit `PreventUserIdleDisplaySleep` assertion | -| Window buttons | drawn by the page (`WindowControls`) | the native traffic lights (`titleBarStyle: Overlay`, placed on the top bar's centre line); `set_window_buttons` hides them with the player's controls | -| `device_name` | `COMPUTERNAME` | the computer name from Sharing settings | +| Item | Windows implementation | +| --- | --- | +| `VideoSurface` | mpv renders with `d3d11-output-mode=composition`; its swapchain (`display-swapchain`) is set as the content of a DirectComposition visual targeted at the window with `topmost = false`, i.e. behind the web view's child windows. For the miniplayer the visual is offset and mpv's composition size shrunk to a corner rectangle (`player_rect`). | +| `MPV_LIBRARIES` | `libmpv-2.dll` | +| `hold_awake` | `SetThreadExecutionState` while video plays | -Linux provides stubs for `VideoSurface` (browsing, downloads, settings and updates -work; playback reports that it is unavailable); the macOS approach (render API beneath -the web view) applies there with an OpenGL surface under WebKitGTK. Per-OS bundling -(libmpv, targets, window style) lives in `tauri..conf.json`. Credentials use the -platform's keychain through the `keyring` crate with per-OS features in `Cargo.toml`; -macOS debug builds keep them in a private file instead, because each unsigned rebuild -would make the Keychain ask again. +macOS and Linux currently provide stubs for `VideoSurface` (browsing, downloads, +settings and updates work; playback reports that it is unavailable). To add playback +there, render through mpv's render API into a layer beneath the web view and implement +the same methods (`set_rect` places the video in part of the window for the miniplayer). Per-OS bundling (libmpv, targets, dependencies) lives in +`tauri.macos.conf.json` and `tauri.linux.conf.json`. Credentials use the platform's +keychain through the `keyring` crate with per-OS features in `Cargo.toml`. -The page background turns transparent only while video is visible -(`html.video-active`), so browsing is opaque. The page knows its OS synchronously -(`hostOS` in `platform/native.ts`, from the web view's user agent) and tags the root -element (`html.os-macos`) for the few styles that differ, such as room for the traffic -lights. - -HDR passthrough (`target-colorspace-hint`) works differently on each OS. On Windows mpv -switches its swapchain's colour space itself. On macOS the surface watches -`video-params/gamma`: for PQ or HLG video it has mpv output PQ in BT.2020 -(`target-trc`, `target-prim`) into the 16-bit float framebuffer and turns on the layer's -extended dynamic range with the BT.2100 PQ colour space, so macOS maps the picture -into the display's HDR headroom; SDR video returns both to their defaults. +On Windows the main window is created transparent and the page background turns +transparent only while video is visible (`html.video-active`), so browsing is opaque. ## Interface @@ -82,17 +69,8 @@ into the display's HDR headroom; SDR video returns both to their defaults. on demand. Timeline reports every 10 seconds (and when playback stalls) make the session appear in Plex; a reply carrying a termination (the server owner stopped the stream) stops playback and shows their message. The title is marked watched at the configured percentage. The player's back arrow (or Esc) - shrinks playback into a miniplayer. On Windows it is a window of its own - (`src-tauri/src/mini.rs`, page `mini.html` → `src/mini/`): a small borderless window - owned by the main one, which the video moves into (`VideoSurface::set_host`, one - composition target per window, swapped in a single commit). Dragging moves that whole - window, so video and controls never drift apart; letting go glides it to a corner of - the main window (or the one it's flicked towards), and it follows the main window as - that moves or resizes. Its page mirrors the player from the main window and sends its - buttons back (`player/miniWindow.ts`, events `mini:state` / `mini:action`). The video - moves into it once the main page is opaque again, and back before the page turns - transparent, so neither window flashes. On macOS the miniplayer stays inside the page: - the video is drawn in a corner rectangle with a matching hole masked out of the page + shrinks playback into a miniplayer: the video is drawn in a corner rectangle and the + interface stays visible around it, with a matching hole masked out of the page (`html.player-mini`). - **Upscaling** (`player/enhance.ts`): Performance and Balanced set mpv's scalers and debanding and load shaders bundled from `src-tauri/shaders/` (FSRCNNX 16, nlmeans, @@ -107,5 +85,4 @@ into the display's HDR headroom; SDR video returns both to their defaults. cached in the app cache folder (`gpu-shader-cache-dir`), so a slow first Direct3D compile happens once per shader set, mpv version and GPU driver. - **Updates**: `app/updater.ts` checks the signed feed on start; installs need the - user's confirmation and then relaunch. One release carries every platform's build and - the feed lists each of them (`windows-x86_64`, `darwin-aarch64`). + user's confirmation and then relaunch. diff --git a/docs/development.md b/docs/development.md index dbf8d76..ad10db4 100644 --- a/docs/development.md +++ b/docs/development.md @@ -11,22 +11,6 @@ debug builds and the Vite dev server. Never commit or print it. 5. `npm run tauri dev` -## Setup (macOS) - -1. Node 22+, Rust stable (`brew install rustup && rustup default stable`), the Xcode - command line tools and Homebrew. -2. `npm ci` -3. `sh scripts/fetch-libmpv.sh` installs Homebrew's `mpv` and copies libmpv with every - library it links into `vendor/mpv/macos`, rewritten to find each other there - (`@loader_path`) and signed, so the bundle doesn't depend on Homebrew. Homebrew - builds for the macOS it runs on, so the app's minimum macOS is that of the build - machine (`scripts/build.sh` sets it from the libraries). -4. `.env` as on Windows, then `npm run tauri dev`. - -Debug builds on macOS keep the Plex token in `dev-secrets.json` in the app data folder -rather than the Keychain: every rebuild is a new unsigned binary, which the Keychain -would ask about again. Release builds always use the Keychain. - The interface alone runs in a browser with `npm run dev` (port 1420), which is handy for layout work; playback, downloads and native dialogs need the desktop app. In development builds the stores are available as `window.__kaleido` for debugging. @@ -47,107 +31,45 @@ Playback tests change real Plex progress; resume an in-progress title near its s position, or restore it afterwards. Selecting audio or subtitle tracks is saved to Plex for that file. -Up Next (`player/PostPlay.tsx`) opens at an episode's first credits marker, or at the end -without markers. The video is drawn into its top-left frame (`player_rect`) behind a -matching hole in the page; check that the two line up after resizing, changing display -scale and returning to the video. In the browser, open it from the console by setting -`postPlay: true` (with `item`, `nextUp`, `episodeContextReady`) on `__kaleido.usePlayer`. - -## Diagnostics - -`src-tauri/src/diagnostics.rs` writes to the app's log folder -(`%LOCALAPPDATA%\tv.kaleido.desktop\logs` on Windows); nothing is uploaded. - -- **Hangs**: a watchdog asks the UI thread to answer every second. After 5 seconds of - silence it writes `kaleido-hang-