Skip to content

README.md

Latest commit

 

History

History
97 lines (76 loc) · 4.35 KB

README.md

File metadata and controls

97 lines (76 loc) · 4.35 KB

Jellyfin Transcode Nag Plugin

Stable release version Code coverage percentage Open issues License Dependencies status

A Jellyfin plugin that intelligently nags users when they're transcoding due to unsupported formats or codecs, while allowing bitrate-based transcoding to pass through without harassment.

Transcode Nag playback settings and trigger reasons in the Jellyfin dashboard

Playback nag configuration and trigger reason selection

Transcode Nag login settings, exclusions, and live session monitor in the Jellyfin dashboard

Login nags, user exclusions, and the live session monitor

What It Does

  • Sends a playback nag when Jellyfin reports selected TranscodeReasons.
  • Ignores bitrate-only transcodes, so users lowering quality for bandwidth do not get warned.
  • Can send a login nag when a user keeps hitting bad transcodes over the last week or month.
  • Lets you exclude users from all nags.
  • Includes a live session monitor in the plugin settings page.

Installation

Plugin Repository

  1. Go to Dashboard → Plugins → Repositories
  2. Add https://raw.githubusercontent.com/voc0der/jellyfin-transcode-nag/main/manifest.json
  3. Install Transcode Nag from Catalog
  4. Restart Jellyfin

Manual

  1. Download the latest ZIP from the Releases page
  2. Extract it into your Jellyfin plugins directory:
    • Linux: /var/lib/jellyfin/plugins/
    • Windows: %AppData%\Jellyfin\Server\plugins\
    • Docker: /config/plugins/
  3. Restart Jellyfin

Build from Source

dotnet build --configuration Release

Copy bin/Release/net8.0/Jellyfin.Plugin.TranscodeNag.dll into a versioned plugin folder, then restart Jellyfin.

Configuration

Open Dashboard → Plugins → Transcode Nag.

  • Choose which playback transcode reasons should trigger nags. Defaults focus on unsupported container, codec, subtitle, profile, level, resolution, bit depth, framerate, and related compatibility failures.
  • Set the playback message, delay, and timeout.
  • If you want login nags, enable them and set the threshold, time window, and message. The login message supports {{transcodes}} and {{timewindow}}.
  • Use Manage Excluded Users to opt users out of both playback and login nags.
  • Use the built-in live session monitor to see which active sessions currently match your rules.

Behavior Notes

  • Playback nags happen once per video, not once per session.
  • Login nags are rate-limited and use stored history from the last 30 days.
  • If a user returns to direct play after a bad transcode, login nags are suppressed until they regress again.

Star History

Star History Chart