# Jellyfin Encoder

Jellyfin Encoder is a Docker-based tool that watches a Jellyfin media library, creates 720p HEVC or AV1 video copies with NVIDIA NVENC or Intel QSV acceleration, adds them as separate Jellyfin versions, and cleans. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2538/jellyfin-encoder

## Description

Jellyfin Encoder is a Docker-based tool that watches a Jellyfin media library, creates 720p HEVC or AV1 video copies with NVIDIA NVENC or Intel QSV acceleration, adds them as separate Jellyfin versions, and cleans orphaned symlinks so phones and remote viewers can direct play instead of live-transcoding.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

63/100 (Good), based on 5 of 5 factors.
- Maintained: 100 (last commit 14 days ago)
- Popular: 24 (14 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 30 (4 GB minimum RAM)
- Security check: 89 (no serious findings, 1 minor, CI, tests)

## Links

- Official website: https://geiserx.github.io/quality-gate-encoder/
- Docker Hub: https://hub.docker.com/r/drumsergio/quality-gate-encoder
- GitHub: https://github.com/GeiserX/quality-gate-encoder
- Documentation: https://geiserx.github.io/quality-gate-encoder/getting-started/
- Unraid: https://ca.unraid.net/apps/jellyfin-encoder-0xd9y4v0v3vnjv?q=jellyfin-encoder

## Common questions

### How do I start it with Intel QSV?

Map /dev/dri to the container and set HW_ENCODING_TYPE to intel. Dropping the /dev/dri device makes it encode in software.

### What mount permission do I need?

The source mount must be writable because the 720p symlink is written beside each original file. SYMLINK_TARGET_PREFIX must be the destination folder as Jellyfin sees it.

### Does it work on NFS/CIFS or with Jellyfin on another host?

Yes, it polls instead of relying on inotify. When Jellyfin is on another host, it uses a manifest instead of symlinks.

### How does orphan cleanup avoid deleting files from a bad mount?

Cleanup refuses when the source looks wrong and rate-limits delete events. This is intended to catch a broken mount before cleanup runs.

### Is the Quality Gate plugin required?

No, it is optional. It can cap chosen users at the 720p copy and tell the encoder which titles to encode first.

### How does the old jellyfin-encoder image relate to this container?

The old image is drumsergio/jellyfin-encoder. Releases under the old name continue until 2027-03-31.

## Alternatives

- Airwave: Airwave is a self-hostable service that turns your Plex library into custom, always-on live TV channels with a channel guide, recording, an…
- Ampache: Ampache is a self-hosted, web-based media server that streams and manages your music and video libraries from any device.
- Audiobookshelf: Self-hosted audiobook and podcast server and web app.
- Emby: Emby is a self-hosted media server that organizes personal video, music, photo, and live TV libraries and streams them to smart TVs, stream…
- Fladder: Fladder is a Flutter-based media frontend for Jellyfin.
- Frames: Frames is a modern SVOD (Streaming Video on Demand) streaming service built with React and NestJS.
- Infuse: Ignite your video content with Infuse – the beautiful way to watch almost any video format on your iPhone, iPad, and Apple TV.
- Jellyfin: Jellyfin is a Free Software Media System that puts you in control of managing and streaming your media.
- Kodi: Kodi is a free, open-source media center and player that organizes and plays movies, shows, music, and photos on TVs, computers, and mobile…
- Music Assistant: Music Assistant is a self-hosted, open-source music library manager for Home Assistant.
- Navidrome: Navidrome is a modern self-hosted music server and streamer that organizes personal music libraries and provides Subsonic/Airsonic-compatib…
- Nuvio: Nuvio Media Hub is a cross-platform app for managing and discovering media, with a playback-focused interface that can integrate with the S…

---
Source: Our Local Host (https://ourlocalhost.com/app/2538/jellyfin-encoder), the self-hosted and open-source app directory.
