VLC on the Apple TV has a couple of serious issues.

  • If you access a uPNP network device, it will work the very first time. After that you will have to restart your Apple TV for VLC to again see the device. Decide to watch something on the network? Time to hit system / restart for VLC to have awareness that the network exists.

    No other app on the system has this problem. Other network media players see the devices fine.

  • If you are playing 10-bit HDR content, and your Apple is in HDR mode like Dolby Vision, VLC will completely screw up the tone maps and yield a disastrous posterized mess. You have to switch your Apple TV to SDR mode to get anything tolerable with such HDR files, as the SDR will all least force it within a range where the posterized nonsense is tolerable.

Again, neither of these happen with other players. Infuse, for instance, can support HDR fine and has no problem playing files on the network, no device restart necessary.

On the HDR issue, a while back I figured I’d just solve it myself, to find that building that project for Apple devices is an absolute disaster. Cocoapods have always been an absolute garbage dependency manager — hello circular dependency conflict hell — and despite an incredibly vanilla stack it was just impossible to get a build functioning.

I then asked a member of the VLC team to be told “oh yeah, VLC 4 fixes the HDR issue!”. VLC 4? Where is that? The most recent version on iOS or AppleTV is 3.0.x. Apparently 4.x has been coming real soon now for half a decade.

There are a number of similar VLC issues on macOS. For instance to view in folders on a network device you have to navigate “into” it, where VLC will start playing the first item at that level. You then stop, and now can see the folders and files at that level, so rinse and repeat.

It’s a free product, and is a killer on Linux or Windows. But if the support for Apple devices has such basic bugs, just drop them as targets. These devs owe me and other Apple users nothing, and I am grateful that they considered the platforms, but on the flip side, don’t waste people’s time with a subpar product.

And Cocoapods is thankfully going to put to a merciful end this year. If I never again see a project that uses that trash troublemaker, I will sing a little song of delight.