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).
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.