How to play MKV files on Apple TV
Based on: Apple TV 4K (1st gen, 2017), Apple docs, our player's sourcetvOS: Not recorded for the device tests (June to September 2026)Checked
Short answer
Apple TV's own apps do not open MKV, because Apple's player has no Matroska support. You need a third-party player. The best ones repackage the MKV into MP4 on the fly (no re-encoding) so Apple's native player can handle it, and fall back to a software player when that is not possible.
Why Apple TV refuses MKV
MKV (Matroska) is a container: a wrapper that holds video, audio and subtitle tracks. The codecs inside are often ones Apple TV can decode perfectly well, such as HEVC or H.264 video with Dolby Digital Plus audio. The problem is the wrapper.
What we measured
- Apple lists .m4v, .mp4 and .mov as the video formats for Apple TV 4K (2017). MKV is not listed.Apple doc
- Apple’s built-in player (AVPlayer) has no Matroska reader. When an early build of our player handed a Jellyfin MKV straight to it, playback failed.Our app
- An MKV with HEVC video and E-AC-3 (Dolby Digital Plus) audio, repackaged into fragmented MP4 inside the app without re-encoding, played on Apple TV 4K with picture and sound.Tested
- The HEVC track must be tagged
hvc1in the MP4. Taggedhev1, Apple’s player plays the audio over a black screen.Tested - Remuxing E-AC-3 into fragmented MP4 with FFmpeg needs the
delay_moovflag. Without it FFmpeg stops with “Cannot write moov before EAC3 packets parsed”.Tested - Starting playback while the remux is still running brought first frame to about 2.4 seconds. Copying the whole file first took about 24 seconds for an 11-minute file.Tested
- A software player (VLCKit) plays MKV directly over an SMB share: a 1080p MKV from a macOS share played with video and audio.Tested
The two ways a player can handle MKV
Remux, then play natively. The app unpacks the MKV and writes the same streams into an MP4 that Apple’s player accepts. You keep Apple’s own decoding, HDR handling and Dolby audio output. This only works when the codecs inside are ones Apple supports.
Decode in software. The app uses its own decoder (VLCKit, FFmpeg) for everything. It opens almost any file, but Apple’s native audio and HDR paths are not used.
A good player tries the first and falls back to the second.
Which MKV files are the problem
The video track is rarely the issue on Apple TV 4K. The audio track usually is.
| Audio in the MKV | Route in our app | Device-tested? |
|---|---|---|
| E-AC-3 (Dolby Digital Plus) | Remux, then Apple’s player | Yes, plays |
| E-AC-3 JOC (DD+ Atmos) | Remux, Atmos metadata kept in the file | File checked, receiver not |
| AC-3, AAC | Remux, then Apple’s player | Not yet |
| DTS, DTS-HD MA | Software player (VLCKit) | Not yet |
| TrueHD | Software player (VLCKit) | Not yet |
What our player does with each MKV audio type. Routes come from our app's source; only HEVC + E-AC-3 was device-tested end to end.
If your file has DTS or TrueHD audio, read Does Apple TV support DTS? and TrueHD and Atmos passthrough before you buy a receiver upgrade or a new player.
How our own player behaves
- The remux copies one video and one audio stream. Embedded subtitle tracks are not carried into the MP4.Our app
- With no audio track chosen, it picks the first AAC, AC-3 or E-AC-3 track and skips TrueHD and DTS.Our app
- If the remux fails, it switches to VLCKit for that film and resumes from the same position. We checked this by forcing the remux to fail.Tested
No Apple TV setting changes any of this. MKV support is entirely down to the player app you use.
Questions people ask
Can Apple TV play MKV without an app?
No. Apple lists .m4v, .mp4 and .mov as the video formats for Apple TV 4K. MKV is not on the list, and the built-in TV app cannot open it.
Does converting MKV to MP4 lose quality?
Not if it is a remux. A remux copies the existing video and audio streams into a new container without re-encoding, so the picture and sound are bit-for-bit the same.
Why does my MKV play with sound but a black screen?
One cause we reproduced is an HEVC stream tagged hev1 instead of hvc1 inside the MP4. Apple's player then plays the audio over a black picture. A player that remuxes correctly writes the hvc1 tag.
If you would rather not fiddle with it
Jellyfin & SMB Video Player
Plays MKV, MP4 and TS from Jellyfin, SMB shares and NAS on Apple TV and iPhone. Native AVPlayer first, an FFmpeg remux path for MKV, and a VLC fallback.
View on the App Store$6.99 once, no subscription
We make this app. Everything above is true whether or not you use it.