Je mediaserver speelt een film prima af op je laptop, maar op de tv hapert hij of blijft hij bufferen. Meestal is dat geen netwerkprobleem maar een rekenprobleem: de processor moet elk beeldje zelf omzetten. Met hardware-transcoding doet de grafische chip dat, en zakt het cpu-gebruik van 100 naar een paar procent.
Eerst eerlijk: heb je transcoding nodig?
Transcoding gebeurt alleen als het afspelende apparaat het bestand niet direct kan afspelen. Drie oorzaken komen het vaakst voor: de container of codec wordt niet ondersteund (bijvoorbeeld HEVC op een oudere tv), de ondertitels zijn ingebakken in een formaat dat de speler niet snapt, of de bitsnelheid ligt te hoog voor het apparaat.
Vuistregel: speelt je tv of mediaspeler het bestand direct af, dan heb je transcoding niet nodig. Gebeurt het vaak, dan is transcoding de oplossing – maar let op dat je cpu het haalt.
Wat je nodig hebt
- Een Synology met Intel- of AMD-processor. De instapmodellen met een ARM-chip (j-serie) hebben geen bruikbare hardware-transcoding.
- Jellyfin in Docker, bij voorkeur via Portainer of
docker compose. - Toegang tot
/dev/driop de NAS – dat is het apparaat dat de grafische chip vertegenwoordigt. - Een Jellyfin-account met rechten om de serverinstellingen te wijzigen.
Stap 1: controleren of je NAS het kan
Log in via SSH en kijk of het apparaat bestaat. Zonder deze stap kun je blijven proberen:
ls -l /dev/dri
Je hoopt op zoiets als card0 en renderD128. Zie je alleen card0, dan mis je de render-node en werkt transcoding niet of alleen met rechtenproblemen. Zie je helemaal niets, dan heeft je model geen bruikbare iGPU en houdt het hier op.
Stap 2: de container de chip geven
In docker compose zet je het apparaat erbij:
services:
jellyfin:
image: jellyfin/jellyfin:latest
devices:
- /dev/dri:/dev/dri
group_add:
- "937" # de GID van de 'render'-groep op je NAS
volumes:
- ./config:/config
- ./cache:/cache
- /volume1/media:/media:ro
restart: unless-stopped
De group_add is de stap die de meeste mensen overslaan. Zonder die regel heeft de container wel toegang tot het apparaat, maar geen rechten om het te gebruiken. Zoek de juiste GID op met:
getent group render
In Portainer voeg je hetzelfde toe onder "Runtime & Resources" → devices, en de GID onder "Env" of via de compose-editor.
Stap 3: in Jellyfin aanzetten
Ga naar Dashboard → Afspelen → Transcodering. Kies bij hardwareversnelling voor Intel QuickSync (QSV) of VAAPI, en vink de formaten aan die je gebruikt: H.264, HEVC, en als je die hebt ook VP9 en AV1. Laat "hardware decoding" en "hardware encoding" beide aan staan.
Stap 4: controleren of het echt werkt
Instellingen aanzetten is niet hetzelfde als werken. Twee checks:
- In Jellyfin: speel een bestand af dat getranscodeerd moet worden en open Dashboard → Actieve taken. Er staat "Transcoding" bij, en bij de methode zie je
QSVofVAAPIin plaats vansoftware. - Op de NAS: kijk met
topofdocker statsnaar het cpu-gebruik van de container. Zakt dat naar 5–20%, dan doet de iGPU het werk. Blijft het rond de 100% hangen, dan valt hij terug op software.
Wat niet werkt (en waarom)
- Alleen
/dev/drimounten zondergroup_add. De container ziet het apparaat maar mag het niet openen, en in het logboek verschijnt iets als permission denied. Dit is de meest voorkomende fout. - Transcoding aanzetten op een ARM-model. De j-serie heeft geen QuickSync; de optie staat er, maar de hardware doet niets.
- Alle formaten aanvinken "voor de zekerheid". Sommige combinaties worden door de iGPU niet ondersteund en vallen terug op software, zonder duidelijke melding. Vink aan wat je écht gebruikt.
- Blijven zoeken in de Jellyfin-instellingen als het niet werkt. Negen van de tien keer zit het probleem in de containerconfiguratie, niet in Jellyfin.
Snel oplossen: symptoom, oorzaak, oplossing
| Symptoom | Meestal de oorzaak | Oplossing |
|---|---|---|
| Film hapert, cpu op 100% | Terugval op software-transcoding | /dev/dri en group_add controleren |
| Permission denied in het logboek | Verkeerde of ontbrekende GID | getent group render en die GID toevoegen |
| Optie ontbreekt in het menu | Geen iGPU of ARM-model | Niets aan te doen; software-transcoding of een ander model |
| Werkt niet na een Jellyfin-update | Image zonder de juiste drivers | Terug naar een werkende tag en de release-opmerkingen lezen |
| Ondertitels zorgen voor haperingen | Ingebakken ondertitels forceren transcoding | Externe .srt-bestanden gebruiken |
Veelgestelde vragen
Hoeveel streams kan mijn NAS aan?
Met hardware-transcoding haalt een moderne Celeron of Pentium meestal twee tot vier 1080p-streams tegelijk. Bij 4K en HEVC zakt dat snel naar één. Het is geen exacte wetenschap: test het met je eigen bestanden en kijk naar docker stats.
Is transcoding slechter voor de kwaliteit?
Ja, er gaat altijd iets verloren. Daarom is "direct play" altijd beter: kies bestanden die je apparaten aankunnen. Transcoding is een vangnet, geen doel.
Kan ik dit ook op een Raspberry Pi?
De Pi heeft geen hardware-encoder. Je kunt er wel naar transcoderen, maar alleen met software, en dan houdt het bij één stream op. Voor een mediaserver is een NAS of een kleine Intel-machine een betere keuze.
Verder lezen
- Docker op een Synology NAS: Portainer en automatische updates – de basis onder deze container.
- Nginx in Docker: 403 en lege pagina's oplossen – je mediaserver netjes bereikbaar maken.
- Veilig bij je thuis komen met Tailscale of WireGuard – je Jellyfin bereiken zonder poorten open te zetten.