MKV playback on Apple TV, measured: start, seek, audio and subtitles
Based on: Apple TV 4K (1st gen, 2017) and iPhone 13, device test pass of our player 1.0.9tvOS: 26 (device pass, 16 Oct 2026)Checked
Short answer
On a 2017 Apple TV 4K over home Wi-Fi, our test MKVs re-wrapped for Apple's player reached the first frame in about 1.2 to 4.5 seconds, started from the very first frame of the film, and resumed after a seek in 0.22 to 0.98 seconds. HDR10 stayed HDR10 in the stream handed to Apple's player, Dolby Digital Plus (including Atmos) tracks were carried untouched, and text subtitles showed. Files whose only good audio is FLAC, Opus or MP3 play through a software decoder instead.
How we measured
One file per launch, app restarted between runs, on a 2017 Apple TV 4K connected over home Wi-Fi to a Mac serving the files over SMB and http. Numbers come from the player’s own log. The TV was a 1080p SDR set with Match Content off, so nothing here describes HDR on a panel.
Results
| Test file | What happened | Time |
|---|---|---|
| 2-hour film, play from the start (http and SMB) | Starts at the first frame of the file (stream position 0.23–0.30 s). | n/a |
| HEVC 10-bit HDR10 + E-AC-3, http | Re-wrapped, PQ/BT.2020 kept in the stream | seeks 0.61 / 0.98 s |
| HDR10 + text subtitle (not forced), http | Re-wrapped, HDR kept, played 20 s without stall | first frame 1.24 s |
| HDR10 + forced subtitle, http | Software decoder, forced English subtitle shown, 0 frames lost | first frame 1.59 s |
| TrueHD Atmos + E-AC-3 JOC film, SMB | Re-wrapped with the E-AC-3 track (6 ch) | first frame 4.45 s |
| DTS first + AAC, SMB | Re-wrapped with the AAC track | first frame 1.46 s |
| FLAC / Opus / MP3 MKV | Software decoder, audio decoded, 0 lost | n/a |
| Default + forced English SRT, SMB | Re-wrapped, “English Forced” subtitle selected | played 20 s |
| 2-hour film, resume at 60:00, then scrub back to 22 s | Landed at 3600.21 s; scrub restarted the stream at 22.22 s | n/a |
Measured, Apple TV 4K (2017), Wi-Fi, 1.0.9. Device pass 16 Oct 2026.
What we do not claim
- Dolby Vision playback: no Dolby Vision sample was tested.
- Atmos as decoded by a receiver: our bench has no Atmos receiver.
- Long-play behaviour on the TV: no device run in this pass was longer than a few minutes.
- “No stalls”: two TV runs paused around 7 seconds in without an error (not reproduced on re-run), and on the Atmos film over SMB a seek ahead of the part already prepared did not land.
- Anything comparative with other players.
Background on why MKV needs this treatment at all: how to play MKV on Apple TV.
Questions people ask
Does HDR10 survive when an MKV is re-wrapped for Apple TV?
In our test the stream handed to Apple's player kept PQ transfer and BT.2020 colour. That is a statement about the stream, not about what a given TV panel shows; our test TV was a 1080p SDR set.
Does Apple TV play Dolby Atmos from an MKV?
When the MKV has a Dolby Digital Plus Atmos (E-AC-3 JOC) track, we carry that track to Apple's player untouched. We have not measured what a receiver shows, because our test bench has no Atmos receiver.
Why do some MKVs play through a different engine?
Apple's player cannot carry FLAC, Opus or MP3 audio inside the re-wrapped stream. Instead of playing those files silently, our player hands them to a software decoder (VLCKit), which plays the audio.
If you would rather not fiddle with it
Jellyfin & SMB Video Player
Plays MKV and MP4 from a Jellyfin server or an SMB share on Apple TV. MKVs are re-wrapped for Apple's own player without re-encoding; DTS, TrueHD, FLAC and Opus files are decoded by a built-in software player.
View on the App Store$6.99 once, no subscription
We make this app. Everything above is true whether or not you use it.