mirror of
https://github.com/jellyfin/jellyfin.git
synced 2026-01-23 23:20:51 +01:00
Jellyfin Not Detecting Subtitle Merged With MKVToolNix #7242
Labels
No labels
area:database
awaiting-feedback
backend
blocked
breaking change: web api
bug
build
ci
confirmed
discussion needed
dotnet future
downstream
duplicate
EFjellyfin.db
enhancement
feature
future
github-actions
good first issue
hdr
help wanted
invalid
investigation
librarydb
live-tv
lyrics
media playback
music
needs testing
nuget
performance
platform
pull-request
question
regression
release critical
requires-web
roadmap
security
security
stale
support
syncplay
ui & ux
upstream
wontfix
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference: starred/jellyfin#7242
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
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 @DarkCTO on GitHub (Aug 10, 2025).
Description of the bug
Subtitle merged with MKVToolNix is not shown in JellyFin player to select.
Embedded subtitle from yt-dlp produces video that JellyFin can detect subtitles.
Goal: figure out why JellyFin cannot find subtitle of BadSub.mkv
NoSub:
GoodSub:
BadSub:
Reproduction steps
No Sub:
yt-dlp -f "bestvideo[height<=1080]+bestaudio/best" -o "NoSub.mkv" --write-subs --merge-output-format mkv https://www.youtube.com/watch?v=dC6ZGLzdaTsJust The Sub (generate NoSub.mkv.de.vtt):
yt-dlp -f "bestvideo[height<=1080]+bestaudio/best" -o "NoSub.mkv" --write-subs --skip-download https://www.youtube.com/watch?v=dC6ZGLzdaTsBadSub:
mkvmerge mkvmerge -o BadSub.mkv NoSub.mkv NoSub.mkv.de.vttGood Sub:
yt-dlp -f "bestvideo[height<=1080]+bestaudio/best" -o "GoodSub.mkv" --write-subs --embed-subs --merge-output-format mkv https://www.youtube.com/watch?v=dC6ZGLzdaTsWhat is the current bug behavior?
Player not shown subtitle selection for BadSub.mkv but shown for GoodSub.mkv
What is the expected correct behavior?
JellyFin should detect subtitles in BadSub.mkv
Or support MKVToolNix outputs.
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
No response
@DarkCTO commented on GitHub (Aug 10, 2025):
Android client also not detecting merged sub, even with GoodSub.mkv
@DarkCTO commented on GitHub (Aug 10, 2025):
Okay, this boils down to JellyFin not supporting VTT properly.
Converted VTT to SRT, used MKVToolNix and it shows subtitle on all clients.
yt-dlp -f best --embed-subs --convert-subs srt -o "%(title)s.%(ext)s" <video_url>@jellyfin-bot commented on GitHub (Dec 9, 2025):
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.