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

From Official Kodi Wiki
Jump to navigation Jump to search
(17 intermediate revisions by the same user not shown)
Line 38: Line 38:
</gallery>[https://www.drgeeky.com/convert-deb-file-into-ipa-file-for-sideloading-cydia-apps/ Source]
</gallery>[https://www.drgeeky.com/convert-deb-file-into-ipa-file-for-sideloading-cydia-apps/ Source]


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


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


== Install from Mac ==
== Install from Mac ==
{{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 Top Shelf feature will not work}}


=== Prerequisites ===
=== Prerequisites ===
Line 76: Line 74:
File:Pair atv4 4.png|'''Step 4:''' Now keep your Apple TV at this screen and take your Mac.
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 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 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!
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>
</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


'''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 have a paid developper account (99$/year) please follow the [[#.28option_B.29_PAID_Apple_dev_account|PAID Apple dev account]] section'''
<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 A) FREE Apple dev account ===
==== (option B) PAID Apple dev account with [https://streambuzz.net/apple-tv-top-shelf/ Top Shelf] ====


WIP
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


=== (option B) PAID Apple dev account ===


WIP
<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>


=== Obtain your signing certificate, and the provisioning profile ===
=== Install Kodi on your Apple TV ===


In order for Kodi to be sideloaded on your Apple TV it must be signed.
Finally you have to install your freshly created IPA file to your device. To do that follow the step-by-step guide below.
We will use iOS App Signer to sign Kodi, but firstly we need to obtain a valid signing certificate and provisioning profile. To do that we will create an empty tvOS app project on Xcode.


<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 [email protected]:/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:Manual]]

Revision as of 10:18, 17 August 2019

Home icon grey.png   ▶ iOS ▶ HOW-TO:Install Kodi on Apple TV 4 and 5 (HD and 4K)

Install from Windows (only for Apple TV 4)

What about the Apple TV 4K?

Stop hand.png 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 hackintosh, but we will not discuss this here.


Prerequisites

Stop hand.png 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.


  • Cydia Impactor
  • Windows 7 or higher
  • Latest version of iTunes is needed to be installed.
  • Latest .deb file of Kodi for tvOS from 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.

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

Source

Install Kodi on your Apple TV

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

Emblem-important-yellow.png 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

Source

Install from Mac

Prerequisites

  • 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 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.

Connect your Apple account in Xcode

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

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 FREE Apple dev account, else if you have a paid developper account (99$/year) please follow the PAID Apple dev account section.

(option A) FREE Apple dev account without Top Shelf

Emblem-important-yellow.png 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 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

(option B) PAID Apple dev account with Top Shelf

During the step-by-step guide below you will need to extract the .deb file and also a .tar.lzma file, to do that you can use an extractor app like The Unarchiver, or also a Terminal with the commands:

  • ar -x kodi-tvos.deb to extract the .deb file,
  • tar -xzf data.tar.lzma to extract the .tar.lzma file


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.

Install on a jailbroken Apple TV

It is simple to get Kodi working on your jailbroken Apple TV. Here you can find the current tvOS versions with an available jailbreak for the Apple TV 4 and 4K:

Once your Apple TV is jailbroken:

  1. Download the latest .deb file of Kodi for tvOS from Test builds and put it on your Desktop.
  2. Open a terminal window on your computer.
  3. Move to your desktop with cd ~/Desktop.
  4. Send the deb file to your Apple TV with scp DEB_FILE root@IP_ADDRESS:/var/root/' (adapt with your case, for example scp kodi-20180227-4a25e62-yab-tvos.deb [email protected]:/var/root/), the default password is alpine.
  5. Connect to your Apple TV with ssh root@IP_ADDRESS, default password is alpine.
  6. Install Kodi with dpkg -I /var/root/kodi-20180227-4a25e62-yab-tvos.deb.
  7. Refresh icons cache with uicache.
  8. Kodi should be on your main Apple TV screen.

Source