About this project

Jellyfin MPV Shim is a cross-platform desktop client for Jellyfin that uses MPV as its playback engine. It can run in the background as a cast target or act as a full desktop client with offline sync support. Core capabilities described in the README: - Direct play of most media through MPV, avoiding transcoding for advanced media files. - Cast-target ("shim") mode: the Jellyfin mobile and web apps can control the client remotely. - SyncPlay support for watching videos with friends, with documented caveats about joining groups while casting and about stopping playback. - Live TV: channel guide, channels, recordings, schedule and series recording rules, with recording available directly from listings. - Fast user switching: multiple local users, each with its own server logins and device identity, plus optional PIN protection described as a parental-control convenience rather than a security boundary. - Books and audiobooks: audiobooks play and resume like audio, with chapter controls for single-file .m4b; ebooks are download-and-open because Jellyfin does not serve book content page by page. Reading progress is manual (Pull/Push) for PDFs and comics. - Shader packs with FSRCNNX and Anime4K preconfigured, plus SVP integration for frame interpolation. - Display mirroring, on by default, showing a cast item before playback. - Headless mode that restricts the machine to cast-target use, explicitly not a security feature. - MPV keyboard shortcuts, a text-based menu, shell command triggers, Discord Rich Presence, and extensive configuration via config files and an external MPV option. Installation paths mentioned: Windows binary from releases, Flathub or pip on Linux, and a separate macOS section. MPV 0.41 or newer is recommended. Known limitations include no planned gapless music playback, SyncPlay fragility, and shader packs being sensitive to graphics hardware (with a --reset-shaders recovery flag).