Roze, groene of sterk verschoven kleuren tijdens het afspelen van HDR-content in Jellyfin betekenen meestal dat de server HDR- of Dolby Vision-content transcodeert, maar dat het tonemappingtraject niet correct werkt. In de IceWhale Community-thread van februari 2025 gebeurde dit op een ZimaCube met een Intel N100 en 16 GB RAM wanneer hardwareversnelling van Jellyfin was ingeschakeld.
Een teamlid van IceWhale reproduceerde correcte tonemapping, stelde vast dat de bron Dolby Vision was en gaf aan dat de Jellyfin-versie die toen beschikbaar was in de ZimaOS App Store problemen met kleurconversie leek te hebben. De communityoplossing bestond uit het gebruik van een andere Jellyfin-containerimage in combinatie met Intel Quick Sync Video-instellingen. De oorspronkelijke poster bevestigde later dat dit het probleem oploste. Dat maakt de thread nuttig, maar de exacte containerimage en schermafbeeldingen zijn historisch: controleer de huidige Jellyfin-releases en richtlijnen voor hardwareversnelling voordat je een werkende moderne App Store-installatie vervangt.
Waarom HDR in Jellyfin roze of groen kan worden
Het oorspronkelijke rapport ging over HDR-content die alleen een roze of groene afbeelding vertoonde wanneer hardwareversnelling en tonemapping waren ingeschakeld. Na controle van de bronindeling concludeerde IceWhale dat het bestand Dolby Vision-content bevatte in plaats van gewone SDR-video.
HDR-naar-SDR-afspelen is niet één enkele bewerking. Jellyfin moet mogelijk:
- een 10-bits HEVC- of Dolby Vision-bron decoderen;
- HDR- of Dolby Vision-kleurinformatie omzetten naar SDR-uitvoer;
- de video schalen of ondertitelen;
- het resultaat coderen naar een indeling die het afspeelapparaat accepteert.
Als de GPU-decodering werkt, maar de tonemapping-runtime, het stuurprogramma of de containerimage niet, kan de stream nog steeds worden afgespeeld terwijl de kleuren zichtbaar onjuist zijn.
De ZimaCube N100-behuizing uit 2025
Het testsysteem van de community was een ZimaCube met een Intel N100-processor en 16 GB RAM. Dat hardwaredetail is belangrijk, omdat Intel's geïntegreerde GPU hardwarematige videodecodering ondersteunt, maar de prestaties en softwareondersteuning afhankelijk zijn van de codec, de tonemappingmethode, de kernel, het stuurprogramma en de Jellyfin FFmpeg-build.
De eerste logische huidige productoptie voor de verouderde ZimaCube-familie is de huidige ZimaCube 2 Personal Cloud NAS. Ga er niet van uit dat de huidige hardwareconfiguratie identiek is aan het N100-systeem dat in deze communitytest uit 2025 werd gebruikt.
De in de community gedeelde Intel QSV-instellingen
De werkende communityconfiguratie selecteerde Intel QuickSync (QSV) als de methode voor hardwareversnelling van Jellyfin. Op de schermafbeelding was ook te zien dat hardwaredecodering voor veelgebruikte codecs was ingeschakeld en dat Intel-encoding met laag energieverbruik voor H.264 was geactiveerd.
Vink niet blindelings elk codecvakje aan. De huidige Intel-gids voor hardwareversnelling van GPU's van Jellyfin raadt aan alleen codecs in te schakelen die de geïnstalleerde GPU daadwerkelijk kan decoderen. Jellyfin vermeldt momenteel ook dat Intel QSV en VA-API werken op headless Linux-systemen zonder aangesloten monitor.
Schakel de juiste tonemappingmethode in
De tweede community-screenshot liet zien dat de tonemappingregeling van Jellyfin was ingeschakeld, terwijl VPP-tonemapping in die specifieke configuratie uitgeschakeld bleef.
De huidige Jellyfin-documentatie beschrijft twee belangrijke Intel-tonemappingmethoden op ondersteunde systemen:
- OpenCL-tonemapping: ondersteunt Dolby Vision Profile 5 en biedt uitgebreide instelmogelijkheden, maar de OpenCL-runtime moet op Linux mogelijk handmatig worden geïnstalleerd.
- QSV VPP-tonemapping: kan minder stroom verbruiken en hardware met vaste functie gebruiken, maar ondersteunt minder GPU-modellen en biedt minder instelmogelijkheden.
Jellyfin vermeldt ook dat hardwareversnelde HDR- en Dolby Vision-naar-SDR-tonemapping een GPU vereist die 10-bits HEVC-decodering ondersteunt. Als beide beschikbare tonemappingmethoden zijn ingeschakeld, geeft Jellyfin mogelijk de voorkeur aan VPP voor ondersteunde HDR10-workflows. De exacte combinatie moet daarom overeenkomen met je bronindeling en GPU.
Voor Dolby Vision is mogelijk de optie voor native decodering nodig
De huidige Intel-documentatie van Jellyfin voegt een detail toe dat in de screenshots uit 2025 gemakkelijk over het hoofd werd gezien: ondersteuning voor Dolby Vision vereist dat de optie Prefer OS native DXVA or VA-API hardware decoders is ingeschakeld voor de betreffende Intel-workflow.
Als normale HDR10-tonemapping werkt, maar Dolby Vision nog steeds verkeerde kleuren oplevert, controleer dan:
- het bestand daadwerkelijk een ondersteund Dolby Vision-profiel bevat;
- de GPU ondersteunt 10-bits HEVC-decodering;
- de huidige Jellyfin FFmpeg-build wordt gebruikt;
- de Intel-mediastuurprogramma's en de OpenCL-runtime zijn beschikbaar in de container;
- de voorkeur voor de native decoder die in de huidige Jellyfin-richtlijnen wordt vereist, is ingeschakeld.
Het probleem met de afbeeldingen in de ZimaOS App Store was een specifieke bevinding uit 2025
Op 28 februari 2025 zei een teamlid van IceWhale dat de toen beschikbare Jellyfin-versie in de ZimaOS App Store een probleem met kleurtonemapping leek te hebben en raadde het nyanmisaka/jellyfin Docker-image samen met een meegeleverd aangepast YAML-installatiebestand.
De bijgevoegde historische configuratie was:
Jellyfin.yaml, gedeeld in het oorspronkelijke community-antwoord.
Die aanbeveling loste het probleem van de oorspronkelijke gebruiker op, maar mag niet worden veralgemeend tot “het huidige Jellyfin-pakket uit de ZimaOS App Store is defect”. Containerimages, Jellyfin FFmpeg, Intel-stuurprogramma's en ZimaOS-appdefinities zijn sinds februari 2025 gewijzigd. Controleer op een huidige installatie eerst of het probleem met het huidige pakket en de logboeken kan worden gereproduceerd voordat je de container vervangt.
Zo controleer je of hardwareversnelling daadwerkelijk werkt
Beoordeel dit niet alleen op basis van de vervolgkeuzelijst Hardwareversnelling. Start een transcodeeractie en controleer de afspeelinformatie van Jellyfin of het FFmpeg-transcodeerlogboek. Je moet bevestigen dat hardwaredecodering, het tonemappingfilter en hardwarecodering allemaal naar verwachting worden gebruikt.
De huidige Jellyfin-documentatie raadt het meegeleverde jellyfin-ffmpeg, die de patches en GPU-integraties bevat die Jellyfin naar verwachting gebruikt. Een gedeeltelijke hardwarepipeline kan één zware stap op de CPU laten uitvoeren en slechte prestaties veroorzaken, zelfs wanneer QSV in het dashboard is geselecteerd.
Zo zag het succesvolle afspelen eruit
In het antwoord van IceWhale werd een resultaat voor het afspelen van Dolby Vision gedeeld nadat de image was gewijzigd en de QSV-instellingen waren toegepast. De afspeelinformatie liet actieve transcoding zien in plaats van direct afspelen.
De tester van IceWhale waarschuwde ook dat de geïntegreerde graphics van de N100 niet erg krachtig waren en meldde dat vloeiende Dolby Vision-conversie in die opstelling alleen rond 4K 30 fps en lager mogelijk was. Beschouw dit als één historisch testresultaat, niet als een gegarandeerde prestatiespecificatie voor elk bestand, elke bitrate, elk ondertiteltype of elke huidige Jellyfin-release.
Controleer actuele problemen met Intel-stuurprogramma's en de kernel voordat je Jellyfin de schuld geeft
In de documentatie met bekende problemen van Jellyfin worden verschillende Intel-specifieke problemen in Linux beschreven. Bugs in stuurprogramma's of de kernel kunnen invloed hebben op tonemapping en energiezuinige codering, en sommige platforms hebben nieuwere firmware of kernels nodig. Als kleuren op een huidige installatie verkeerd zijn, zelfs met een actuele Jellyfin-image, raadpleeg dan de pagina met bekende problemen met hardwareversnelling in Jellyfin.
Upgrade kernels, firmware of GPU-drivers niet zomaar op een werkende NAS. Maak een back-up van belangrijke gegevens en controleer of het probleem dat je probeert op te lossen daadwerkelijk overeenkomt met het gedocumenteerde platform en versiebereik.
Checklist voor het oplossen van problemen met HDR-tonemapping in Jellyfin
- Bevestig of het probleem alleen tijdens het transcoderen optreedt en niet bij direct afspelen.
- Controleer of de bron HDR10, HLG of Dolby Vision is.
- Bevestig dat de Intel-GPU de broncodec en bitdiepte kan decoderen.
- Gebruik de huidige Jellyfin-FFmpeg-build en het huidige containerpakket.
- Selecteer Intel QSV of de acceleratiemethode die bij de host past.
- Controleer of de vereiste Intel-media- en OpenCL-runtime binnen de container toegankelijk zijn.
- Schakel de huidige Jellyfin-tonemappingoptie in die bij de bron past.
- Controleer voor Dolby Vision de huidige vereiste voor de native decoder van Jellyfin.
- Start één testtranscodering en bekijk het FFmpeg-logboek.
- Alleen als het huidige ZimaOS-pakket het historische probleem met de image opnieuw veroorzaakt, kun je na het maken van een back-up van de Jellyfin-configuratie een aangepaste container overwegen.
Veelgestelde vragen over HDR-tonemapping in Jellyfin op ZimaOS
Waarom is HDR-video in Jellyfin roze of groen?
In het communitygeval was het betreffende bestand Dolby Vision en trad het probleem op in het hardwarematige conversietraject. Vergelijkbare symptomen kunnen ook het gevolg zijn van een probleem met de driver, FFmpeg, OpenCL of de container-image. Controleer daarom het huidige transcode-logboek voordat je ervan uitgaat dat de oorzaak uit 2025 identiek is.
Moet ik Intel QSV of VA-API gebruiken?
Beide worden door de huidige Jellyfin op Intel-hardware onder Linux ondersteund. De community-oplossing gebruikte QSV. De beste keuze hangt af van de GPU-generatie, de driverstack, de Jellyfin-versie en of je een specifiek tonemappingtraject nodig hebt.
Moet ik VPP-tonemapping of OpenCL-tonemapping inschakelen?
De huidige Jellyfin ondersteunt beide op geselecteerde Intel-hardware. OpenCL biedt bredere ondersteuning voor Dolby Vision en meer afstelmogelijkheden; VPP kan energiezuiniger zijn, maar heeft beperktere hardware- en formaateisen.
Heb ik de nyanmisaka/jellyfin-image nog nodig?
Niet automatisch. Dit was de werkende aanbeveling voor deze specifieke ZimaOS App Store-situatie uit februari 2025. Test eerst het huidige ZimaOS Jellyfin-pakket, omdat de app-image en de hardware-acceleratiestack van Jellyfin mogelijk zijn gewijzigd.
Kan de Intel N100 4K Dolby Vision aan tonemappen?
De IceWhale-communitytester rapporteerde in hun configuratie een soepele conversie rond 4K 30 fps en lager. De daadwerkelijke prestaties hangen af van de bitrate, het codecprofiel, ondertiteling, het uitvoerformaat, de geheugenbandbreedte, thermische limieten en de huidige software. Beschouw dit resultaat daarom als referentie en niet als garantie.
