jellyfin/jellyfin-mpv-shim v3.0.0pre12

Pre-release 12: Books & Comics, Key Bindings, UI/UX fixes

on GitHub

This pre-release adds book playback!

Namely audiobooks with chapters, but also epub and comics (CBZ/CBT only) are supported.
You can also read other formats, but they'll be opened in an external reader not within
MPV Shim, assuming you have one installed. The built-in epub reader is designed for novels
and basic markup such as paragraphs, lists, headings, and images. If your epub books are
more complicated you can use the open in external reader feature for those too.

Also of note, MPV Shim only steals keybinds from mpv when needed, arrow keys for instance
are not bound unless menu UI is open or syncplay is active.

Major Additions

• Book playback!
  • Audiobooks are supported now, including chapter and multi-file variants.
  • EPUBs and comics can be viewed within the MPV window. (No new dependencies.)
  • All book types can be opened using an external viewer is one is available.
  • Offline downloads for books are also supported, books download on first open.
• You can now set shader packs on a per-series and per-library basis.
  • Very useful for Anime4K in particular.
• Newly added media info dialogs allow seeing details about the current media file.
  • Within playback, it'll show details such as MPV FPS, transcoding reason (if applicable), hardware encoding.
  • The traditional MPV info UI is still available via the i key.
• Browser filter pane is revamped and includes new filters specific to Jellyfin v12 when available.
• Added text size and minimum text size adjustments. Text sizing is also more consistent now.
• Key bindings are now claimed, not set globally. No more messing with your arrow keys!
  • All user keybinds which affect seeking and play/pause are now intercepted only when needed by Syncplay.
  • If you customized keybinds with the old settings, they'll be migrated to input.conf.
• Added buttons/context menu entries for deleting media. (Requires confirmation.)
• You can now turn hardware decoding on via the settings UI.
  • It defaults to off because MPV developers still see frequent breakage with it.
  • You can also selectively enable it for files over 1080p.
• Offline sync now remembers playback that happens while online or via other clients.
• Added settings for deinterlacing and temporal scaling to settings UI.

Improvements

• Detail pages now also show poster/thumbnail images instead of just the backdrop.
• Improved search to show more entity types and more results for each type.
• Allow MPV-style player mouse bindings (still uses click-to-pause by default). (#669)
• Multi-version files get a badge displaying the number of versions.
• Added "Play Next" option to context menus.
• Auto-download now supports downloading in batches (disabled by default). (#661)
• Fixed icons in browser to use the same icons jellyfin-web uses.
• Reduced RAM usage required for browser.
• CLI mode for builds without lua/osc support now works again. (It had been broken for years...)
• Added Windows ARM64 CI build.
• For GNOME users, the (lack of) systray and window decorations is now detected and dealt with...
  • CSD is drawn inside the MPV UI, the top bar is draggable, and a resize handle is added.
  • If no systray exists, you have to opt into running in the background.
• Add theme mode to use shadows instead of badges
• Add a "Super Dark" theme which uses grey as accent color and shadows
• Use full-width backdrops on detail pages
• Add backdrop banners to Season pages
• Add justify (now default) and centered display modes for browse pages to cut down on large voids in margins

Bug fixed from last release

• Fixed ordering of songs in the music browser to order by actual track name not track number.
• Use a larger systray icon to improve HiDPI
• Make cover size only affect images and not text size
• Fix Live TV cutting off times when displaying as posters.
• .strm files should now play properly and save runtime
• Fixed bug where detail page sometimes ignored subtitle/audio selection
• Allow skipping backwards before the begining of queued items, when possible. (#650)
• Fixed issue where window title fails to reset (#647)
• Fixed cache eviction and cache cleanup issues
• Fixed auto-download ignoring episode limit
• Fixed broken pending downloads stopping entire download queue
• Fixed issue where syncplay group creation failed on home page
• Fixed issue where syncplay didn't allow changing what is playing due to leaving group instead
• Fixed photos not showing on accounts not allowed to download (still affects books due to server limits)
• Shader packs don't apply to photos now
• Fixed issue where duplicate people in cast row causes unexpected behaviour
• Fixed ENTER opening OSD menu when not expected
• Fixed positioning consistency of carousel headings
• Fixed the unplayed count badge overflowing when more than 99
• Added permission check for collections actions
• Fixed breakage where Live TV might not fully refresh
• Fixed mouse back/forward buttons broken while playing audio.

To install on Linux, install via pip:

pip install --pre --upgrade jellyfin-mpv-shim[all]

Or via the attached flatpak file:

flatpak install --user --bundle jellyfin-mpv-shim_v3.0.0pre12_amd64.flatpak

Development was assisted using AI.