HOW-TO:Install Kodi on Apple TV 4 and 5 (HD and 4K)

2020-01-27T00:08:54Z

Frakman1: /* Install on a jailbroken Apple TV */

{{mininav|[[iOS]]|page={{FULLPAGENAME}} }}

== Install from Windows (only for Apple TV 4) ==

=== What about the Apple TV 4K? ===

{{warning|Unfortunately the Apple TV 4K does not have a USB-C. If you are not jailbroken the only official way to sideload Kodi on your device is to use Xcode on macOS with a wireless connection.
To get macOS on you computer you can use a virtual machine or check for building an [[w:Hackintosh|hackintosh]], but we will not discuss this here.}}

=== Prerequisites ===

{{warning|Cydia Impactor is still a work-in-progress, There might be some bugs that you face while installing Kodi. It is not for the faint of heart.
This method also requires that Kodi be re-installed every '''7 days''' if you are using a free Apple developer account.}}

* [http://cydiaimpactor.com/ Cydia Impactor]
* Windows 7 or higher
* Latest version of iTunes is needed to be installed.
* Latest .deb file of Kodi for tvOS from [http://mirrors.kodi.tv/test-builds/darwin/tvos/ Test builds]
* A USB-C cable, without that, you can't connect your Apple TV with computer

=== Converting deb into ipa ===

Before beginning the installation, you have to convert .deb file of Kodi into .ipa. That is because Cydia Impactor only accepts .ipa files and not .deb files. If you already know how to convert .deb into .ipa, you can skip to the installation below.

*You will need to [http://www.7-zip.org/download.html/ Download 7-zip] and install it in your PC

'''Follow the steps given below and you will be able to convert .deb file into .ipa file.'''

<gallery widths="225px">
File:Convert-.deb-file-into-.ipa-file-on-windows-pc1.jpg|'''Step 1:''' Right Click on .deb file of Kodi that you downloaded on your PC and Select 7-zip > Extract files. Click OK in the next Window.
File:Convert-.deb-file-into-.ipa-file-on-windows-pc3.jpg|'''Step 2:''' Open the resulting Folder and you will find data.tar file inside. Simply extract data.tar file with Right Click > 7-zip > Extract Files.
File:Convert-.deb-file-into-.ipa-file-on-windows-pc4.jpg|'''Step 3:''' Now you should have data folder and data.tar file in the folder.
File:Convert-.deb-file-into-.ipa-file-on-windows-pc5.jpg|'''Step 4:''' Go inside the data folder and open Applications folder. Here you will find a folder named Kodi.app.
File:Convert-.deb-file-into-.ipa-file-on-windows-pc6.jpg|'''Step 5:''' Here create a new folder and name it “Payload” without quotes. Now you should have 2 folders. Payload and Kodi.app folder. Make sure that the P is capital in Payload.
File:Convert-.deb-file-into-.ipa-file-on-windows-pc7.jpg|'''Step 6:''' Now simply drag the Kodi.app folder and drop it on top of the Payload folder. In other words, copy kodi.app and paste it inside Payload folder.
File:Convert-.deb-file-into-.ipa-file-on-windows-pc8.jpg|'''Step 7:''' Next you have to Right-click the Payload folder and Click 7-zip > Add to archive option.
File:Convert-.deb-file-into-.ipa-file-on-windows-pc9.jpg|'''Step 8:''' A new window will pop up. Here you have to make sure that the Archive format is set to zip and name the archive ending with .ipa . Something like Kodi.ipa. After that click OK. <br> Now you should have your kodi.ipa file ready for installation.
</gallery>[https://www.drgeeky.com/convert-deb-file-into-ipa-file-for-sideloading-cydia-apps/ Source]

=== Install Kodi on your Apple TV ===

'''Connect your Apple TV 4 with power and make sure that it is turned ON before proceeding.'''

<gallery widths="225px">
File:1-USB-C-on-Apple-TV-4.jpg|'''Step 1:''' Connect your Apple TV4 with your computer, and make sure that it is turned ON. If iTunes or some other program pops up then close that first.
File:install-kodi-on-iPhone-without-jailbreak-and-XCode1.jpg|'''Step 2:''' Extract the Impactor zip file somewhere in your computer and Open Impactor.exe. Don’t select “Run as Administrator” for Cydia Impactor.
File:install-kodi-on-iPhone-without-jailbreak-windows2.jpg|'''Step 3:''' Make sure that your Apple TV is detected by Cydia Impactor. After that Drag and drop the Kodi.ipa file in Cydia Impactor.
File:install-kodi-on-iPhone-without-jailbreak-windows3.jpg|'''Step 4:''' Cydia Impactor will ask you to Enter your Apple ID. Enter a Valid Apple ID here and click OK Cydia Impactor will start installing Kodi on your Apple TV.
File:Kodi-Apple-TV-1024x570.jpg|'''Step 5:''' Wait for the installation to complete. Once done, simply look for Kodi icon on your Apple TV 4 main screen and Now you can open it.
</gallery>
{{notice|If you are using a free Apple developper account you will need to do this step every 7 days, so keep your IPA file on your computer}}
[https://www.drgeeky.com/install-kodi-apple-tv-without-mac-using-windows/ Source]

== Install from Mac ==

=== Prerequisites ===

* [http://dantheman827.github.io/ios-app-signer/ iOS App Signer]
* An iCloud account (required to download Xcode and to obtain your signing certificate and the provisioning profile)
* Xcode (you can download it directly from your Mac App Store)
* Latest .deb file of Kodi for tvOS from [http://mirrors.kodi.tv/test-builds/darwin/tvos/ Test builds]
* (optional) A USB-C cable if you have the Apple TV 4 (but just like the Apple TV 4K, the Apple TV 4 can also communicates wirelessly)

=== Connect your device ===

If you have an Apple TV 4 and a USB-C cable you can power on your device and plug in with your Mac.
Else if you have an Apple TV 4K or an Apple TV 4 without a USB-C cable you will need to pair your device wirelessly with Xcode.
You can follow the step-by-step guide below.

<gallery widths="225px">
File:Pair atv4 1bis.png|'''Step 1:''' On your Apple TV open "Settings".
File:Pair atv4 2.png|'''Step 2:''' Open "Remotes and Devices".
File:Pair atv4 3.png|'''Step 3:''' Open "Remote App and Devices".
File:Pair atv4 4.png|'''Step 4:''' Now keep your Apple TV at this screen and take your Mac.
File:Pair atv4 5.png|'''Step 5:''' Launch Xcode and then navigate to "Window" --> "Devices and Simulators" from the menu bar on top.
File:Pair atv4 6.png|'''Step 6:''' Select your Apple TV on the left panel and click "Pair".
File:Pair atv4 7.png|'''Step 7:''' Fill the verification code that appear on your Apple TV screen and click on "Connect". Your device is now paired with Xcode!
</gallery>

=== Connect your Apple account in Xcode ===

Follow the step-by-step guide below in order to connect your iCloud/Apple account in Xcode.

<gallery widths="225px">
File:Connect icloud account 1.png|'''Step 1:''' Launch Xcode and open "Preferences" from the menu bar on top.
File:Connect icloud account 2.png|'''Step 2:''' Open the "Accounts" tab and add an account with the "+" button.
File:Connect icloud account 3.png|'''Step 3:''' Choose "Apple ID" then click "Continue".
File:Connect icloud account 4.png|'''Step 4:''' Fill in your Apple account credentials then click "Next".
File:Connect icloud account 5.png|'''Step 5:''' Now your Apple account is linked with Xcode!
</gallery>

=== Generate Kodi IPA file from deb file ===

'''If you have a free Apple developper account (this is usually the case if you are a "lambda" user) please follow the section [[#.28option_A.29_FREE_Apple_dev_account|FREE Apple dev account]], else if you have a paid developper account (99$/year) please follow the [[#.28option_B.29_PAID_Apple_dev_account|PAID Apple dev account]] section.'''

==== (option A) FREE Apple dev account without [https://streambuzz.net/apple-tv-top-shelf/ Top Shelf] ====

{{notice|If you are using a free Apple developper account you will need to re-sign and re-install Kodi every 7 days and the [https://streambuzz.net/apple-tv-top-shelf/ Top Shelf] feature will not work}}

Follow the step-by-step guide below in order to (i) obtain a valid signing certificate and provisioning profile for your Kodi app and (ii) pack and sign Kodi ''.deb'' file in an ''.ipa'' file

<gallery widths="225px">
File:Generata ipa atv free 1.png|'''Step 1:''' Open Xcode and click on "Create a new Xcode project".
File:Generata ipa atv free 2.png|'''Step 2:''' Choose "tvOS" and "Single View App" then click on "Next".
File:Generata ipa atv free 3.png|'''Step 3:''' Fill the "Product Name" with "kodi", choose your Apple account name for the team, choose your name for the "Organization Name" and "com.yourusername" (without any space) for your "Organization identifier". Then click on "Next".
File:Generata ipa atv free 4.png|'''Step 4:''' Finally choose a location for the Xcode project then click on "Create".
File:Generata ipa atv free 5.png|'''Step 5:''' Your Xcode project is now alive, open the devices list by clicking on the target device on the top left.
File:Generata ipa atv free 6.png|'''Step 6:''' Choose your your "real" connected Apple TV. Also, check for a "Fix issue" button on the signing panel, if this button is present click on it. Now you can close your Xcode window.
File:Generata ipa atv free 7.png|'''Step 7:''' Now open iOS App Signer, click on "Browse" and choose the Kodi DEB file, select the signing certificate corresponding to your Apple account, select the provisioning profile corresponding to the organization identifier that you have previously chosen, then click on "Start".
File:Generata ipa atv free 8.png|'''Step 8:''' Click on "Save" and wait until the Kodi IPA file appears in the same folder as the DEB file.
</gallery>

==== (option B) PAID Apple dev account with [https://streambuzz.net/apple-tv-top-shelf/ Top Shelf] ====

During the step-by-step guide below you will need to extract the <code>.deb</code> file and also a <code>.tar.lzma</code> file, to do that you can use an extractor app like [https://theunarchiver.com The Unarchiver], or also a Terminal with the commands:
* <code>ar -x kodi-tvos.deb</code> to extract the <code>.deb</code> file,
* <code>tar -xzf data.tar.lzma</code> to extract the <code>.tar.lzma</code> file

<gallery widths="225px">
File:Generata ipa atv paid 1.png|'''Step 1:''' Open Xcode and click on "Create a new Xcode project".
File:Generata ipa atv paid 2.png|'''Step 2:''' Choose "tvOS" and "Single View App" then click on "Next".
File:Generata ipa atv paid 3.png|'''Step 3:''' Fill the "Product Name" with "kodi", choose your Apple account name for the team, choose your name for the "Organization Name" and "com.yourusername" (without any space) for your "Organization identifier". Then click on "Next".
File:Generata ipa atv paid 4.png|'''Step 4:''' Finally choose a location for the Xcode project then click on "Create".
File:Generata ipa atv paid 5.png|'''Step 5:''' Your Xcode project is now alive, open the devices list by clicking on the target device on the top left.
File:Generata ipa atv paid 6.png|'''Step 6:''' Choose your your "real" connected Apple TV. Also, check for a "Fix issue" button on the signing panel, if this button is present click on it. Now you can close your Xcode window.
File:Generata ipa atv paid 6bis.png|'''Step 7:''' Click on "Capabilities", then enable "App Groups", click on the "+" button and create a new group group.com.yourusername.kodi, and finally enable this group.
File:Generata ipa atv paid 7.png|'''Step 8:''' Click on "File" --> "New" --> "Target.."
File:Generata ipa atv paid 8.png|'''Step 9:''' Choose "tvOS", "TV Services Extension" then click on "Next".
File:Generata ipa atv paid 9.png|'''Step 10:''' Fill the "Product Name" with "kodi topshelf", choose your Apple account name for the team and choose your name for the "Organization Name", then click on "Finish".
File:Generata ipa atv paid 10.png|'''Step 11:''' Click on "Activate".
File:Generata ipa atv paid 11.png|'''Step 12:''' Click on "Capabilities", then enable "App Groups" and enable the group previously created.
File:Generata ipa atv paid 12.png|'''Step 13:''' Now close Xcode and open the folder that contains your Kodi DEB file, then right click on it and open it with your unarchiver app. You will obtain 3 files.
File:Generata ipa atv paid 13.png|'''Step 14:''' Right click on "data.tar.lzma" and open it with your unarchiver app. You will obtain a folder named "data". Open "data" and all other folders until you find the "Kodi.app" file. Right click on it and choose "Show Package Contents" then open the "PlugIns" folder.
File:Generata ipa atv paid 14.png|'''Step 15:''' Open iOS App Signer, drag and drop "TVOSTopShelf.appex" in the "Input File" field, select the signing certificate corresponding to your Apple account, select the provisioning profile "com.yourusername.kodi.kodi-topshelf", then click on "Start". When the process has finished close iOS App Signer.
File:Generata ipa atv paid 15.png|'''Step 16:''' In your Finder window go back until you see the "Kodi.app" file. Open iOS App Signer, drag and drop "Kodi.ipa" in the "Input File" field, select the signing certificate corresponding to your Apple account, select the provisioning profile "com.yourusername.kodi", '''check "ignore PlugIns folder"''', then click on "Start". Click on "Save" and wait until the Kodi IPA file appears in the same folder as the "Kodi.app" file.
</gallery>

=== Install Kodi on your Apple TV ===

Finally you have to install your freshly created IPA file to your device. To do that follow the step-by-step guide below.

<gallery widths="225px">
File:Pair atv4 5.png|'''Step 1:''' Start your Apple TV and stay on the main menu screen. Launch Xcode and then navigate to "Window" --> "Devices and Simulators" from the menu bar on top.
File:Sideload atv 1.png|'''Step 2:''' Select your device on the left panel and click on the "+" button.
File:Sideload atv 2.png|'''Step 3:''' Select your freshly generated IPA file then click on "Open", finally wait until Kodi appear on your Apple TV main menu screen.
</gallery>

== Install on a jailbroken Apple TV ==

It is simple to get Kodi working on your [[w:iOS jailbreaking|jailbroken]] Apple TV. Here you can find the current tvOS versions with an available jailbreak for the Apple TV 4 and 4K:
* '''10.2.2 to 11.1:''' [https://wiki.awkwardtv.org/wiki/Backr00m backr00m]
* '''11.0 to 11.4.1:''' [https://coolstar.org/electra/ electraTV]
* '''12.0 to 12.1.1:''' [https://chimera.sh chimeraTV]

Once your Apple TV is jailbroken:
# Download the latest .deb file of Kodi for tvOS from [http://mirrors.kodi.tv/test-builds/darwin/tvos/ Test builds] and put it on your Desktop.
# Open a terminal window on your computer.
# Move to your desktop with <code>cd ~/Desktop</code>.
# Send the deb file to your Apple TV with <code>scp DEB_FILE root@IP_ADDRESS:/var/root/'</code> (adapt with your case, for example <code>scp kodi-20180227-4a25e62-yab-tvos.deb root@192.168.1.3:/var/root/</code>), the default password is <code>alpine</code>.
# Connect to your Apple TV with <code>ssh root@IP_ADDRESS</code>, default password is <code>alpine</code>.
# Install Kodi with <code>dpkg -i /var/root/kodi-20180227-4a25e62-yab-tvos.deb</code>.
# Refresh icons cache with <code>uicache</code>.
# Kodi should be on your main Apple TV screen.

[https://wiki.awkwardtv.org/wiki/Installing_Deb_Files Source]

[[Category:Manual]]
[[Category:IOS|IOS]]
[[Category:How-to|IOS]]
[[Category:Installation|IOS]]

Official Kodi Wiki - User contributions [en]

HOW-TO:Install Kodi on Apple TV 4 and 5 (HD and 4K)