HOW-TO:Install Kodi for iOS: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Add direct links to latest Kodi package)
(11 intermediate revisions by the same user not shown)
Line 2: Line 2:
The current stable release for iOS is {{current version}}.
The current stable release for iOS is {{current version}}.
;Requirements:
;Requirements:
{{#lst:Supported hardware|iDevices}}
{{#lst:Supported hardware|iPhone/iPod/iPad}}
* If you have any issues, be sure to read the [[iOS FAQ]]!
* If you have any issues, be sure to read the [[iOS FAQ]]!


{{Kodi migration note}} <br />
{{Kodi migration note}}<br>


__TOC__
__TOC__
{{-}}
{{-}}


== (Option A) Cydia (only jailbroken device) ==
== Kodi 32-bit or 64-bit? ==
 
Whichever installation method you will follow to install Kodi on your Apple device, you will need to choose between a 32-bit Kodi package or a 64-bit Kodi package.
This choice depends on the processor of your device:
 
'''64-bit (ios-arm64):'''
* iPhone 5S
* iPhone 6/6 Plus
* iPhone 3SE
* iPhone 7/7 Plus
* iPhone 8/8 Plus
* iPhone X
* iPhone XR
* iPhone XS / XS Max
* iPhone X Max
* iPhone 11/11 Pro/11 Pro Max
* iPod Touch 6th/7th generation
* iPad 5th/6th/7th generation
* iPad Mini 2/3/4/5
* iPad Air (all models)
* iPad Pro (all models)
 
'''32-bit (ios-arm):'''
* iPhone
* iPhone 3G
* iPhone 3GS
* iPhone 4
* iPhone 4S
* iPhone 5
* iPhone 5C
* iPod Touch 1st/2nd/3rd/4th/5th generation
* iPad 1st/3rd/4th generation
* iPad 2
* iPad Mini 1
 
 
 
== (option A) Install from Cydia ==
 
{{notice|This method is only compatible on jailbroken device}}


=== Installing ===
=== Installing ===
Line 61: Line 100:
Delete {{highlight|<nowiki>/private/var/mobile/Library/Preferences/Kodi/</nowiki>}}
Delete {{highlight|<nowiki>/private/var/mobile/Library/Preferences/Kodi/</nowiki>}}


== Development and custom builds ==
== Download Kodi package ==
 
If you use one of the above methods to install Kodi on your iDevice you will need to download a Kodi package (<code>.deb</code> file).
First, check if your device needs a [[#Kodi_32-bit_or_64-bit.3F|32 bit or a 64 bit Kodi build]].
 
=== Latest stable Kodi release ===
 
If you just want the latest stable Kodi version available for your device, simply click on the '''32-bit''' or '''64-bit''' link above:
* [{{download link|iOS (64Bit)}} Latest stable Kodi package for 64-bit devices]
* [{{download link|iOS}} Latest stable Kodi package for 32-bit devices]
 
=== Other Kodi builds ===
{{anchor|Monthly builds|Beta|Frodo beta|Frodo RC|Beta builds|Nightly builds|Development builds}}
{{anchor|Monthly builds|Beta|Frodo beta|Frodo RC|Beta builds|Nightly builds|Development builds}}
{{main|Development builds}}
{{main|Development builds}}
Line 67: Line 117:
{{highlight|color=#FFB5B5| {{big|ALWAYS '''[[BACKUP]]''' YOUR '''[[userdata|USERDATA FOLDER]]''' WHEN USING DEVELOPMENT BUILDS! }} }}
{{highlight|color=#FFB5B5| {{big|ALWAYS '''[[BACKUP]]''' YOUR '''[[userdata|USERDATA FOLDER]]''' WHEN USING DEVELOPMENT BUILDS! }} }}


If you want to try a beta or a nightly build of Kodi, choose the build version that you want to install:
{| class="prettytable"
{| class="prettytable"
|-
|-
! Build !! Description !! URL
! Build !! Description !! URL
|-
|-
| '''Nightly build''' || Nightly builds are unstable test builds that have the latest bug fixes and feature additions. They are not fully tested, so anticipate issues and be sure to [[iOS FAQ#Backup|backup your userdata folder]] || ''Download the newest .deb file from:'' http://mirrors.kodi.tv/nightlies/darwin/ios/
| '''Stable build''' || Stable builds are the current stable and recommended versions of Kodi to install on your device. || '''- 64-bit:''' http://mirrors.kodi.tv/releases/darwin/ios-arm64/<br> '''- 32-bit:''' http://mirrors.kodi.tv/releases/darwin/ios/
|-
|-
| '''Monthly build''' || Monthly builds are more stable than nightly builds, but still contain lots of experimental new code. || ''Download the newest .deb file from:'' http://mirrors.kodi.tv/snapshots/darwin/ios/
| '''Nightly build''' || Nightly builds are unstable test builds that have the latest bug fixes and feature additions. They are not fully tested, so anticipate issues and be sure to [[iOS FAQ#Backup|backup your userdata folder]] || '''- 64-bit:''' http://mirrors.kodi.tv/nightlies/darwin/ios-arm64/<br> '''- 32-bit:''' http://mirrors.kodi.tv/nightlies/darwin/ios/
|-
|-
| '''Betas and {{nowrap|release candidates}}''' || Betas and release candidates are builds that are being tested to see if they have any bugs left before becoming a stable release. Most major bugs should be fixed in these builds. || ''Download the newest .deb file from:'' http://mirrors.kodi.tv/releases/darwin/ios
| '''Monthly build''' || Monthly builds are more stable than nightly builds, but still contain lots of experimental new code. || '''- 64-bit:''' http://mirrors.kodi.tv/snapshots/darwin/ios-arm64/<br> '''- 32-bit:''' http://mirrors.kodi.tv/snapshots/darwin/ios/
|-
|-
| '''Older stable builds''' || If you wish to download an older version of XBMC/Kodi for whatever reason, you can do so with these same instructions below. || http://mirrors.kodi.tv/apt/ios/deb/
| '''Older stable builds''' || If you wish to download an older version of XBMC/Kodi for whatever reason, you can do so with these same instructions below. || http://mirrors.kodi.tv/apt/ios/deb/
|}
|}
== (option B) Install from iFile ==
{{notice|This method is only compatible on jailbroken device}}


# Install iFile from Cydia if you don't already have it.
# Install iFile from Cydia if you don't already have it.
# In Mobile Safari (or any browser that can download files) open the <code>.deb</code> file you wish to install, such as from the locations noted above.
# In Mobile Safari (or any browser that can download files) open the <code>.deb</code> file you wish to install, such as from the locations noted [[#Download Kodi package|here]].
#:: '''EXAMPLE:''' <code><nowiki>http://</nowiki>mirrors.kodi.tv/nightlies/darwin/ios/xbmc-20111202-6729214-master-ios'''.deb'''</code>
#:: ''(e.g: <code><nowiki>http://</nowiki>mirrors.kodi.tv/nightlies/darwin/ios/xbmc-20111202-6729214-master-ios.deb</code>)''
# Wait for the download to complete.
# Wait for the download to complete.
#:: {{note|Mobile Safari won't show a progress bar for downloads. Just wait a few minutes until the download is done, but don't close Safari.}}
#:: {{note|Mobile Safari won't show a progress bar for downloads. Just wait a few minutes until the download is done, but don't close Safari.}}
Line 94: Line 149:
{{note|To go back to a stable version of {{kodi}} you might need to first uninstall {{kodi}} and then use the normal install instructions, or manually download the stable release deb file and install using the dev build instructions.}}
{{note|To go back to a stable version of {{kodi}} you might need to first uninstall {{kodi}} and then use the normal install instructions, or manually download the stable release deb file and install using the dev build instructions.}}


== Installing using Xcode and iOS App Signer==
== (option C) Install from Filza ==
{{warning|This is considered and advanced and slightly-expirimental method. It is not for the faint of heart.
 
{{notice|This method is only compatible on jailbroken device}}
 
# Install Filza from Cydia if you don't already have it.
# In Mobile Safari (or any browser that can download files) open the <code>.deb</code> file you wish to install, such as from the locations noted [[#Download Kodi package|here]].
#:: ''(e.g: <code><nowiki>http://</nowiki>mirrors.kodi.tv/nightlies/darwin/ios/xbmc-20111202-6729214-master-ios.deb</code>)''
# Wait for the download to complete.
#:: {{note|Mobile Safari won't show a progress bar for downloads. Just wait a few minutes until the download is done, but don't close Safari.}}
# Select '''"Open in..."'''
# Select '''Filza''' from the available apps
# Filza will open and get a copy of the downloaded. In the files list, select the freshly downloaded file and choose '''install'''.
# When you see <code>bash-5.0#</code> at the bottom of your screen you can select '''respring''' at the top right and '''yes'''.


See [[IOS FAQ#XBMC Version|here]] to verify your {{kodi}} version.


== (option D) Install from Xcode and iOS App Signer ==
{{warning|This is considered and advanced and slightly-expirimental method. 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 iOS dev account.}}
This method also requires that Kodi be re-installed every '''7 days''' if you are using a free iOS dev account.}}
{{warning|This method need macOS and Xcode
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 ===
=== Prerequisites ===
Line 106: Line 178:


=== Downloads ===
=== Downloads ===
{| class="prettytable"
Download the Kodi package by following this [[#Download Kodi package|section]].
|-
! Build !! Description
|-
| '''[http://mirrors.kodi.tv/releases/darwin/ios/ Stable builds]''' || These are the current stable and recommended versions of Kodi to install on your device.
|-
| '''[http://mirrors.kodi.tv/nightlies/darwin/ios/ Nightly builds]''' || Nightly builds are unstable test builds that have the latest bug fixes and feature additions. They are not fully tested, so anticipate issues and be sure to [[iOS FAQ#Backup|backup your userdata folder]]
|-
| '''[http://mirrors.kodi.tv/snapshots/darwin/ios/ Monthly builds]''' || Monthly builds are more stable than nightly builds, but still contain lots of experimental new code.
|-
| '''[http://mirrors.kodi.tv/releases/darwin/ios/ Betas and {{nowrap|release candidates}}]''' || Betas and release candidates are builds that are being tested to see if they have any bugs left before becoming a stable release. Most major bugs should be fixed in these builds.
|}


=== Instructions ===
=== Instructions ===
Line 143: Line 204:
If you are having trouble using iOS App Signer, please post in the [http://forum.kodi.tv/showthread.php?tid=245978 forum topic]
If you are having trouble using iOS App Signer, please post in the [http://forum.kodi.tv/showthread.php?tid=245978 forum topic]


== Installing using Cydia Impactor==
== (option E) Install from Cydia Impactor ==
{{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.
{{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 iOS dev account.}}
This method also requires that Kodi be re-installed every '''7 days''' if you are using a free iOS dev account.}}


Line 153: Line 212:
* Windows 7 or Higher
* Windows 7 or Higher
* Latest version of iTunes
* Latest version of iTunes
* Latest .deb file of Kodi from [http://mirrors.kodi.tv/releases/darwin/ios/ Stable builds]
* A <code>.deb</code> file of Kodi (see this [[#Download Kodi package|section]])
 
=== Downloads ===
I will suggest only stable builds but if you wish you can use other builds as you like.
{| class="prettytable"
|-
! Build !! Description
|-
| '''[http://mirrors.kodi.tv/releases/darwin/ios/ Stable builds]''' || These are the current stable and recommended versions of Kodi to install on your device.
|-
| '''[http://mirrors.kodi.tv/nightlies/darwin/ios/ Nightly builds]''' || Nightly builds are unstable test builds that have the latest bug fixes and feature additions. They are not fully tested, so anticipate issues and be sure to [[iOS FAQ#Backup|backup your userdata folder]]
|-
| '''[http://mirrors.kodi.tv/snapshots/darwin/ios/ Monthly builds]''' || Monthly builds are more stable than nightly builds, but still contain lots of experimental new code.
|-
| '''[http://mirrors.kodi.tv/releases/darwin/ios/ Betas and {{nowrap|release candidates}}]''' || Betas and release candidates are builds that are being tested to see if they have any bugs left before becoming a stable release. Most major bugs should be fixed in these builds.
|}


=== Converting deb into ipa ===
=== Converting deb into ipa ===

Revision as of 07:17, 6 February 2020

Home icon grey.png   ▶ iOS ▶ HOW-TO:Install Kodi for iOS

The current stable release for iOS is Kodi v20.5 Nexus.

Requirements
  • If you have any issues, be sure to read the iOS FAQ!

Template:Kodi migration note


Kodi 32-bit or 64-bit?

Whichever installation method you will follow to install Kodi on your Apple device, you will need to choose between a 32-bit Kodi package or a 64-bit Kodi package. This choice depends on the processor of your device:

64-bit (ios-arm64):

  • iPhone 5S
  • iPhone 6/6 Plus
  • iPhone 3SE
  • iPhone 7/7 Plus
  • iPhone 8/8 Plus
  • iPhone X
  • iPhone XR
  • iPhone XS / XS Max
  • iPhone X Max
  • iPhone 11/11 Pro/11 Pro Max
  • iPod Touch 6th/7th generation
  • iPad 5th/6th/7th generation
  • iPad Mini 2/3/4/5
  • iPad Air (all models)
  • iPad Pro (all models)

32-bit (ios-arm):

  • iPhone
  • iPhone 3G
  • iPhone 3GS
  • iPhone 4
  • iPhone 4S
  • iPhone 5
  • iPhone 5C
  • iPod Touch 1st/2nd/3rd/4th/5th generation
  • iPad 1st/3rd/4th generation
  • iPad 2
  • iPad Mini 1


(option A) Install from Cydia

Emblem-important-yellow.png NOTICE:
This method is only compatible on jailbroken device

Installing

And you're done! You should now be running Kodi v20.5 Nexus for iOS. See here to verify your Kodi version.

Updating

Updates for stable releases of Kodi are handled by Cydia and will show up in the 'Changes' section when available. (After updating the sources).

Uninstalling

Uninstalling just XBMC/Kodi

You're all done.

Removing settings

Kodi will uninstall from your iDevice but will leave certain things (databases and everything in your userdata folder) behind to make it easier if you wanted to reinstall. To delete those:

From the terminal, run
rm -Rf /private/var/mobile/Library/Preferences/XBMC/
rm -Rf /private/var/mobile/Library/Preferences/Kodi/
Or
From iFile or Filza

Delete /private/var/mobile/Library/Preferences/XBMC/

Delete /private/var/mobile/Library/Preferences/Kodi/

Download Kodi package

If you use one of the above methods to install Kodi on your iDevice you will need to download a Kodi package (.deb file). First, check if your device needs a 32 bit or a 64 bit Kodi build.

Latest stable Kodi release

If you just want the latest stable Kodi version available for your device, simply click on the 32-bit or 64-bit link above:

Other Kodi builds

ALWAYS BACKUP YOUR USERDATA FOLDER WHEN USING DEVELOPMENT BUILDS!

If you want to try a beta or a nightly build of Kodi, choose the build version that you want to install:

Build Description URL
Stable build Stable builds are the current stable and recommended versions of Kodi to install on your device. - 64-bit: http://mirrors.kodi.tv/releases/darwin/ios-arm64/
- 32-bit: http://mirrors.kodi.tv/releases/darwin/ios/
Nightly build Nightly builds are unstable test builds that have the latest bug fixes and feature additions. They are not fully tested, so anticipate issues and be sure to backup your userdata folder - 64-bit: http://mirrors.kodi.tv/nightlies/darwin/ios-arm64/
- 32-bit: http://mirrors.kodi.tv/nightlies/darwin/ios/
Monthly build Monthly builds are more stable than nightly builds, but still contain lots of experimental new code. - 64-bit: http://mirrors.kodi.tv/snapshots/darwin/ios-arm64/
- 32-bit: http://mirrors.kodi.tv/snapshots/darwin/ios/
Older stable builds If you wish to download an older version of XBMC/Kodi for whatever reason, you can do so with these same instructions below. http://mirrors.kodi.tv/apt/ios/deb/

(option B) Install from iFile

Emblem-important-yellow.png NOTICE:
This method is only compatible on jailbroken device
  1. Install iFile from Cydia if you don't already have it.
  2. In Mobile Safari (or any browser that can download files) open the .deb file you wish to install, such as from the locations noted here.
    (e.g: http://mirrors.kodi.tv/nightlies/darwin/ios/xbmc-20111202-6729214-master-ios.deb)
  3. Wait for the download to complete.
    Note: Mobile Safari won't show a progress bar for downloads. Just wait a few minutes until the download is done, but don't close Safari.
  4. Select "Open in..."
  5. Select iFile from the available apps
  6. iFile will get a copy of the downloaded file and open an action menu. Select install. When iFile is complete you can tap done at the top.
  7. In iFile, swipe to delete the downloaded Kodi deb file as it is no longer needed.

See here to verify your Kodi version.

Note: To go back to a stable version of Kodi you might need to first uninstall Kodi and then use the normal install instructions, or manually download the stable release deb file and install using the dev build instructions.

(option C) Install from Filza

Emblem-important-yellow.png NOTICE:
This method is only compatible on jailbroken device
  1. Install Filza from Cydia if you don't already have it.
  2. In Mobile Safari (or any browser that can download files) open the .deb file you wish to install, such as from the locations noted here.
    (e.g: http://mirrors.kodi.tv/nightlies/darwin/ios/xbmc-20111202-6729214-master-ios.deb)
  3. Wait for the download to complete.
    Note: Mobile Safari won't show a progress bar for downloads. Just wait a few minutes until the download is done, but don't close Safari.
  4. Select "Open in..."
  5. Select Filza from the available apps
  6. Filza will open and get a copy of the downloaded. In the files list, select the freshly downloaded file and choose install.
  7. When you see bash-5.0# at the bottom of your screen you can select respring at the top right and yes.

See here to verify your Kodi version.

(option D) Install from Xcode and iOS App Signer

Stop hand.png This is considered and advanced and slightly-expirimental method. 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 iOS dev account.


Stop hand.png This method need macOS and Xcode

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

Downloads

Download the Kodi package by following this section.

Instructions

If you have a paid developer account with a wildcard (*) provisioning profile, you do not need to follow steps 1-6.

Updating Kodi

To update Kodi, run iOS App Signer and select the new deb file and the same provisioning profile that you used initially.

Modifying Kodi userdata

To modify the Kodi userdata, you can use any iOS file manager such as iFunbox

Help

If you are having trouble using iOS App Signer, please post in the forum topic

(option E) Install from Cydia Impactor

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 iOS dev account.


Prerequisites

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 skip to the installation below.

  • You will need to Download 7-zip and install it in your PC
  • Download required kodi build from the links given above in your PC

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

Source

Installing Kodi Using Cydia Impactor

Source