How to Stream Plex or Jellyfin to mpv?

Streaming media directly from a local Plex or Jellyfin server into mpv is entirely possible and highly popular for users looking to leverage mpv’s superior rendering, custom shaders, and lightweight footprint. Because mpv does not natively browse server libraries out of the box, accomplishing this requires specialized bridging software or external scripts. This guide covers the most efficient methods to connect your self-hosted media servers directly to an mpv media player backend.

Method 1: Using MPV Shim Clients (The Easiest Way)

The most seamless method to integrate these platforms is through “Shim” applications. These lightweight background clients transform your system’s mpv player into a cast target, similar to a Chromecast device.

• Jellyfin MPV Shim: A dedicated cross-platform application that routes video streams into an integrated or external mpv instance. Once launched, you simply open your Jellyfin web or mobile app, click the Cast icon, and select the MPV Shim player.
• Plex MPV Shim: This functions identically to the Jellyfin version. It allows you to browse your Plex library on a phone or browser and instantly cast high-bitrate media directly to mpv on your desktop.

Both tools natively support Direct Play, meaning they bypass server-side transcoding for virtually all video formats and advanced subtitle codecs.

Method 2: Command Line and Terminal Clients

If you prefer browsing your libraries without opening a heavy web browser, several terminal-based clients can pipe your server links right into your local mpv configuration.

• mov-cli with mov-cli-jellyplex: mov-cli is a terminal media browser. By adding the mov-cli-jellyplex plugin, you can query your local Plex or Jellyfin libraries via the command line using tools like fzf, select a video, and launch it automatically inside your local mpv player.
• jfsh (Jellyfin Shell): A specialized terminal-based client built specifically for Jellyfin. It utilizes your system’s exact mpv.conf settings, allows text-based searching, handles progress tracking, and automatically marks items as watched on your server.

Method 3: Official Desktop Media Players

If you want a traditional graphical user interface (GUI) layout combined with mpv’s robust playback engine, you can use the official desktop clients developed by the respective communities.

• Jellyfin Media Player: The official desktop app for Jellyfin relies on an embedded libmpv backend. This grants you the complete web interface layout for browsing while utilizing mpv’s internal video rendering pipeline for frictionless playback.
• Plex HTPC / Plex Media Player: Plex’s specialized home theater and desktop applications similarly embed mpv as their underlying media player engine to ensure accurate color mapping, hardware acceleration, and audio passthrough.