Kodi on Apple TV: Install, Sideload & Use It

Kodi is a free, open-source media center that can be installed on an Apple TV, but not through the official App Store. You can sideload it using tools like Xcode or third-party services, and while it lacks some features of the native tvOS version, it plays your local media library, streams network content, and supports add-ons. This article explains exactly how to get Kodi on your Apple TV, what to expect, and the limitations you will face.

Why Kodi Isn’t in the App Store

Apple has strict App Store guidelines that prohibit apps from executing downloaded code, which is a core part of how Kodi works with its add-on system. Kodi is also a media player that can access content from unofficial sources, which Apple does not want to support. As a result, the official Kodi team does not submit the app to the App Store, and there is no simple “Install” button on your Apple TV. The only way to get it is by sideloading, which means installing the app outside of Apple’s official distribution channel.

What You Need to Sideload Kodi

To install Kodi on an Apple TV (4th generation or later, running tvOS), you need a few things:

An Apple TV (HD or 4K) with at least 32GB of storage (Kodi itself is about 100MB, but add-ons and cache can grow).
A Mac running Xcode (free from the Mac App Store) or a Windows/Linux machine with alternative tools.
An Apple ID (free) for signing the app.
A USB-C cable (for Apple TV HD) or a USB-C to USB-C cable (for Apple TV 4K) to connect to your computer.
Developer Mode enabled on the Apple TV (Settings > Developer > Developer Mode).

If you don’t have a Mac, you can use third-party services like Signulous or AppDB to sign and install Kodi without Xcode, but these usually require a small annual fee and may have their own restrictions.

Step-by-Step: Install Kodi Using Xcode

This is the most reliable and free method, but it requires a Mac and a bit of technical comfort.

Download the Kodi source code from the official Kodi GitHub repository (the “release” branch).
Open the .xcodeproj file in Xcode.
Change the bundle identifier to something unique (e.g., com.yourname.kodi) to avoid conflicts with other signed apps.
Set your Apple ID as the signing team in Xcode’s Signing & Capabilities settings.
Connect your Apple TV to your Mac via USB-C and enable Developer Mode on the Apple TV.
In Xcode, select your Apple TV as the build target and press Run (the Play button).
Xcode will build, sign, and install Kodi on your Apple TV. It will appear as a new app icon.

That’s it. The app will launch, and you can start adding your media sources and add-ons.

How to Use Kodi on Apple TV

Once installed, Kodi on Apple TV works similarly to other platforms. You navigate with the Siri Remote’s touchpad, click to select, and use the menu button to go back. The interface is the standard Kodi skin (Estuary), which is optimized for 10-foot viewing. You can:

Add media libraries: Point Kodi to a network share (SMB, NFS, UPnP) or a local USB drive (via the Lightning connector on Apple TV HD, but not on 4K).
Install add-ons: Go to Add-ons > Download, and choose from official repositories like YouTube, Twitch, or PBS. Third-party repos can be added via ZIP files, but be careful about unofficial sources.
Stream network content: Use the built-in UPnP client to browse media from a DLNA server on your network.
Use the remote app: The official Kodi remote app for iOS can control Kodi on Apple TV over your Wi-Fi.

Limitations and Common Problems

Kodi on Apple TV is not as polished as on other platforms. Here are the most common issues:

No hardware decoding for some codecs: The tvOS version relies on the system’s video decoder, which may not support all formats (e.g., some high-bitrate HEVC files or certain audio codecs like DTS). You might experience stuttering or black screens.
No passthrough audio: Kodi cannot pass through Dolby Atmos or DTS-HD to your receiver; it will output PCM stereo or multichannel, depending on your settings.
7-day signing expiration: When you sideload with a free Apple ID, the app is only valid for 7 days. After that, you must reinstall it. Paid developer accounts ($99/year) give you 1-year validity.
No background playback: Kodi will stop playing when you switch to another app, unless you use a workaround like the “Play from here” feature.
Remote quirks: The Siri Remote’s touchpad can be sensitive; you can adjust the sensitivity in Kodi’s settings.

If you encounter a black screen on launch, try restarting the Apple TV or reinstalling. If add-ons fail to install, check your network connection or try a different repository.

Kodi vs. Other Media Apps on Apple TV

You might wonder why not just use the built-in apps. Here’s a quick comparison:

Infuse: A paid app from the App Store that plays almost any format, supports network shares, and has a beautiful interface. It’s more stable than Kodi but not free and doesn’t support add-ons.
VLC: Free, plays most file types, and can access network shares, but it lacks the library management and add-on ecosystem of Kodi.
Plex: If you have a server, Plex is excellent for organizing media, but it requires a server computer and a Plex account.
YouTube, Netflix, etc.: These are official apps that work perfectly, but they only stream from their own services, not your local files.

Kodi is the best choice if you want a free, customizable, all-in-one media center with add-on support, and you don’t mind the sideloading hassle.

Is It Safe and Legal?

Kodi itself is completely legal and safe to use. It’s open-source software that has been around since 2002. The legality comes from what you do with it. Playing your own media files (ripped DVDs, downloaded movies you own) is fine. Streaming from official add-ons is fine. However, some third-party add-ons provide access to pirated content, which is illegal in many jurisdictions. Installing those add-ons is not recommended and could put you at risk. Also, sideloading any app violates Apple’s terms of service, but in practice, Apple does not enforce this for personal use. Just be aware that your Apple ID could be flagged if you sign too many apps.

Frequently Asked Questions

Can I install Kodi on Apple TV without a computer?

No, not directly. You need a computer to sideload the app. However, you can use a third-party signing service (like Signulous or AppDB) that handles the signing for you; you just pay a fee and follow their instructions, but you still need to download the IPA file to their service, which requires a computer or a mobile browser.

Does Kodi work on all Apple TV models?

Kodi works on Apple TV 4th generation (2015) and later, including the 4K models. It does not work on the 3rd generation or earlier, which have a different operating system and no app store.

Why does Kodi expire after 7 days?

Free Apple developer accounts only allow apps to be signed for 7 days. Apple does this to prevent free distribution of apps outside the App Store. To avoid re-installing every week, you need a paid Apple Developer account ($99/year) which signs apps for 1 year.

Can I use the Siri Remote to control Kodi?

Yes, the Siri Remote works as a basic remote: touchpad to navigate, click to select, menu to go back. You can also use the Kodi remote app on your iPhone for a better experience.

Will Kodi play my 4K movies on Apple TV?

It can, but only if the video codec is supported by tvOS. Most H.264 and HEVC (H.265) files up to 4K will play, but some high-bitrate files or certain audio tracks (like DTS) may not. For guaranteed 4K playback, consider using Infuse.

Is there a way to get Kodi without Xcode?

Yes, you can use a third-party signing service. These services sign the Kodi IPA for you, and you install it over-the-air using a profile. This is easier but costs money and may have a risk of revocation (Apple can revoke the certificate, making the app stop working).

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.

More cards in this drawer

The whole Numbers and Powers drawer →