⚠️ STATUS DISCLAIMER
Current Kodi Status: 🟡 WORKING (with significant caveats)
Last Verified: August 3, 2026
🚨 CRITICAL WARNING: Installing Kodi on Apple TV is significantly more difficult than on Android or Fire TV devices. Unlike those platforms where you simply sideload an APK, Apple TV requires using a Mac with Xcode, signing the app with an Apple ID, and repeating the installation every 7 days (unless you pay $99/year for a developer account).
⚠️ tvOS 18.1 Warning: Users have reported that Sideloadly no longer works on Apple TV 4K devices updated to tvOS 18.1. The Xcode method remains the most reliable approach as of 2026.
🔴 Not Compatible: Apple TV 3rd generation and earlier cannot run Kodi at all—there is no jailbreak and sideloading is impossible.
If the process seems too complex, consider these alternatives: Infuse (App Store), Swiftfin (App Store), Plex, or Jellyfin.
What Is Kodi on Apple TV?
Kodi is a free, open-source media center that organizes and plays your local media files while also supporting thousands of third-party streaming add-ons. On Apple TV, Kodi transforms your device into a powerful media hub capable of playing virtually any video format, accessing network shares (SMB/NFS), and streaming content from countless online sources.
Who Is This Guide For?
- Apple TV HD (4th generation) and Apple TV 4K (5th generation and newer) owners
- Users willing to use a Mac (no Windows method exists for 4K models)
- Those comfortable with re-installing the app every 7 days (free Apple ID)
- Users who understand that jailbreaking is not required and generally not available for modern Apple TVs
Key Features You’ll Unlock:
- 📁 Play virtually any media file format (MKV, MP4, AVI, etc.)
- 🌐 Access network shares via SMB, NFS, and UPnP
- 🔌 Install thousands of streaming add-ons
- 🎬 4K HDR playback (on Apple TV 4K models)
- 📺 Live TV and IPTV support
- 🎵 Music library management
📋 “No-Click” Quick-Reference Cheatsheet
For experienced users—skip the reading and install now.
| Item | Details |
|---|---|
| Compatible Devices | Apple TV HD (4th gen), Apple TV 4K (all generations) |
| Incompatible Devices | Apple TV 1st–3rd generation |
| Required Computer | Mac only (Windows cannot sideload to Apple TV 4K) |
| Required Software | Xcode (free from Mac App Store), iOS App Signer |
| Kodi Download | https://mirrors.kodi.tv/releases/darwin/tvos/ |
| Free Account Validity | 7 days – must reinstall weekly |
| Paid Account Validity | 1 year ($99/year Apple Developer Program) |
| Current Kodi Version | v21.2 (tvOS) |
| USB-C Required? | Apple TV HD = Yes; Apple TV 4K = No (wireless only) |
🟢 Kodi on Apple TV Status Report & Testing Log
| Metric | Status |
|---|---|
| Current Kodi Version | v21.2 (tvOS) |
| Stream Quality | Up to 4K HDR (depends on source content) |
| Compatible Hardware | Apple TV HD (4th gen), Apple TV 4K (all generations) |
| Minimum tvOS Version | tvOS 12 or higher |
| Installation Method | Xcode (macOS) – Sideloadly broken on tvOS 18.1 |
| Free Account | ✅ Yes – but 7-day reinstall required |
| Paid Developer Account | ✅ Yes – 1-year validity |
| Jailbreak Required | ❌ No – sideloading works without jailbreak |
| Windows Support | ❌ No – only works for Apple TV HD with USB-C |
| App Store Availability | ❌ Not available – must sideload |
🔧 Prerequisite Phase: What You Need Before Starting
Hardware Requirements
| Item | Details |
|---|---|
| Apple TV Model | Apple TV HD (4th gen) OR Apple TV 4K (any generation) |
| Computer | Mac (macOS) – Windows is NOT supported for Apple TV 4K |
| USB-C Cable | Required for Apple TV HD only – Apple TV 4K uses wireless connection |
| Network | Same Wi-Fi network for Apple TV and Mac (wireless method) |
Software Requirements
- Xcode – Download free from the Mac App Store
- iOS App Signer – Download from
http://dantheman827.github.io/ios-app-signer/ - Kodi .deb file – Download from
https://mirrors.kodi.tv/releases/darwin/tvos/ - Apple ID – Free account works (7-day limit) or paid Developer account ($99/year – 1-year limit)
Apple ID Configuration
- Open Xcode on your Mac
- Go to Xcode → Settings → Accounts
- Click the + button and sign in with your Apple ID
- Your account will appear in the list – this is how Xcode signs the app
⚠️ Important: With a free Apple ID, the app certificate expires every 7 days. You must reinstall Kodi weekly. A paid Apple Developer account ($99/year) extends this to 12 months.
📥 Execution Phase: Step-by-Step Installation
Step 1: Pair Your Apple TV with Xcode
For Apple TV HD (with USB-C cable):
- Connect your Apple TV HD to your Mac using a USB-C cable
- Open Xcode and go to Window → Devices and Simulators
For Apple TV 4K (wireless only – no USB-C port) :
- On your Apple TV, go to Settings → Remotes and Devices → Remote App and Devices
- On your Mac, open Xcode and go to Window → Devices and Simulators
- Your Apple TV 4K should appear in the Discovered list on the left
- Click on the Apple TV icon – Xcode will ask for a pairing code
- Enter the code displayed on your Apple TV screen
Step 2: Download the Kodi .deb File
- Open your browser and go to:
https://mirrors.kodi.tv/releases/darwin/tvos/ - Download the latest stable version – currently
org.xbmc.kodi-tvos_21.2-tvos.deb - Save the file to your Desktop for easy access
Step 3: Sign the Kodi File with iOS App Signer
- Open iOS App Signer on your Mac
- Under Input File, select the Kodi
.debfile you just downloaded - Under Signing Certificate, select your Apple ID certificate (created when you signed into Xcode)
- Under Provisioning Profile, select the profile for your Apple TV
- Click Start – iOS App Signer will create a signed
.ipafile
⚠️ Troubleshooting: If iOS App Signer fails with Xcode 16, download the latest build from GitHub (
https://github.com/DanTheMan827/ios-app-signer/actions) and use that version instead.
Step 4: Install Kodi on Your Apple TV
- In Xcode, go to Window → Devices and Simulators
- Select your Apple TV from the device list on the left
- Click the + (plus) icon
- Navigate to and select the signed
.ipafile you created in Step 3 - Xcode will install Kodi on your Apple TV – wait for the process to complete
Step 5: Launch Kodi
- On your Apple TV home screen, you’ll now see the Kodi icon
- Open Kodi and begin configuring your media sources and add-ons
🗑️ Cleanup Phase (Optional)
Unlike Android devices, there’s no APK file to delete. The signed .ipa file on your Mac can be kept for reinstallation every 7 days – don’t delete it unless you want to repeat the signing process.
Pro Tip: Save the .ipa file in a folder called “Kodi Apple TV” so you can quickly reinstall when the certificate expires.
🎮 Post-Installation UI/UX Walkthrough
Once Kodi is installed on your Apple TV, here’s what to expect:
The Kodi Interface
- Home Screen: Your media library, add-ons, and settings
- Movies/TV Shows: Browse your local or network media
- Add-ons: Access installed streaming add-ons (install from repositories)
- Settings: Configure playback, network, and appearance
Essential First Steps After Installation
- Install a Maintenance Add-on – Kodi’s tvOS storage is limited to just 500KB of permanent storage. Everything else is treated as cache and can be cleared by tvOS at any time.
- Recommended: Install OpenWizard – Set it to auto-clear cache on startup to protect your add-on data from being wiped.
- Enable SMB Client – Go to Settings → Services → SMB Client and set minimum to v1 and maximum to v3 for network share compatibility.
- Install Popular Add-ons (example repositories):
- Team Crew:
https://team-crew.github.io - Scrubs v2:
https://jewbmx.github.io/ - Mad Titan Sports:
https://magnetic.website/repo
🔄 Alternatives to Kodi on Apple TV
If the installation process seems too complex or you want a more stable experience:
| App | Best For | Availability | Notes |
|---|---|---|---|
| Infuse | Media playback | App Store | Premium video player with beautiful interface |
| Swiftfin | Jellyfin client | App Store | Free, open-source Jellyfin client |
| Plex | Media server client | App Store | Requires Plex Media Server |
| Jellyfin | Media server client | App Store via Swiftfin | Free, open-source alternative to Plex |
| MrMC | Kodi without add-ons | App Store | Based on Kodi core, more stable |
❌ “App installation failed” or “Cannot install Kodi”
Possible Causes: Xcode account configuration error, device pairing loss, or outdated iOS App Signer build.
Actionable Solutions:
- Verify your Apple ID is properly linked under
Xcode > Settings > Accounts. - Re-verify your Apple TV pairing status via
Window > Devices and Simulators. - For Apple TV 4K, confirm both your Mac and Apple TV are connected to the exact same Wi-Fi network.
- If using Xcode 16+, download the latest iOS App Signer build directly from GitHub to resolve modern compatibility bugs.
⏰ “Kodi won’t open after 7 days”
Possible Causes: Standard free Apple ID certificate expiration (7-day hard limit enforced by Apple).
Actionable Solutions:
- This is expected behavior. Re-connect your Apple TV/Mac and reinstall the app using your saved signed
.ipafile via Xcode. - Keep your signed
.ipafile organized in a dedicated local folder for rapid weekly reinstallation. - Permanent Bypass: Upgrade to a paid Apple Developer Program account ($99/year) to unlock 1-year certificates.
🗑️ “My Kodi add-ons keep disappearing!”
Possible Causes: tvOS restrictive storage architecture (only 500KB of permanent storage allocated per app; everything else is treated as volatile cache).
Actionable Solutions:
- Install OpenWizard immediately after your initial setup.
- Configure OpenWizard to auto-clear cache on startup so tvOS background garbage collection doesn’t wipe your add-on directories.
- Avoid leaving large raw media files or heavy poster caches unmanaged inside the app directory.
🔌 “Can’t see my Apple TV in Xcode”
Possible Causes: Network isolation, missing pairing confirmation, or disconnected USB-C line.
Actionable Solutions:
- Apple TV HD: Ensure the USB-C cable is securely plugged into both the back of the device and your Mac.
- Apple TV 4K: Go to
Settings > Remotes and Devices > Remote App and Deviceson your Apple TV to re-initiate wireless discovery. - Restart both your Mac and Apple TV to clear MDM or Bonjour network broadcast hangups.
📱 “Sideloadly doesn’t work on tvOS 18.1”
Possible Causes: Apple’s security patches in tvOS 18.1 block third-party application signing tools like Sideloadly.
Actionable Solutions:
- Sideloadly is confirmed permanently broken on tvOS 18.1+.
- Pivot immediately to the Xcode method outlined in this guide—it is currently the only stable, reliable sideloading path.
💻 “I only have a Windows PC – can I install Kodi?”
Possible Causes: Xcode and tvOS developer tools are strictly exclusive to macOS.
Actionable Solutions:
- Apple TV 4K: Impossible on Windows. Wireless sideloading strictly requires macOS and Xcode.
- Apple TV HD: Theoretically possible using legacy Cydia Impactor on Windows with a USB-C cable, though highly unstable and subject to the 7-day rule.
- Recommendation: Borrow a Mac, run a macOS virtual machine, or switch to an Android TV/Firestick if Windows compatibility is mandatory.
Is Kodi available on the Apple TV App Store?
No. Apple’s strict App Store review guidelines and policies prohibit media centers with open-source, dynamic plugin execution architectures like Kodi. Sideloading via Xcode is mandatory.
Which Apple TV models support Kodi?
- Supported: Apple TV HD (4th generation) and all iterations of Apple TV 4K.
- Unsupported: Apple TV 1st, 2nd, and 3rd generations (lack app installation hardware support and viable sideloading paths).
Do I need to jailbreak my Apple TV?
No. Modern sideloading via developer provisioning profiles and Xcode completely bypasses the need for a jailbreak, keeping your device secure and running stock tvOS.
Why do I have to reinstall Kodi every 7 days?
Apple enforces a strict 7-day security certificate expiration limit for all free Apple IDs used to sideload applications. Once the week elapses, the application locks until re-signed and pushed via Xcode.
Can I extend the certificate to 1 year?
Yes. Enrolling in the official Apple Developer Program ($99/year) extends application signing validity to a full 12 months, entirely removing the weekly reinstallation chore.
Why do my configurations and add-ons vanish?
tvOS enforces a strict 500KB local app storage cap. Without a management tool like OpenWizard handling cache control, tvOS wipes unpinned app data whenever background storage is constrained.
Is using Kodi on Apple TV legal?
Yes. Kodi itself is 100% legal, open-source software. Legal scrutiny applies exclusively to third-party add-ons or unauthorized copyrighted media streams accessed through external repositories.
✅ Conclusion
Installing Kodi on Apple TV is one of the most complex sideloading processes in the streaming world. Unlike Android TV or Firestick where you simply install an APK, Apple TV requires:
- A Mac with Xcode (for Apple TV 4K)
- An Apple ID (free or paid)
- iOS App Signer to sign the Kodi file
- Reinstallation every 7 days (free account) or $99/year for 1-year certificates
- Maintenance add-ons (like OpenWizard) to protect against tvOS cache clearing
Key Takeaways:
- ✅ Compatible with Apple TV HD and Apple TV 4K
- ❌ Not compatible with Apple TV 1st–3rd generation
- ⚠️ Sideloadly is broken on tvOS 18.1 – use Xcode instead
- ⏰ Free accounts = 7-day reinstall cycle
- 💰 Paid Developer account = 1-year validity
- 🗑️ Install OpenWizard to prevent add-on loss
- 📱 Consider Infuse or Swiftfin as simpler alternatives
If you’re not ready for this commitment, consider an Android TV device (NVIDIA Shield, Chromecast with Google TV) where Kodi installs in minutes.
Stream smart, and enjoy your media!
