jellyfin

Diagnose Jellyfin transcoding and playback issues in Unraid servarr deployments.

1|Updated Mar 18, 2024
One-click install
npx skills add https://github.com/erfianugrah/dotfiles --skill jellyfin-erfianugrah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jellyfin
Source: https://github.com/erfianugrah/dotfiles/tree/main/.pi/agent/skills/jellyfin
Command: npx skills add https://github.com/erfianugrah/dotfiles --skill jellyfin-erfianugrah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you troubleshoot and optimize a self-hosted media-consumer stack by answering questions about Jellyfin video playback, transcoding behavior (including NVENC constraints), Jellyseerr request routing into the arr ecosystem, and Navidrome music scrobbling/integration setup.

Core Features & Use Cases

  • Service topology + ports awareness: Quickly map which service is responsible for what (Jellyfin/Jellyseerr/Navidrome), including internal IPs, external domains, and network separation between servarr and media.
  • Transcoding and NVENC “GPU mutex” guidance: Diagnose performance issues and scheduling conflicts caused by the single Pascal NVENC chip shared across Jellyfin, Tdarr, and Bazarr/Whisper workloads.
  • Cross-stack integration debugging: Identify why Jellyseerr-to-arr requests fail by directing investigation to Sonarr/Radarr internals, API key sources, and the correct internal URLs to avoid WAF/TLS hop issues.
  • Playback/library metadata troubleshooting: Explain Jellyfin library scan behavior, mount layouts, and heavy scanning I/O implications under shfs.

Quick Start

Ask it: “Help me debug why a client playback triggers heavy transcoding and where I should check logs/settings for Jellyfin, considering NVENC contention and Jellyseerr/arr routing.”

Frequently Asked Questions about jellyfin

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Jellyfin transcoding issues when sharing a single NVENC GPU?

Fix Jellyfin transcoding issues by diagnosing NVENC contention rules, identifying GPU scheduling conflicts from concurrent Tdarr or Bazarr workloads, and applying hardware resource isolation across your Unraid servarr deployment.

Why does my Jellyseerr to Sonarr integration fail over internal URLs?

Jellyseerr to Sonarr integration fails when internal URLs bypass WAF or TLS hops; direct investigation into API key sources and internal IP routing resolves service discovery failures within the servarr network.

How do I map service ports for Jellyfin, Navidrome, and Jellyseerr on Unraid?

Map service ports by identifying the internal IPs, external domains, and network separation between the servarr and media dual networks to ensure correct service discovery and API integration.

What causes heavy I/O during Jellyfin library scans on Unraid?

Heavy I/O during Jellyfin library scans is caused by mount layouts and metadata scanning behavior operating under shfs, requiring mount awareness to optimize disk reads across concurrent services.

Can I debug Navidrome music scrobbling within my Jellyfin media stack?

Debug Navidrome music scrobbling by validating its integration against the shared hardware resources and internal-IP API constraints of your Unraid composer-managed servarr stack.

What is the best way to troubleshoot Jellyfin playback triggering heavy transcoding?

Troubleshoot Jellyfin playback transcoding by checking client playback logs, evaluating NVENC contention rules, and verifying Jellyseerr and arr routing to isolate performance bottlenecks.