Archive:Install Kodi on Apple TV 2: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(187 intermediate revisions by 19 users not shown)
Line 1: Line 1:
{{XBMC wiki toc}}
{{notice|v14.2 "Helix" will be the last version of Kodi to run on the '''Apple TV 2'''. For more information read the announcement '''[http://kodi.tv/farewell-to-future-appletv2-development/ here]'''.
:''See also: '''[[XBMC for iOS specific FAQ]]'''
''Other iOS devices (iPhone, iPad, etc) will still be supported.''}}


'''Requirements:'''
*To install XBMC for iOS you must have a [[forum:99315|jailbroken]] Apple TV 2 with [[w:IOS version history#Version history: Apple TV (second generation)|software version 4.1 to 4.4]]. See [[IOS FAQ#ATV2_version|here]] to find out what version you are currently running.


The current stable release for iOS is {{current version}}.


__toc__


== Installing from Cydia ==
{{-}}
[[File:ATV2.jpg|thumb|300px|After XBMC is successfully installed, the ATV2 will restart, and XBMC should then be available as an option in the ATV2's main menu]]
:''This is the same build installed from the nitoTV menu, if installed.''
To install the Cydia build:


#Open up your [[XBMC for iOS specific FAQ#SSH|terminal/ssh application]] and enter the following command to log in to your ATV2:
== Installing from the command line ==
#:<pre>ssh [email protected]</pre>
# Open up your terminal/ssh application]] and enter the following command to log in to your ATV2. Note, you need to replace "YOUR.ATV2.IP.ADDRESS" with the IP address of the Apple TV:
#You will be asked for a password: ''default password is '''alpine'''''
#: <pre>ssh [email protected]</pre>
#Continue to enter the following commands:
#:: '''EXAMPLE:''' <code>ssh [email protected]</code>
#Issue these commands in your Terminal window, in sequence:
# You will be asked for a password: ''default password is '''alpine'''''
#:<pre>apt-get install wget</pre>
# Continue to enter the following commands:
#:<pre>wget -O- <nowiki>http://apt.awkwardtv.org/awkwardtv.pub</nowiki> | apt-key add -</pre>
#: <pre>apt-get install wget</pre>
#:<pre>echo "deb <nowiki>http://apt.awkwardtv.org/ stable main" ></nowiki> /etc/apt/sources.list.d/awkwardtv.list</pre>
#: <pre>wget -O- <nowiki>http://apt.awkwardtv.org/awkwardtv.pub</nowiki> | apt-key add -</pre>
#:<pre>echo "deb <nowiki>http://mirrors.xbmc.org/apt/atv2 ./" ></nowiki> /etc/apt/sources.list.d/xbmc.list</pre>
#: <pre>echo "deb <nowiki>http://apt.awkwardtv.org/ stable main" ></nowiki> /etc/apt/sources.list.d/awkwardtv.list</pre>
#:<pre>apt-get update</pre>
#: <pre>echo "deb <nowiki>http://mirrors.kodi.tv/apt/atv2 ./" ></nowiki> /etc/apt/sources.list.d/xbmc.list</pre>
#:<pre>apt-get install org.xbmc.xbmc-atv2</pre>
#: <pre>apt-get update</pre>
#:<pre>reboot</pre>
#: <pre>apt-get install org.xbmc.kodi-atv2</pre>
#: <pre>reboot</pre>
And you're done! You should now be running 14.2 for Apple TV 2 (last supported version for the platform). See * Kodi -> Main menu -> System -> Lower submenu -> System info. '''Note the build date.''' to verify your Kodi version.


{{anchor|Nightly|Installing the latest nightly build}}
== Installing from NitoTV ==
== Eden Beta ==
{{notice|While this should work in theory, the official installation method for {{kodi}} is to use the command line instructions. If you have issues with any of the Nito installers then please try the command line instructions to see if that fixes the issue. Nito simply gives a GUI for those command line instructions, so it should work, but Team {{kodi}} has no control over those installers and cannot update them or see any errors from them, or anything like that.}}
No more nightly builds! Eden beta 1 is here! If you installed for the first time today using the above instructions then you already have Beta 1. If not, either update through NitoTV or issue the following commands to update your Cydia copy:
;NitoTV on the Apple TV 2
#Open up your [[XBMC for iOS specific FAQ#SSH|terminal/ssh application]] and enter the following command to log in to your ATV2:
# Scroll right to the NitoTV menu on the Apple TV and choose the first option "''Install Software''".
#:<pre>ssh root@YOUR.ATV2.IP.ADDRESS</pre>
# Scroll down the list until you see "''Kodi-ATV2''" and click on that.
#You will be asked for a password: ''default password is '''alpine'''''
# From that menu press "''install''" and your Apple TV will install {{kodi}} and then do a '''SOFT''' reboot (no tethered boot required).
#Continue to enter the following commands:
# {{kodi}} will now be in your Apple TV menu, scroll right to it, click and enjoy.
#:<pre>apt-get update</pre>
And you're done! You should now be running 14.2 Apple TV 2. See * Kodi -> Main menu -> System -> Lower submenu -> System info. '''Note the build date.''' to verify your {{kodi}} version.
#:<pre>apt-get upgrade</pre>
{{-}}
#You should now have Eden Beta 1 for ATV2. See [http://wiki.xbmc.org/index.php?title=IOS_FAQ#XBMC_Version here] to verify your XBMC version.


<!--[[File:XBMC nightly.png|400px|thumb|Here's an example of a successful install (where the ATV2 had an IP of 192.168.1.100 and the .deb package file was from Sept 10)]]
== Updating ==
:''Change history: [http://trac.xbmc.org/timeline trac timeline] or [https://github.com/xbmc/xbmc/commits commit history]''
Either update through NitoTV or issue the following commands to update:
# Open up your terminal/ssh application]] and enter the following command to log in to your ATV2:
#: <pre>ssh root@YOUR.ATV2.IP.ADDRESS</pre>
#:: '''EXAMPLE:''' <code>ssh root@192.168.1.5</code>
# You will be asked for a password: ''default password is '''alpine'''''
# Continue to enter the following commands:
#: <pre>apt-get update</pre>
#: <pre>apt-get install org.xbmc.kodi-atv2</pre>


'''NOTE: You MUST install the [[#Installing from Cydia|Cydia]] version before you can install a nightly build.''' You only need to install the Cydia version once and you don't need to uninstall previous versions to upgrade (or downgrade) XBMC.
== Development and custom builds ==
{{main|Development builds}}


#Open up your [[XBMC for iOS specific FAQ#What is SSH?|terminal/ssh application]] and enter the following command to log in to your ATV2:
{{highlight|color=#FFB5B5| {{big|ALWAYS '''BACKUP''' YOUR '''USERDATA FOLDER''' WHEN USING DEVELOPMENT BUILDS! }} }}
#:<pre>ssh [email protected]</pre>
#You will be asked for a password: ''default password is '''alpine'''''
#'''If''' you installed the Cydia version before November 26th, and have not manually installed '''UpdateBeGone''', then you will need to issue this command (You only need to install UpdateBeGone once, so for future nightly updates you can skip this step). If you can't remember if it is installed, it is safe to enter the command again to make sure it is installed:
#:<pre>apt-get install com.nito.updatebegone</pre>
#Continue to enter the following commands:
#:<pre>rm -f xbmc*.deb</pre>
#:<pre>wget http://mirrors.xbmc.org/nightlies/darwin/atv2/xbmc-20111210-f1ae0b6-master-atv2.deb</pre>
#:<pre>dpkg -i xbmc*.deb</pre>
#:<pre>rm xbmc*.deb</pre>
#You should now have the latest nightly build of XBMC for ATV2. See [http://wiki.xbmc.org/index.php?title=IOS_FAQ#XBMC_Version here] to verify your XBMC version. -->


[[Category:IOS|Apple TV 2]]
{| class="prettytable"
[[Category:How-to|Apple TV 2]]
|-
[[Category:Installation|Apple TV2]]
! 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 backup your userdata folder || http://mirrors.kodi.tv/nightlies/darwin/atv2/
|-
| '''Monthly build''' || Monthly builds are more stable than nightly builds, but still contain lots of experimental new code. || http://mirrors.kodi.tv/snapshots/darwin/atv2/
|-
| '''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. || http://mirrors.kodi.tv/apt/pre-release/atv2/deb/
|-
| '''Older stable builds''' || If you wish to download an older version of {{kodi}} for whatever reason, you can do so with these same instructions below. || http://mirrors.kodi.tv/apt/atv2/deb/
|}
 
# Open one of the above URL locations in a web browser and copy the url of the '''most recent file''' in that listing.
#:: '''EXAMPLE:''' <code><nowiki>http://</nowiki>mirrors.kodi.tv/nightlies/darwin/atv2/kodi-20150120-e740097-master-atv2'''.deb'''</code>
# Open up your terminal/ssh application and enter the following command to log in to your ATV2:
#: <pre>ssh [email protected]</pre>
#:: '''EXAMPLE:''' <code>ssh [email protected]</code>
# You will be asked for a password: ''default password is '''alpine'''''
# Continue to enter the following commands:
#: <pre>rm -f *kodi*.deb</pre>
#: <pre>apt-get update</pre>
#: <pre>wget URL-FROM-STEP-ONE-HERE</pre>
#:: '''EXAMPLE:''' <code><nowiki>wget http://</nowiki>mirrors.kodi.tv/nightlies/darwin/atv2/kodi-20150120-e740097-master-atv2'''.deb'''</code>
#: <pre>dpkg -i *kodi*.deb</pre>
#: <pre>rm *kodi*.deb</pre>
 
See * Kodi -> Main menu -> System -> Lower submenu -> System info. '''Note the build date.''' 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.}}
 
 
 
=== Going from Kodi to XBMC ===
Due to the name change, the steps for downgrading between Kodi (starting at v14 and up) to XBMC (v13.2 and lower) requires slightly different steps:
 
# Open one of the [[#Development and custom builds|above URL locations]] in a web browser and copy the url of the version you wish to install.
#:: '''EXAMPLE:''' <code><nowiki>http://</nowiki>mirrors.kodi.tv/apt/atv2/deb/old/org.xbmc.xbmc-atv2_12.2-0_iphoneos-arm'''.deb'''</code>
# Open up your terminal/ssh application and enter the following command to log in to your ATV2:
#: <pre>ssh [email protected]</pre>
#:: '''EXAMPLE:''' <code>ssh [email protected]</code>
# You will be asked for a password: ''default password is '''alpine'''''
# Continue to enter the following commands:
#: <pre>rm -f *kodi*.deb</pre>
#: <pre>rm -f *xbmc*.deb</pre>
#: <pre>apt-get update</pre>
#: <pre>wget URL-FROM-STEP-ONE-HERE</pre>
#:: '''EXAMPLE:''' <code><nowiki>wget http://</nowiki>mirrors.kodi.tv/apt/atv2/deb/old/org.xbmc.xbmc-atv2_12.2-0_iphoneos-arm'''.deb'''</code>
#: <pre>wget http://mirrors.kodi.tv/apt/atv2/deb/org.xbmc.xbmc-seatbeltunlock_1.0-5_iphoneos-arm.deb</pre>
#: <pre>dpkg -i *xbmc*.deb</pre>
#: <pre>rm *xbmc*.deb</pre>
 
See * Kodi -> Main menu -> System -> Lower submenu -> System info. '''Note the build date.''' to verify your {{kodi}} version.
 
== Uninstalling ==
=== Uninstalling just {{kodi}} ===
SSH into your Apple TV (Using the same instructions from above to login). Then run:<br />
<pre> apt-get remove org.xbmc.xbmc-atv2</pre>
or
<pre> apt-get remove org.xbmc.kodi-atv2</pre>
 
It will ask you if you want to continue:
<pre>The following packages will be REMOVED:
  org.xbmc.kodi-atv2
0 upgraded, 0 newly installed, 1 to remove and 5 not upgraded.
After this operation, 0B of additional disk space will be used.
Do you want to continue [Y/n]?</pre>
Just enter "Y" to accept and continue.
 
=== Removing settings ===
{{kodi}} will uninstall from your Apple TV 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 also run:
<pre>rm -Rf /private/var/mobile/Library/Preferences/XBMC</pre>
<pre>rm -Rf /private/var/mobile/Library/Preferences/Kodi</pre>
This will then be completely clear and {{kodi}} will be removed.
 
=== Deleting {{kodi}} dependencies ===
{{kodi}} has three dependencies that it installs along with itself when you first install {{kodi}} (org.xbmc.xbmc-seatbeltunlock, gawk, bsdiff). After uninstalling {{kodi}} you can also uninstall these 3 dependencies by running this command:
<syntaxhighlight lang=bash enclose="div">
apt-get remove org.xbmc.xbmc-seatbeltunlock && apt-get remove gawk && apt-get remove bsdiff && apt-get remove org.xbmc.kodi-seatbeltunlock
</syntaxhighlight>
 
 
 
 
[[Category:Apple]]

Latest revision as of 20:12, 11 December 2020

Emblem-important-yellow.png NOTICE:
v14.2 "Helix" will be the last version of Kodi to run on the Apple TV 2. For more information read the announcement here.

Other iOS devices (iPhone, iPad, etc) will still be supported.


The current stable release for iOS is Kodi v21 Omega.



Installing from the command line

  1. Open up your terminal/ssh application]] and enter the following command to log in to your ATV2. Note, you need to replace "YOUR.ATV2.IP.ADDRESS" with the IP address of the Apple TV: 
    ssh [email protected]
    EXAMPLE: ssh [email protected]
  2. You will be asked for a password: default password is alpine
  3. Continue to enter the following commands: 
    apt-get install wget
    wget -O- http://apt.awkwardtv.org/awkwardtv.pub | apt-key add -
    echo "deb http://apt.awkwardtv.org/ stable main" > /etc/apt/sources.list.d/awkwardtv.list
    echo "deb http://mirrors.kodi.tv/apt/atv2 ./" > /etc/apt/sources.list.d/xbmc.list
    apt-get update
    apt-get install org.xbmc.kodi-atv2
    reboot

And you're done! You should now be running 14.2 for Apple TV 2 (last supported version for the platform). See * Kodi -> Main menu -> System -> Lower submenu -> System info. Note the build date. to verify your Kodi version.

Installing from NitoTV

Emblem-important-yellow.png NOTICE:
While this should work in theory, the official installation method for Kodi is to use the command line instructions. If you have issues with any of the Nito installers then please try the command line instructions to see if that fixes the issue. Nito simply gives a GUI for those command line instructions, so it should work, but Team Kodi has no control over those installers and cannot update them or see any errors from them, or anything like that.
NitoTV on the Apple TV 2
  1. Scroll right to the NitoTV menu on the Apple TV and choose the first option "Install Software".
  2. Scroll down the list until you see "Kodi-ATV2" and click on that.
  3. From that menu press "install" and your Apple TV will install Kodi and then do a SOFT reboot (no tethered boot required).
  4. Kodi will now be in your Apple TV menu, scroll right to it, click and enjoy.

And you're done! You should now be running 14.2 Apple TV 2. See * Kodi -> Main menu -> System -> Lower submenu -> System info. Note the build date. to verify your Kodi version.

Updating

Either update through NitoTV or issue the following commands to update:

  1. Open up your terminal/ssh application]] and enter the following command to log in to your ATV2: 
    ssh [email protected]
    EXAMPLE: ssh [email protected]
  2. You will be asked for a password: default password is alpine
  3. Continue to enter the following commands: 
    apt-get update
    apt-get install org.xbmc.kodi-atv2

Development and custom builds

Main page: Development builds

ALWAYS BACKUP YOUR USERDATA FOLDER WHEN USING DEVELOPMENT BUILDS!

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 backup your userdata folder http://mirrors.kodi.tv/nightlies/darwin/atv2/
Monthly build Monthly builds are more stable than nightly builds, but still contain lots of experimental new code. http://mirrors.kodi.tv/snapshots/darwin/atv2/
Betas and 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. http://mirrors.kodi.tv/apt/pre-release/atv2/deb/
Older stable builds If you wish to download an older version of Kodi for whatever reason, you can do so with these same instructions below. http://mirrors.kodi.tv/apt/atv2/deb/
  1. Open one of the above URL locations in a web browser and copy the url of the most recent file in that listing.
    EXAMPLE: http://mirrors.kodi.tv/nightlies/darwin/atv2/kodi-20150120-e740097-master-atv2.deb
  2. Open up your terminal/ssh application and enter the following command to log in to your ATV2: 
    ssh [email protected]
    EXAMPLE: ssh [email protected]
  3. You will be asked for a password: default password is alpine
  4. Continue to enter the following commands: 
    rm -f *kodi*.deb
    apt-get update
    wget URL-FROM-STEP-ONE-HERE
    EXAMPLE: wget http://mirrors.kodi.tv/nightlies/darwin/atv2/kodi-20150120-e740097-master-atv2.deb
    dpkg -i *kodi*.deb
    rm *kodi*.deb

See * Kodi -> Main menu -> System -> Lower submenu -> System info. Note the build date. 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.


Going from Kodi to XBMC

Due to the name change, the steps for downgrading between Kodi (starting at v14 and up) to XBMC (v13.2 and lower) requires slightly different steps:

  1. Open one of the above URL locations in a web browser and copy the url of the version you wish to install.
    EXAMPLE: http://mirrors.kodi.tv/apt/atv2/deb/old/org.xbmc.xbmc-atv2_12.2-0_iphoneos-arm.deb
  2. Open up your terminal/ssh application and enter the following command to log in to your ATV2: 
    ssh [email protected]
    EXAMPLE: ssh [email protected]
  3. You will be asked for a password: default password is alpine
  4. Continue to enter the following commands: 
    rm -f *kodi*.deb
    rm -f *xbmc*.deb
    apt-get update
    wget URL-FROM-STEP-ONE-HERE
    EXAMPLE: wget http://mirrors.kodi.tv/apt/atv2/deb/old/org.xbmc.xbmc-atv2_12.2-0_iphoneos-arm.deb
    wget http://mirrors.kodi.tv/apt/atv2/deb/org.xbmc.xbmc-seatbeltunlock_1.0-5_iphoneos-arm.deb
    dpkg -i *xbmc*.deb
    rm *xbmc*.deb

See * Kodi -> Main menu -> System -> Lower submenu -> System info. Note the build date. to verify your Kodi version.

Uninstalling

Uninstalling just Kodi

SSH into your Apple TV (Using the same instructions from above to login). Then run:

 apt-get remove org.xbmc.xbmc-atv2

or 

 apt-get remove org.xbmc.kodi-atv2

It will ask you if you want to continue: 

The following packages will be REMOVED:
  org.xbmc.kodi-atv2
0 upgraded, 0 newly installed, 1 to remove and 5 not upgraded.
After this operation, 0B of additional disk space will be used.
Do you want to continue [Y/n]?

Just enter "Y" to accept and continue.

Removing settings

Kodi will uninstall from your Apple TV 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 also run: 

rm -Rf /private/var/mobile/Library/Preferences/XBMC
rm -Rf /private/var/mobile/Library/Preferences/Kodi

This will then be completely clear and Kodi will be removed.

Deleting Kodi dependencies

Kodi has three dependencies that it installs along with itself when you first install Kodi (org.xbmc.xbmc-seatbeltunlock, gawk, bsdiff). After uninstalling Kodi you can also uninstall these 3 dependencies by running this command: 

apt-get remove org.xbmc.xbmc-seatbeltunlock && apt-get remove gawk && apt-get remove bsdiff && apt-get remove org.xbmc.kodi-seatbeltunlock
Retrieved from "https://kodi.wiki/index.php?title=Archive:Install_Kodi_on_Apple_TV_2&oldid=223238"