4K HEVC h.265 Media Sharing from Mac to AppleTV not working

Media Sharing content like backups from discs in 4K HEVC h.265 from a Mac to a current gen 4K AppleTV doesn't work. All HD videos appear instantly, but 4K videos appear to not be supported. This either has to be a bug or an undocumented limitation.


Already followed the documentation with no luck.


Can anyone else confirm this is the case?

Posted on Feb 2, 2025 9:06 PM

Reply
Question marked as Top-ranking reply

Posted on Feb 3, 2025 4:30 AM

There are two codec IDs in use for H.265 HEVC: hvc1 and hev1. One is compatible with Apple’s decoders, the other is not. The difference between these is more than just 4 characters, it is also how the media file is structured. Apple wants the former ID of the two, not the latter.

Video encoding requirements
1.10. You SHOULD use video formats in which the parameter sets are stored in the sample descriptions, rather than the samples. (That is, use 'avc1', 'hvc1', or 'dvh1' rather than 'avc3', 'hev1', or 'dvhe'.)


Find the codec ID for the video stream of your media file with a tool like Invisor Lite, or any other tool based on MediaInfo.


Fortunately, media files can be losslessly repacked with the other ID, rather than lengthy lossy re-encoding.

ffmpeg -i input.mp4 -c copy -tag:v hvc1 output.mp4

Similar questions

6 replies
Question marked as Top-ranking reply

Feb 3, 2025 4:30 AM in response to AwkwardEagle

There are two codec IDs in use for H.265 HEVC: hvc1 and hev1. One is compatible with Apple’s decoders, the other is not. The difference between these is more than just 4 characters, it is also how the media file is structured. Apple wants the former ID of the two, not the latter.

Video encoding requirements
1.10. You SHOULD use video formats in which the parameter sets are stored in the sample descriptions, rather than the samples. (That is, use 'avc1', 'hvc1', or 'dvh1' rather than 'avc3', 'hev1', or 'dvhe'.)


Find the codec ID for the video stream of your media file with a tool like Invisor Lite, or any other tool based on MediaInfo.


Fortunately, media files can be losslessly repacked with the other ID, rather than lengthy lossy re-encoding.

ffmpeg -i input.mp4 -c copy -tag:v hvc1 output.mp4

Feb 3, 2025 7:19 AM in response to AwkwardEagle

① If you use a tagging application, then do not mark it as ‘4K’. Leave out this tag for this resolution instead. The Computers app won’t see files tagged as ‘4K’, even though 3840×2160 is supported for the Apple TV 4K models.



② Files with certain audio formats may also be problematic, if different than what the device natively supports.

Apple TV doesn’t support DTS audio or its variants.

Apple TV doesn’t support Dolby TrueHD, nor Dolby Atmos as substream in Dolby TrueHD [like Blu-ray].

Apple TV 4K does support Dolby Atmos as substream in Dolby Digital Plus (E-AC3+Atmos) [like streaming].


③ Video in files should have the proper profile and level to mark support for that hardware model.

Apple TV 4K (1st generation) technical specifications - Apple Support

Apple TV 4K (2nd generation) technical specifications - Apple Support

Apple TV 4K (3rd generation) technical specifications - Apple Support

SDR: Main profile, up to Level 5.1, Main tier (3840×2160@60Hz)

Dolby Vision: Profile 5 up to Level 9 (different scale), Main tier (3840×2160@60Hz)

HDR10: Main 10 profile, up to Level 5.1, Main tier (3840×2160@60Hz)

HDR10+: Main 10 profile, up to Level 5.1, Main tier (3840×2160@60Hz) [A2737 and A2843 only, but backwards compatible as plain HDR10]

High tier files may have bitrates that exceed the processing limits.

Feb 3, 2025 8:33 AM in response to Urquhart1244

If you see my post below I accidentally stumbled upon the metadata fix. All other specs you list I've intentionally been using to ensure native playback with the AppleTV 4K which is why it was throwing me for such a loop.


For reference, all 4K files are HEVC 10-bit HDR Main10 at Level 5.1 HDR10. Nothing above 3840x2160. Audio is AAC.


Only trying Home Sharing due to a current playback bug in Infuse. When I can get Home Sharing to work it's perfect. Unfortunately, it's been nothing but unreliable so far. Getting iPads and iPhones to connect to the library or even update when new files are added is inconsistent at best making me think it's just a feature Apple doesn't put much effort into.

This thread has been closed by the system or the community team. You may vote for any posts you find helpful, or search the Community for additional answers.

4K HEVC h.265 Media Sharing from Mac to AppleTV not working

Welcome to Apple Support Community
A forum where Apple customers help each other with their products. Get started with your Apple Account.