mirror of
https://github.com/jellyfin/jellyfin.git
synced 2026-07-16 05:43:54 +03:00
Thumbnail extraction fails for mkv with webp attachment #7209
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @15532th on GitHub (Aug 3, 2025).
Description of the bug
Embedded Images Extractor fails to extract
.webpthumbnail from mkv files produced by yt-dlp with--embed-thumbnail --merge-output-format mkv.Reproduction steps
yt-dlp --embed-thumbnail --merge-output-format mkv https://youtu.be/video_id, add directory containing the video to the libraryWhat is the current bug behavior?
Preview is a screenshot taken from the middle of the video. With Screen Grabber disabled in library settings preview is not generated at all.
What is the expected correct behavior?
Preview is the same as Youtube thumbnail, embedded in the mkv.
Jellyfin Server version
10.10.0+
Specify commit id
No response
Specify unstable release number
No response
Specify version number
No response
Specify the build version
10.10.7
Environment
Jellyfin logs
FFmpeg logs
Client / Browser logs
No response
Relevant screenshots or videos
No response
Additional information
There is bug in ffmpeg tracker describing seemingly this exact problem: https://trac.ffmpeg.org/ticket/10506. The issue persists with the latest build of ffmpeg and the bug is open, so I assume it is not yet fixed. There is also mention of possible workaround with
-dump_attachmentoption.@15532th commented on GitHub (Aug 3, 2025):
Even though the root cause of the issue does seem to be caused by ffmpeg, I believe it would be beneficial to fix it in Jellyfin. Original bug has been filed two years ago and there was no movement ever since, and even after it gets fixed, installations relying on system-wide binary won't benefit from the fix.
The image extraction is performed by constructing and running ffmpeg command, and the workaround would be to add yet another special case for attachments with mimetype
image/*, which would make extractor more robust against ffmpeg quirks, and it seems to me that extractor code already has plenty of similar format-specific workarounds.I see a few other similar issues (like https://github.com/jellyfin/jellyfin/issues/8440), so it is not entirely new, and I am probably not the only one affected by this.
@Diosjenin commented on GitHub (Aug 4, 2025):
+1 here. Literally just ran into this problem today and found this page via a google search. Image extraction works fine for MP4 files, but fails for MKV files. I'm also getting the error whether those MKV files were downloaded from YT-DLP or whether they're locally rendered files with a PNG thumbnail manually attached via MP3Tag, so it's not a YT-DLP-specific or WEBP-specific problem.
Running Jellyfin via the official Docker container on Unraid. Some relevant example logs:
When downloaded from YT-DLP:
When thumbnail was manually added:
@Zeugma440 commented on GitHub (Sep 26, 2025):
Just my two cents - might be interesting to have a discussion over if and how ATL can help bridging the gap of metadata extraction for video files that have a shared structure with audio files (namely : MP4/M4A and MKV/MKA).
@jellyfin-bot commented on GitHub (Jan 25, 2026):
This issue has gone 120 days without an update and will be closed within 21 days if there is no new activity. To prevent this issue from being closed, please confirm the issue has not already been fixed by providing updated examples or logs.
If you have any questions you can use one of several ways to contact us.
@15532th commented on GitHub (Jan 28, 2026):
Sure, here is a relevant part of the log as tested on the latest stable release (10.11.6) on Win11:
The issue is still there as originally described.