Port Kaleido Desktop to macOS

macOS (Apple silicon) now plays, browses and updates like Windows:

- Video: libmpv's render API draws into a CAOpenGLLayer beneath the
  WKWebView, with the miniplayer rectangle, HDR passthrough through
  extended dynamic range (PQ/BT.2020) and display-sleep prevention.
- Window: native traffic lights on the top bar's centre line, hidden
  with the player's controls; the page's caption buttons are Windows-only.
- Interface: macOS shortcut labels (⌘K, ⌘[, ⌃⌘F), Plex identifies the
  player as a Mac, and header values are kept ASCII (Mac computer names
  usually contain a curly apostrophe).
- The window appears without waiting for an animation frame, which
  WKWebView doesn't run in a hidden window.
- Credentials: release builds use the Keychain and are signed with a
  lasting self-signed certificate so access survives updates; debug
  builds keep tokens in a private file to avoid prompts on every rebuild.
- Bundling: scripts/fetch-libmpv.sh makes Homebrew's libmpv and its
  libraries self-contained; scripts/build.sh builds the .app, .dmg and
  signed update archive.

Releases now carry both platforms: publish-release.mjs uploads each
machine's build into one release, and update-manifest.mjs writes the
feed from that release's assets, refusing while a platform is missing.

The updater uses a new signing key (public key in tauri.conf.json), so
existing installs must be reinstalled once.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Elijah Kuntz 2026-11-02 15:14:40 -07:00
parent a3c05e9062
commit 7d0803481b
39 changed files with 1191 additions and 230 deletions

View file

@ -4,9 +4,10 @@ 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.
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)).
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.
## What's in the app
@ -61,18 +62,20 @@ differences live in one place (see [Architecture](docs/architecture.md)).
| Browsing | | Player | |
| --- | --- | --- | --- |
| Ctrl+K | Search | Space / K | Play/pause |
| Ctrl+K (⌘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 |
| Alt+← (⌘[) / mouse back | Back | C | Next subtitle |
| / | Focus search | Shift+N | Next episode |
| F11 | Full screen | Esc | Exit full screen, then player |
| F11 (⌃⌘F) | Full screen | Esc | Exit full screen, then player |
Keys in brackets are the macOS equivalents.
## Build from source
Requirements: Node 22+, Rust (stable), and on Windows the Visual Studio C++ build tools
and 7-Zip.
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.
```powershell
npm ci
@ -81,6 +84,13 @@ 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