Kaleido-Desktop/vendor/mpv/README.md
Elijah Kuntz 7d0803481b 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>
2026-11-02 15:14:40 -07:00

668 B

Native libmpv

Kaleido loads libmpv at runtime. Each operating system keeps its library in its own folder, which is ignored by git and fetched by a script:

OS Folder How to fetch
Windows windows/libmpv-2.dll scripts/fetch-libmpv.ps1 (shinchiro mpv-dev-x86_64 build)
macOS macos/libmpv.2.dylib and the libraries it links scripts/fetch-libmpv.sh (Homebrew mpv, made self-contained)
Linux system libmpv.so.2 Install your distribution's libmpv2 package

At runtime Kaleido looks in the app's resources, beside the executable, here, and finally on the system library path (see src-tauri/src/mpv.rs).